Files
mtusi2026lab2/openspec/specs/messages/spec.md
T
ricoromaandClaude Opus 5.5 7b775a29a9 chore: carry over lab 1 solution into lab 2 skeleton
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>
2026-09-30 22:11:46 +03:00

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_cursor null, а порядок совпадает с (created_at, id)

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

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

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

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