Files
mtusi2026lab5/openspec/changes/async-attachments/specs/data-storage/spec.md
T
2026-10-31 04:06:09 +03:00

80 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Spec Delta
## MODIFIED Requirements
### Requirement: Хранение в PostgreSQL
Пользователи, чаты, участники чатов, сообщения, сессии, с лабы 4 —
метаданные вложений и связи сообщений с вложениями, а с лабы 5 — задания
обработки и метаданные вариантов SHALL храниться в PostgreSQL, он — источник
истины. Сервис MUST NOT хранить эти данные в памяти процесса, файлах или
SQLite. Сообщение брокера лишь сообщает о задании: состояние задания MUST NOT
определяться по брокеру. Байты вложений SHALL храниться в S3 (capability
`attachments`, `object-storage`), а не в PostgreSQL и не в файлах реплик.
Подтверждённая запись (ответ 201, 202 или 204) SHALL быть зафиксирована до
ответа и видна следующему запросу.
#### Scenario: Созданное видно сразу
- **WHEN** клиент зарегистрировался и следующим запросом входит с теми
же username и паролем
- **THEN** вход успешен, и `GET /api/v1/users/me` с выданным токеном
возвращает этого пользователя
#### Scenario: Принятое вложение видно сразу
- **WHEN** участник получил ответ 202 на загрузку и сразу запрашивает
метаданные через другую реплику
- **THEN** ответ 200 с тем же `id`, а `status` — `queued` или более поздний
### Requirement: Целостность данных в БД
Ограничения SHALL проверяться самой БД, а не только сервисом:
- уникальность `username`;
- существование пользователей и чатов, на которые ссылаются участники
и сообщения;
- уникальность участника в чате;
- членство отправителя в чате сообщения.
С лабы 4 БД SHALL проверять и вложения:
- владелец вложения — участник его чата;
- связь сообщения с вложением ссылается на существующие сообщение и
вложение;
- вложение не повторяется в одном сообщении, у каждого места в порядке
одно вложение, мест не больше 10;
- вложение, на которое ссылается сообщение, удалить нельзя;
- допустимые значения размера, SHA-256, типа, статуса и длины
`filename`; ключ объекта уникален.
С лабы 5 БД SHALL проверять и обработку:
- код ошибки есть только у вложения `failed`, и у `failed` он есть;
- на вложение и версию конвейера одно задание, оно ссылается на существующее
вложение; вложение с заданием удалить нельзя;
- допустимые значения состояния и числа попыток задания;
- вариант уникален по вложению, версии конвейера и имени; он ссылается на
существующее вложение; допустимые значения имени, типа, размера, ширины,
высоты и SHA-256; ключ объекта варианта уникален.
Порядок `member_ids`, заданный при создании чата, и порядок
`attachment_ids` сообщения SHALL сохраняться. Принадлежность вложения
чату сообщения проверяет сервис в той же транзакции: чат вложения и
чат сообщения не меняются после записи.
#### Scenario: Порядок участников
- **WHEN** чат создан с `member_ids` в порядке `[bob, alice]`
- **THEN** `GET` этого чата и список чатов возвращают `member_ids` в
том же порядке, в том числе после рестарта стенда
#### Scenario: Порядок вложений
- **WHEN** сообщение отправлено с `attachment_ids` `[C, A, B]`
- **THEN** ответ на отправку, история чата и повтор с тем же ключом
возвращают `[C, A, B]`
#### Scenario: Ограничения обработки в схеме
- **WHEN** проверяющий пытается вставить второе задание той же версии конвейера,
второй вариант с тем же именем и `error_code` у вложения не `failed`
- **THEN** PostgreSQL отклоняет каждую вставку нарушением ограничения