Verify and archive final lab3 fixes for lab4
This commit is contained in:
+2
@@ -1,2 +1,4 @@
|
||||
schema: spec-driven
|
||||
created: 2026-11-06
|
||||
archived: 2026-11-06
|
||||
lab: 4
|
||||
+12
-12
@@ -1,20 +1,20 @@
|
||||
## 1. Перенос обязательного минимума
|
||||
|
||||
- [ ] 1.1 Перенести исправления Identity и их unit/API регрессии.
|
||||
- [ ] 1.2 Перенести валидацию Messaging с сохранением attachment_ids; проверить пустой текст с вложением.
|
||||
- [ ] 1.3 Перенести экранирование ошибок HAProxy и проверить шаблоны.
|
||||
- [ ] 1.4 Составить полный манифест диапазона и причин исключения; сохранить source archives и адаптировать контекст.
|
||||
- [ ] 1.5 Выполнить check/validate/lint/student-test, закоммитить код.
|
||||
- [x] 1.1 Перенести исправления Identity и их unit/API регрессии.
|
||||
- [x] 1.2 Перенести валидацию Messaging с сохранением attachment_ids; проверить пустой текст с вложением.
|
||||
- [x] 1.3 Перенести экранирование ошибок HAProxy и проверить шаблоны.
|
||||
- [x] 1.4 Составить полный манифест диапазона и причин исключения; сохранить source archives и адаптировать контекст.
|
||||
- [x] 1.5 Выполнить check/validate/lint/student-test, закоммитить код.
|
||||
|
||||
## 2. Реальный стенд и затронутые сценарии
|
||||
|
||||
- [ ] 2.1 Выполнить smoke/persistence/failover, stack faults, upload failover/S3 и сетевые регрессии.
|
||||
- [ ] 2.2 Проверить JSON ошибок 502/503/504 на реальном HAProxy с особыми request_id.
|
||||
- [ ] 2.3 Снять три прогона записи и три граничных замера памяти, записать фон.
|
||||
- [ ] 2.4 Повторить demo reconciler; обосновать применимость сохранённой матрицы стоимости.
|
||||
- [x] 2.1 Выполнить smoke/persistence/failover, stack faults, upload failover/S3 и сетевые регрессии.
|
||||
- [x] 2.2 Проверить JSON ошибок 502/503/504 на реальном HAProxy с особыми request_id.
|
||||
- [x] 2.3 Снять три прогона записи и три граничных замера памяти, записать фон.
|
||||
- [x] 2.4 Повторить demo reconciler; обосновать применимость сохранённой матрицы стоимости.
|
||||
|
||||
## 3. Завершение
|
||||
|
||||
- [ ] 3.1 Обновить evidence/forward-port.md и ограничения REPORT, сохранить minor без исправления.
|
||||
- [ ] 3.2 Остановить свои стенды без удаления volumes, синхронизировать specs и архивировать цикл.
|
||||
- [ ] 3.3 Выполнить lint перед финальным коммитом, подтвердить чистое дерево и неизменность нормативных файлов.
|
||||
- [x] 3.1 Обновить evidence/forward-port.md и ограничения REPORT, сохранить minor без исправления.
|
||||
- [x] 3.2 Остановить свои стенды без удаления volumes, синхронизировать specs и архивировать цикл.
|
||||
- [x] 3.3 Выполнить lint перед финальным коммитом, подтвердить чистое дерево и неизменность нормативных файлов.
|
||||
@@ -7,6 +7,8 @@
|
||||
|
||||
Сервис SHALL принимать `POST /api/v1/chats` от аутентифицированного пользователя с телом `{"title":..., "member_ids":[...]}` и возвращать `201` с объектом `Chat`. `title` SHALL содержать от 1 до 100 code points и не состоять только из пробельных символов. `member_ids` SHALL содержать от 1 до 100 уникальных идентификаторов существующих пользователей и SHALL включать вызывающего. Чат SHALL создаваться атомарно: при любой ошибке валидации он не создаётся вовсе.
|
||||
|
||||
По правилам неверных полей и атомарного создания из `contracts/README.md`, `title` SHALL NOT содержать NUL.
|
||||
|
||||
#### Scenario: Чат создан
|
||||
|
||||
- **WHEN** участник отправляет `POST /api/v1/chats` с корректным `title` и списком из своего и чужого идентификаторов
|
||||
@@ -34,6 +36,12 @@
|
||||
- **WHEN** `POST /api/v1/chats` приходит без `Authorization: Bearer` или с недействительным токеном
|
||||
- **THEN** ответ `401` с кодом `unauthorized` и `WWW-Authenticate: Bearer realm="messenger"`
|
||||
|
||||
#### Scenario: NUL в названии чата
|
||||
|
||||
- **WHEN** аутентифицированный пользователь отправляет `POST /api/v1/chats` с NUL в `title` и корректными участниками
|
||||
- **THEN** ответ `400` с телом `{"error":{"code":"invalid_request","message":...,"request_id":...}}`; чат не появляется в списке
|
||||
- **AND** ответ содержит непустые `X-Instance-Id` и `X-Request-Id`, совпадающий с `error.request_id`
|
||||
|
||||
### Requirement: Членство как граница доступа
|
||||
|
||||
Чат SHALL быть доступен только своим участникам. Посторонний пользователь SHALL получать `404` с кодом `not_found` — тот же ответ, что и для несуществующего чата. Сервис SHALL NOT использовать `403` и SHALL NOT раскрывать факт существования чужого чата ни кодом ответа, ни текстом сообщения.
|
||||
|
||||
@@ -7,6 +7,8 @@
|
||||
|
||||
Сервис SHALL принимать `POST /api/v1/chats/{chat_id}/messages` от участника чата с телом `{"text":..., "attachment_ids":[...]}` и обязательным заголовком `Idempotency-Key` и возвращать `201` с объектом `Message`. Отправитель SHALL выводиться из предъявленной идентификации; поле `sender_id` в теле запроса SHALL NOT приниматься. `text` SHALL быть обязательным, содержать не более 4000 Unicode code points и SHALL NOT состоять только из пробельных символов; пустая строка допустима только при хотя бы одном вложении. `attachment_ids` SHALL быть необязательным списком из 0–10 уникальных UUID (по умолчанию `[]`); каждое вложение SHALL принадлежать этому чату и быть готовым, иначе ответ `404`. Порядок `attachment_ids` SHALL сохраняться, а одно вложение SHALL допускаться в нескольких сообщениях. Каждый `Message` в ответе SHALL содержать `attachment_ids`, у текстового — `[]`. `id` и `created_at` SHALL назначаться сервером. Правила ключа описаны в `lab3-idempotent-messages`.
|
||||
|
||||
По правилам неверных полей, доступа и идемпотентности из `contracts/README.md`, `text` SHALL NOT содержать NUL; отклонённая запись SHALL NOT занимать `Idempotency-Key`.
|
||||
|
||||
#### Scenario: Сообщение отправлено
|
||||
|
||||
- **WHEN** участник отправляет `{"text":"Привет, мир 👋"}` в свой чат с новым `Idempotency-Key`
|
||||
@@ -65,6 +67,17 @@
|
||||
- **WHEN** посторонний отправляет в чужой чат с ключом тело с пустым `text` или с 11 вложениями
|
||||
- **THEN** ответ `404`, а не `400`
|
||||
|
||||
#### Scenario: NUL в тексте сообщения
|
||||
|
||||
- **WHEN** участник отправляет `POST /api/v1/chats/{chat_id}/messages` с NUL в `text` и новым корректным `Idempotency-Key`
|
||||
- **THEN** ответ `400` с телом `{"error":{"code":"invalid_request","message":...,"request_id":...}}`; история не меняется, исправленное сообщение с тем же ключом получает `201`, повтор возвращает тот же объект
|
||||
- **AND** ответ содержит непустые `X-Instance-Id` и `X-Request-Id`, совпадающий с `error.request_id`
|
||||
|
||||
#### Scenario: NUL не раскрывает чужой чат
|
||||
|
||||
- **WHEN** посторонний отправляет сообщение с NUL в чужой или несуществующий чат с корректным ключом
|
||||
- **THEN** ответ `404 not_found` в стандартном теле ошибки с `X-Instance-Id` и `X-Request-Id`; записи нет
|
||||
|
||||
### Requirement: Порядок истории
|
||||
|
||||
История чата SHALL быть упорядочена по паре `(created_at, id)` по возрастанию. Время SHALL назначаться сервером в формате RFC 3339 UTC с суффиксом `Z`. Сервис SHALL гарантировать, что `created_at` внутри одного чата строго возрастает в порядке фиксации сообщений, в том числе при конкурентных вставках через разные процессы API, — иначе обход истории keyset-курсором теряет запись, зафиксированную позже с меньшей отметкой.
|
||||
|
||||
@@ -7,6 +7,8 @@
|
||||
|
||||
Сервис SHALL принимать `POST /api/v1/users` без аутентификации и возвращать `201` с объектом `User`, содержащим назначенные сервером `id` и `created_at`. Тело запроса SHALL содержать ровно поля `username`, `display_name` и `password`. `username` SHALL соответствовать `^[a-z0-9_]{3,32}$` и быть уникальным, `display_name` SHALL содержать от 1 до 100 Unicode code points и не состоять только из пробельных символов, требования к `password` задаёт `lab2-auth-sessions`. Ответ SHALL NOT содержать полей, отсутствующих в схеме `User`. Уникальность SHALL соблюдаться и при конкурентной регистрации одного `username`: успешной будет ровно одна, остальные получат `409`.
|
||||
|
||||
По правилам неверных полей и ошибок из `contracts/README.md`, `display_name` SHALL NOT содержать NUL.
|
||||
|
||||
#### Scenario: Пользователь создан
|
||||
|
||||
- **WHEN** приходит `POST /api/v1/users` с телом `{"username":"alice_01","display_name":"Алиса","password":"<12+ символов>"}`
|
||||
@@ -39,6 +41,12 @@
|
||||
- **WHEN** `POST /api/v1/users` приходит без заголовка `Authorization`
|
||||
- **THEN** запрос обрабатывается на общих основаниях, ответ не равен `401`
|
||||
|
||||
#### Scenario: NUL в отображаемом имени
|
||||
|
||||
- **WHEN** `POST /api/v1/users` содержит NUL в `display_name`
|
||||
- **THEN** ответ `400` с телом `{"error":{"code":"invalid_request","message":...,"request_id":...}}`; пользователь не создаётся, повтор с корректным именем и тем же username может дать `201`
|
||||
- **AND** ответ содержит непустые `X-Instance-Id` и `X-Request-Id`, совпадающий с `error.request_id`
|
||||
|
||||
### Requirement: Чтение текущего пользователя
|
||||
|
||||
Сервис SHALL отдавать по `GET /api/v1/users/me` объект `User` владельца предъявленной `Bearer`-сессии в том же виде, в каком он был возвращён при регистрации.
|
||||
|
||||
@@ -31,6 +31,8 @@
|
||||
|
||||
Сервис SHALL принимать `POST /api/v1/auth/sessions` только с заголовком `Authorization: Basic <base64(username:password)>` и без тела. Декодирование base64 SHALL быть строгим, разделителем SHALL служить первое двоеточие, пароль SHALL декодироваться как UTF-8. При верных учётных данных ответ SHALL быть `201` с телом `{"token","token_type":"Bearer","expires_at","user"}`, где `token` — непрозрачная случайная строка не короче 32 символов с энтропией не менее 256 бит, `expires_at` — RFC 3339 UTC с `Z`, а `user` совпадает с ответом регистрации. Неверный пароль, неизвестный `username`, отсутствующий и испорченный заголовок SHALL давать одинаковый `401` с кодом `unauthorized` и заголовком `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`.
|
||||
|
||||
В соответствии с разделом «Идентификация и сессии» `contracts/README.md`, NUL в Basic username и не-ASCII символы в закодированной части Basic SHALL приводить к тому же `401 unauthorized`.
|
||||
|
||||
#### Scenario: Успешный вход
|
||||
|
||||
- **WHEN** зарегистрированный пользователь отправляет верные `username:password` в `Basic`
|
||||
@@ -58,6 +60,18 @@
|
||||
- **WHEN** запрос с верным `Basic` содержит тело
|
||||
- **THEN** ответ `400` с кодом `invalid_request`, сессия не создаётся
|
||||
|
||||
#### Scenario: Username с NUL
|
||||
|
||||
- **WHEN** в `POST /api/v1/auth/sessions` передан корректный Base64 от username с NUL и пароля
|
||||
- **THEN** ответ `401` с `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`; тело `{"error":{"code":"unauthorized","message":...,"request_id":...}}` совпадает с ошибкой неверного пароля, кроме `request_id`
|
||||
- **AND** ответ содержит непустые `X-Instance-Id` и `X-Request-Id`, совпадающий с `error.request_id`
|
||||
|
||||
#### Scenario: Не-ASCII в закодированной части Basic
|
||||
|
||||
- **WHEN** `POST /api/v1/auth/sessions` получает `Authorization` с не-ASCII байтами после `Basic `, в том числе `0xff`
|
||||
- **THEN** ответ `401` с `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`; тело `{"error":{"code":"unauthorized","message":...,"request_id":...}}` совпадает с ошибкой неверного пароля, кроме `request_id`
|
||||
- **AND** ответ содержит непустой `X-Instance-Id` и `X-Request-Id`, совпадающий с `error.request_id`; сессия не создаётся
|
||||
|
||||
### Requirement: Защищённые endpoint принимают только Bearer
|
||||
|
||||
Все `/api/v1/*`, кроме `POST /api/v1/users` и `POST /api/v1/auth/sessions`, SHALL требовать `Authorization: Bearer <token>`; схема сравнивается без учёта регистра. Отсутствующий, неизвестный, истёкший и отозванный токен, а также `Basic` на этих endpoint SHALL давать `401` с кодом `unauthorized` и `WWW-Authenticate: Bearer realm="messenger"`. Заголовок `X-User-Id` SHALL игнорироваться: он не даёт доступа и не меняет владельца сессии. Аутентификация SHALL выполняться раньше проверки доступа к ресурсу и раньше валидации пути, параметров и тела.
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
|
||||
### Requirement: Выход инвалидирует кэш
|
||||
|
||||
Отзыв сессии SHALL записывать в кэш отметку отзыва на оставшийся срок сессии до удаления строки в БД, а заполнение кэша после промаха SHALL выполняться только при отсутствии ключа. Отозванный токен SHALL получать `401` и при гонке «чтение заполнило кэш после выхода». Если отметку отзыва записать нельзя, выход SHALL отвечать `503` и SHALL NOT удалять сессию. Если после записи отметки удалить сессию в PostgreSQL не удалось, выход SHALL отвечать `503` и SHALL снимать отметку отзыва: ответ `503` означает, что сессия осталась действующей и в БД, и для проверки токена.
|
||||
Отзыв сессии SHALL инвалидировать кэш до фиксации удаления в PostgreSQL. Отозванный токен SHALL получать `401` и при гонке «чтение заполнило кэш после выхода», включая потерю или смену состояния кэша. Если инвалидация невозможна, выход SHALL отвечать `503` и SHALL NOT фиксировать удаление сессии. Если транзакция удаления не завершилась, выход SHALL отвечать `503` и SHALL снимать отметку отзыва: сессия остаётся действующей. Основание: `contracts/README.md`, выход и абсолютный TTL; `README.md`, уровень «3», сохранение минимума lab2.
|
||||
|
||||
#### Scenario: Отозванный токен не оживает из кэша
|
||||
|
||||
@@ -33,10 +33,20 @@
|
||||
|
||||
#### Scenario: Выход при сбое PostgreSQL
|
||||
|
||||
- **WHEN** отметка отзыва записана, но удаление сессии в PostgreSQL завершилось ошибкой
|
||||
- **WHEN** отметка отзыва записана, но транзакция удаления сессии в PostgreSQL завершилась ошибкой
|
||||
- **THEN** выход отвечает `503` с кодом `unavailable`, токен по-прежнему получает `200`, отметки отзыва в кэше нет
|
||||
- **AND** после возвращения PostgreSQL повторный выход отвечает `204`, а токен затем получает `401`
|
||||
|
||||
#### Scenario: Запоздавшее чтение после выхода и потери кэша
|
||||
|
||||
- **WHEN** чтение действующей сессии задержалось, другая реплика завершила logout с `204`, затем очистка или вытеснение удалили отметку отзыва и задержанное чтение продолжилось
|
||||
- **THEN** новый `GET /api/v1/users/me` с тем же токеном получает `401` с `WWW-Authenticate: Bearer realm="messenger"` и телом общей ошибки, даже если другая проверка успела заново обратиться к кэшу
|
||||
|
||||
#### Scenario: Очистка кэша до завершения выхода
|
||||
|
||||
- **WHEN** кэш очищен после инвалидации, но до COMMIT удаления сессии, и параллельно начинается новая проверка токена
|
||||
- **THEN** эта проверка не оставляет действующую сессию в кэше после успешного logout, следующие запросы получают `401`
|
||||
|
||||
### Requirement: Недоступный кэш обходится, но не открывает доступ
|
||||
|
||||
При ошибке или таймауте Valkey проверка сессии SHALL выполняться по PostgreSQL за ограниченное время, а повторные попытки обращения к кэшу SHALL приостанавливаться на короткий интервал. Недействительный токен SHALL получать `401`; запрос SHALL NOT приниматься как анонимный. Недоступность Valkey SHALL NOT переводить `/health/ready` в `503`.
|
||||
|
||||
@@ -46,6 +46,12 @@
|
||||
- **WHEN** все реплики API остановлены
|
||||
- **THEN** запрос через LB получает `503` с телом `{"error":{"code":"unavailable",...}}`
|
||||
|
||||
#### Scenario: Специальные символы идентификатора в ошибке LB
|
||||
|
||||
- **WHEN** запрос с допустимым `X-Request-Id`, содержащим кавычку, обратную косую черту или табуляцию, получает ошибку `502`, `503` или `504` от балансировщика
|
||||
- **THEN** заголовок ответа сохраняет исходное значение, тело является валидным JSON, а декодированное `error.request_id` совпадает с заголовком
|
||||
- **AND** сохраняется общий формат ошибки из `contracts/README.md`; требование относится к единой точке входа уровня «3» `README.md`
|
||||
|
||||
### Requirement: Повтор запросов балансировщиком
|
||||
|
||||
Балансировщик SHALL повторять на другой реплике запрос, который не удалось отправить из-за отказа соединения. Повтор после того, как запрос мог быть обработан, SHALL допускаться только для `GET` и для `POST /api/v1/chats/{chat_id}/messages` с `Idempotency-Key`. Балансировщик SHALL NOT прозрачно повторять `POST /api/v1/users`, `POST /api/v1/chats` и `POST /api/v1/auth/sessions`.
|
||||
|
||||
Reference in New Issue
Block a user