Files
mtusi2026lab4/openspec/specs/messages/spec.md
T
ricoromaandClaude Opus 5.5 5d5d8f9d2a chore: carry lab 3 over
- carry the lab 3 solution over from mtusi2026lab3-safronov
  (solution/bvt2301-safronov, ce89eba): src, migrations, student-tests,
  bench, openspec, .claude, infra/haproxy and infra/valkey, own scripts,
  Dockerfile, compose, pyproject and uv lock
- merge Makefile, .gitignore and .dockerignore (the lab 3 versions only
  add lines to the skeleton, which is the same in lab 4) and
  .env.example (lab 4 skeleton names listed in the header)
- rename the compose project to mtusi-lab4 and the image to :lab4 so
  the stand does not reuse the lab 3 containers and volumes
- update AGENTS.md for lab 4: current lab, origin commit, contract and
  test files of the new skeleton

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 17:32:33 +03:00

4.2 KiB
Raw Blame History

messages Specification

Purpose

Текстовые сообщения в чате: отправка от имени текущего пользователя и чтение истории чата его участниками в порядке (created_at, id).

Requirements

Requirement: Отправка сообщения

POST /api/v1/chats/{chat_id}/messages SHALL принимать тело {"text": ...} с заголовком Idempotency-Key и при успехе отвечать 201 с объектом Message: id, chat_id, sender_id, text, created_at, без других полей. sender_id SHALL быть текущим пользователем, text SHALL совпадать с отправленным. Формат ключа, повтор и конфликт описаны в capability idempotency.

Scenario: Участник отправляет сообщение

  • WHEN Алиса отправляет "Привет, мир 👋" в свой чат с новым Idempotency-Key
  • 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_cursor null, а порядок совпадает с (created_at, id)

Requirement: Подтверждённое сообщение сразу видно

Сообщение, на которое сервис ответил 201, SHALL присутствовать в любом следующем чтении истории этого чата.

Scenario: Чтение после записи

  • WHEN участник получил 201 на отправку и сразу читает историю
  • THEN сообщение есть в истории