# 14 – C09-M Teremfoglalási ütközés-ellenőrző

**Terület:** backend · **Típus:** complete starter code · **Becsült idő:** 25 perc

## Cél
Valósítsd meg a `POST /book` végpontot, amely az előírt sorrendben ellenőrzi a termet, a kapacitást, a nyitvatartást, az időtartományt és az ütközéseket.

## Kiinduló anyagok
- `assets/index.php` – a két működő GET útvonal és a `POST /book` feladathelye *(generált helyettesítő)*
- `assets/data/rooms.json` – 3 terem kapacitással *(generált helyettesítő)*
- `assets/data/bookings.json` – 10 meglévő foglalás *(generált helyettesítő)*
- `assets/tests.ps1` – sikeres és hibás API-kérések *(generált helyettesítő)*
- `assets/bruno/` – lista-, ütközés- és sikeres foglalási API-próbák *(generált helyettesítő)*

## Követelmények
- [ ] `GET /rooms` és `GET /bookings` továbbra is HTTP 200 JSON választ ad.
- [ ] `POST /book` JSON törzse: `room_id`, `date`, `start`, `end`, `attendees`.
- [ ] Ismeretlen `room_id` → 404.
- [ ] Nem 1 és a terem kapacitása közötti létszám → 422, `"Room capacity exceeded"`.
- [ ] Nem teljesen 08:00–20:00 közötti időpont → 422, `"Outside opening hours"`.
- [ ] Ha `end` nem későbbi, mint `start` → 422, `"Invalid time range"`.
- [ ] Azonos terem és dátum átfedése → 409, `"Time slot conflicts with booking <id>"`.
- [ ] Az egymást csak érintő időpontok engedélyezettek.
- [ ] Siker esetén 201 és `{ "data": { booking } }`; az új azonosító a jelenlegi legnagyobb + 1.
- [ ] Ismeretlen útvonal → 404 JSON válasz.

## Elvárt eredmény

```http
POST /book
Content-Type: application/json

{ "room_id": 1, "date": "2026-09-23", "start": "10:00", "end": "10:30", "attendees": 4 }
```

```json
{
  "data": {
    "id": 11,
    "room_id": 1,
    "date": "2026-09-23",
    "start": "10:00",
    "end": "10:30",
    "attendees": 4
  }
}
```

## Feltételezések
| Hiányzó információ | Feltételezés | Biztonság | Ha mégsem így van |
| --- | --- | --- | --- |
| A GET válasz burkolása | Mindkét lista `{ "data": [...] }` alakú | közepes | Közvetlen tömb esetén csak a két `json_encode` argumentum változik. |
| Sikeres foglalás tartóssága | A feladat csak a választ kéri; a JSON fájl nem módosul | közepes | Tartós működéshez az új elemet a tömbhöz kell adni és `file_put_contents`-szel menteni. |
| Hibás vagy hiányos JSON | A kérés a megadott öt mezőt, helyes formátumban tartalmazza | alacsony | Külön 400/422 mezővalidációt kell a felsorolt ellenőrzések elé tenni. |
| Időzóna | Nem releváns, mert a dátum és idő helyi szöveges érték | magas | Időzónás időbélyegnél `DateTimeImmutable` összehasonlítás szükséges. |

## Ellenőrzés
Indítsd a PHP beépített szerverét a `code/` mappára, majd futtasd az `assets/tests.ps1` fájlt. A GET, az öt hibaág és a sikeres, érintkező időpont próbája is `PASS` legyen.
