Copy the committed lab 1 sources as-is: src/, student-tests/, bench/, Dockerfile, docker-compose.yml, pyproject.toml, uv.lock, .python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/, openspec/, .graphifyignore and KNOWN_ISSUES.md. Lab 1 evidence stays in the lab 1 repository. Merge the new skeleton files with own sections: Makefile (lab 2 targets plus own run, docker, bench and common targets), .gitignore, .dockerignore and .env.example. Rename the image to mtusi-messenger:lab2 and point AGENTS.md at lab 2. The application is still the in-memory lab 1 implementation. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.0 KiB
messages Specification
Purpose
Текстовые сообщения в чате: отправка от имени текущего пользователя и
чтение истории чата его участниками в порядке (created_at, id).
Requirements
Requirement: Отправка сообщения
POST /api/v1/chats/{chat_id}/messages SHALL принимать тело
{"text": ...} и при успехе отвечать 201 с объектом Message: id,
chat_id, sender_id, text, created_at, без других полей.
sender_id SHALL быть текущим пользователем, text — совпадать с
отправленным.
Scenario: Участник отправляет сообщение
- WHEN Алиса отправляет
"Привет, мир 👋"в свой чат - THEN ответ 201,
sender_id— Алиса,chat_id— этот чат,textравен"Привет, мир 👋"
Requirement: Валидация текста
text SHALL содержать от 1 до 4000 Unicode code points и MUST NOT
состоять только из пробельных символов. Поле sender_id в теле MUST NOT
приниматься. Нарушения SHALL давать 400 invalid_request.
Scenario: Пустой текст
- WHEN участник отправляет
{"text": ""} - THEN ответ 400
Scenario: Граница длины
- WHEN текст из 4000 code points, затем из 4001
- THEN первый запрос даёт 201, второй — 400
Scenario: Попытка подменить отправителя
- WHEN тело содержит
sender_idдругого пользователя - THEN ответ 400, сообщение не создаётся
Requirement: Писать и читать могут только участники
Отправка и чтение истории SHALL быть доступны только участникам чата.
Посторонний и запрос к несуществующему чату SHALL получать одинаковый
404 not_found; сообщение при этом MUST NOT создаваться.
Scenario: Посторонний пишет
- WHEN Ева отправляет сообщение в чат Алисы и Боба
- THEN ответ 404, в истории чата новых сообщений нет
Scenario: Посторонний читает
- WHEN Ева запрашивает историю чата Алисы и Боба
- THEN ответ 404
Requirement: История чата
GET /api/v1/chats/{chat_id}/messages SHALL возвращать сообщения чата
в порядке (created_at, id) по возрастанию, с постраничным выводом по
capability pagination. Любой участник SHALL видеть все сообщения
чата, в том числе чужие.
Scenario: Два участника, две страницы
- WHEN Алиса и Боб отправили по сообщению, и Боб читает историю с
limit=1, а затем продолжает по курсору - THEN первая страница содержит одно сообщение и непустой
next_cursor, вторая — второе сообщение иnext_cursornull, а порядок совпадает с(created_at, id)
Requirement: Подтверждённое сообщение сразу видно
Сообщение, на которое сервис ответил 201, SHALL присутствовать в любом следующем чтении истории этого чата.
Scenario: Чтение после записи
- WHEN участник получил 201 на отправку и сразу читает историю
- THEN сообщение есть в истории