Промпт для Backend-разработчика и создания ТЗ

Контекст и цель

Запрос: «Реализовать API для системы бронирования переговорных комнат: создание брони, проверка доступности». Цель: Спроектировать эндпоинт создания бронирования с бизнес-логикой валидации пересечений по времени.

Ответ модели: Техническое задание (Backend)

1. Схема API

Endpoint: POST /api/v1/bookings Payload:

{
  "room_id": "uuid",
  "user_id": "uuid",
  "start_at": "2023-11-20T10:00:00Z",
  "end_at": "2023-11-20T11:00:00Z"
}

2. Логика и БД

Таблица bookings: id (PK), room_id (FK), user_id, period (tstzrange). Алгоритм обработки:

1. Открытие транзакции (уровень Read Committed).
2. Проверка существования room_id.
3. SQL-запрос на пересечение: SELECT 1 FROM bookings WHERE room_id = $1 AND period && tstzrange($2, $3)
4. Если результат не пуст — возврат 409 Conflict.
5. Insert записи и COMMIT.

Допущения и ограничения

• Используется PostgreSQL (тип tstzrange для исключения race condition через GiST-индекс).
• Часовой пояс — UTC.
• Минимальный шаг бронирования — 15 минут.

Критерии приемки

• [ ] Код ответа 201 Created при успешном бронировании.
• [ ] Код 409 при наложении интервалов хотя бы на 1 секунду.
• [ ] Время ответа API < 100мс при нагрузке 50 RPS.
• [ ] Наличие Unit-теста на логику валидации интервалов.

Следующий шаг

Роль: DevOps / SRE. Задача: Настроить миграции БД и мониторинг пула соединений в staging-окружении.

...