Files
mtusi2026lab5/openspec/specs/chats/spec.md
T
ricoromaandClaude Opus 5.5 04f859282d chore: port lab 4 solution into the lab 5 skeleton
Source: mtusi2026lab4-safronov, solution/bvt2301-safronov, 2546deb.
Contracts, public tests and evidence of lab 4 are not carried over.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 03:09:12 +03:00

5.9 KiB
Raw Blame History

chats Specification

Purpose

Чаты — группы пользователей с фиксированным составом, в которых идёт переписка. Capability описывает создание, получение и список чатов текущего пользователя, а также правило «чат видят только участники».

Requirements

Requirement: Создание чата

POST /api/v1/chats SHALL принимать тело {"title": ..., "member_ids": [...]} и при успехе отвечать 201 с объектом Chat: id, title, member_ids, created_at, без других полей. member_ids в ответе SHALL совпадать с переданным списком, включая порядок: те же UUID в том же порядке, записанные в нижнем регистре, даже если клиент передал их в верхнем (требования api-conventions «UUID на входе» и «Представление времени и идентификаторов»). Чат SHALL создаваться атомарно: при любой ошибке валидации он MUST NOT появиться ни в одном списке.

Scenario: Успешное создание

  • WHEN Алиса создаёт чат с member_ids = [Алиса, Боб]
  • THEN ответ 201, member_ids равен [Алиса, Боб], id — новый UUID

Scenario: Участник в верхнем регистре

  • WHEN Алиса создаёт чат с member_ids = [Алиса, Боб], где id Боба записан в верхнем регистре
  • THEN ответ 201, member_ids равен [Алиса, Боб] в нижнем регистре, и Боб видит чат в своём списке

Requirement: Валидация чата

title SHALL содержать 1–100 Unicode code points и MUST NOT состоять только из пробельных символов. member_ids SHALL быть массивом от 1 до 100 UUID без повторов; повтором SHALL считаться тот же UUID в любой допустимой записи. Каждый элемент MUST быть идентификатором существующего пользователя, и текущий пользователь MUST входить в список. Нарушение любого условия SHALL давать 400 invalid_request.

Scenario: Вызывающего нет в списке

  • WHEN Алиса создаёт чат с member_ids = [Боб]
  • THEN ответ 400

Scenario: Повтор участника

  • WHEN member_ids = [Алиса, Алиса]
  • THEN ответ 400

Scenario: Повтор участника в другом регистре

  • WHEN member_ids = [Алиса, Алиса], где второй id записан в верхнем регистре
  • THEN ответ 400, чат не создан

Scenario: Неизвестный участник

  • WHEN member_ids содержит UUID, которого нет среди пользователей
  • THEN ответ 400

Scenario: Пустой список

  • WHEN member_ids = []
  • THEN ответ 400

Scenario: member_ids не массив

  • WHEN member_ids равен {}, 123, false или строке с id Алисы вместо массива
  • THEN ответ 400 с code invalid_request, чат не создан

Requirement: Получение чата

GET /api/v1/chats/{chat_id} SHALL отвечать 200 с объектом Chat, если текущий пользователь — участник. Если чата нет или пользователь не участник, сервис SHALL отвечать одинаковым 404 not_found и MUST NOT использовать 403. chat_id, не являющийся UUID, SHALL давать 400.

Scenario: Участник

  • WHEN Боб запрашивает чат, в котором состоит
  • THEN ответ 200 с этим чатом

Scenario: Посторонний

  • WHEN Ева запрашивает существующий чат Алисы и Боба
  • THEN ответ 404 с code not_found, неотличимый от ответа на несуществующий чат

Scenario: Неверный chat_id

  • WHEN chat_id равен nope
  • THEN ответ 400

Requirement: Список чатов пользователя

GET /api/v1/chats SHALL возвращать только чаты, в которых состоит текущий пользователь, в порядке (created_at, id) по возрастанию, с постраничным выводом по capability pagination.

Scenario: Участник видит чат

  • WHEN Боб запрашивает список чатов после того, как Алиса создала чат с ним
  • THEN этот чат есть в списке

Scenario: Посторонний не видит чат

  • WHEN Ева запрашивает список чатов
  • THEN чата Алисы и Боба в нём нет

Requirement: Состав чата неизменен

После создания состав участников чата SHALL оставаться неизменным: API лабы 1 не предоставляет операций добавления и удаления участников.

Scenario: Повторное чтение

  • WHEN участник читает чат в разное время
  • THEN member_ids каждый раз одинаков