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>
5.9 KiB
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 с
codeinvalid_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 с
codenot_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каждый раз одинаков