Propose final lab 5 fixes as an OpenSpec change
This commit is contained in:
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-11-07
|
||||
@@ -0,0 +1,19 @@
|
||||
## Context
|
||||
ЛР6 на 237a7c93e507b984add5b49c51c6720a6bfca505 содержит завершённую наблюдаемость. Источник только immutable lab5-c7b8feb805d151e878d77b0dff47320a9436b172, диапазон от f88e9ba43cdfd7eb6a5a7ae5feb4247b4e820071. Большинство затронутых файлов совпадает с базой; различия RabbitMQ описания и JobObserver в тестах разрешаются вручную.
|
||||
|
||||
## Goals / Non-Goals
|
||||
Восстановить наследуемые гарантии без изменения trace context, middleware, SQLAlchemy/Alembic, ack после COMMIT и новых метрик ЛР6. Не переносить отчёты или измерения ЛР5 как доказательства ЛР6.
|
||||
|
||||
## Decisions
|
||||
- Порты SessionDirectory/SessionRevocations сохраняются. PostgresSessionDirectory использует FOR KEY SHARE при промахе; CachedSessionDirectory резервирует заполнение nonce и инвалидирует его Lua-операцией. Удаление сессии и инвалидация упорядочены внутри транзакции. Цена — дополнительная работа при cache miss; cached GET остаётся прежним. Альтернатива копирования только revoke недостаточна для гонки после потери кэша.
|
||||
- Валидация PNG проверяет поток IDAT до записи в S3, учитывает исходные samples tRNS; tiles ограничивают временные буферы. Сохраняем исходный проверенный алгоритм, не заменяем его другим декодером. Лимиты worker остаются прежними.
|
||||
- RabbitMQ policy delivery-limit=-1 предотвращает DLQ из-за недоступной БД; JOB_MAX_ATTEMPTS и reject некорректных сообщений ограничивают бизнес-обработку. Не менять consumer или его OTel JobObserver.
|
||||
- Импортировать собственные regression tests, добавить JobObserver в прямые вызовы handle_job. Linux boundary fixture генерировать локально в student-tests вместо зависимости от evidence ЛР5; вспомогательные compose project/пути/порты адаптировать к ЛР6.
|
||||
- Specs переносить дельтами исходных capabilities; исторические archives и отчёты источника перечислить как provenance, не выдавать за выполненные этапы ЛР6. openspec/config получает только применимые уточнения версий и доказательств.
|
||||
- Context7 вызван, но ответил Monthly quota exceeded. Семантика FOR KEY SHARE и delivery-limit=-1 проверена по официальным SQLAlchemy 2.0 и RabbitMQ 4.1 docs; ссылки сохраняются в evidence.
|
||||
|
||||
## Risks / Trade-offs
|
||||
Изменение auth может повлиять на цену telemetry → все 15 серий off/on/head/tail/balanced повторяются с исходной методикой, старые файлы сохраняются. Изменение PNG влияет на память и retry → тесты прозрачности, границы40MP, одновременно два задания, forced limits и последующий recovery. OTel увеличивает память относительно ЛР5 → обязательна проверка реального worker ЛР6. Общий Docker host → записать фон, не запускать параллельные нагрузки и не трогать чужие контейнеры.
|
||||
|
||||
## Migration Plan
|
||||
Создать proposal checkpoint; перенести diff по файлам, выполнить check/validate/lint/student-test; закоммитить код перед замерами. Собрать образ, обновить существующий собственный стенд с сохранением volumes, проверить policy и миграции без изменения схемы. Выполнить network/PNG/requeue, публичные отказы и корреляцию; повторить затронутые серии. Закрыть tasks, синхронизировать specs, архивировать change, остановить свой стенд без удаления volumes. Откат при дефекте — отдельная корректировка, без reset/clean и потери WIP.
|
||||
@@ -0,0 +1,27 @@
|
||||
## Why
|
||||
После исходного переноса опубликован immutable snapshot ЛР5 c7b8feb805d151e878d77b0dff47320a9436b172. Диапазон от f88e9ba43cdfd7eb6a5a7ae5feb4247b4e820071 исправляет обязательные сценарии, унаследованные уровнем «3» ЛР6; новые механизмы наблюдаемости должны сохраниться.
|
||||
|
||||
## What Changes
|
||||
- Перенос валидации NUL/Basic/PNG, согласованного отзыва сессий и экранирования JSON ошибок HAProxy.
|
||||
- Сохранение заданий при длительном инфраструктурном requeue, корректная прозрачность PNG исходной глубины и ограничение памяти декодирования.
|
||||
- Регрессионные тесты источника с адаптацией к JobObserver и инфраструктуре ЛР6; новые реальные evidence.
|
||||
- Повтор затронутого трека «5» на новом коде; прежние измерения сохраняются с исходным SHA.
|
||||
|
||||
## Capabilities
|
||||
### Modified Capabilities
|
||||
- `lab1-messenger-chats`: отклонение NUL.
|
||||
- `lab1-messenger-history`: NUL без расходования ключа идемпотентности.
|
||||
- `lab1-messenger-identity`: валидация строк и Basic.
|
||||
- `lab2-auth-sessions`: ошибки аутентификации.
|
||||
- `lab2-session-cache`: отзыв и запоздалое заполнение.
|
||||
- `lab3-load-balancing`: корректный JSON ошибок.
|
||||
- `lab4-attachments`: повреждённые PNG.
|
||||
- `lab5-image-variants`: прозрачность и память.
|
||||
- `lab5-job-delivery`: инфраструктурные повторные доставки.
|
||||
- `lab5-job-recovery`: DLQ только для соответствующих отказов.
|
||||
|
||||
## Impact
|
||||
Изменяются собственные src, student-tests, HAProxy/RabbitMQ и specs. Публичный API, миграции и зависимости не меняются. evidence/forward-port.md перечислит весь диапазон, неприменимые артефакты и команды; он служит материалом для строк REPORT о наследуемых сценариях и цене наблюдаемости, сам REPORT готовит следующий агент.
|
||||
|
||||
## Non-goals
|
||||
Не добавлять возможности из Out of scope openspec/config.yaml, ЛР7 и трека2. Не менять нормативные файлы, существующие REPORT/evidence, runner/state и другие репозитории; не публиковать.
|
||||
@@ -0,0 +1,40 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Создание чата
|
||||
|
||||
Сервис 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` и списком из своего и чужого идентификаторов
|
||||
- **THEN** ответ `201`, тело соответствует схеме `Chat`, `member_ids` совпадает с запрошенным составом
|
||||
- **AND** `id` и `created_at` назначены сервером
|
||||
|
||||
#### Scenario: Вызывающий не входит в состав
|
||||
|
||||
- **WHEN** `member_ids` не содержит идентификатора вызывающего
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Состав содержит дубликаты
|
||||
|
||||
- **WHEN** `member_ids` содержит один и тот же идентификатор дважды
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Состав содержит неизвестного пользователя
|
||||
|
||||
- **WHEN** `member_ids` содержит идентификатор, которому не соответствует ни один пользователь
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
- **AND** чат не создаётся
|
||||
|
||||
#### Scenario: Запрос без идентификации
|
||||
|
||||
- **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`
|
||||
@@ -0,0 +1,81 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Отправка сообщения
|
||||
|
||||
Сервис 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`; вложение в `queued`, `processing` или `ready` SHALL прикрепляться сразу после upload, а вложение в `failed` SHALL давать `409` с кодом `conflict`, и сообщение не сохраняется. Порядок `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`
|
||||
- **THEN** ответ `201`, тело соответствует схеме `Message`, `attachment_ids` равен `[]`
|
||||
- **AND** `sender_id` равен идентификатору вызывающего, `chat_id` равен чату из пути, `text` побайтово совпадает с отправленным
|
||||
|
||||
#### Scenario: Сообщение с вложением без текста
|
||||
|
||||
- **WHEN** участник отправляет `{"text":"","attachment_ids":[id]}`, где `id` — вложение этого чата в `queued`, `processing` или `ready`
|
||||
- **THEN** ответ `201`, `attachment_ids` равен `[id]`
|
||||
|
||||
#### Scenario: Порядок вложений сохраняется
|
||||
|
||||
- **WHEN** участник отправляет три вложения чата в порядке `[c, a, b]`
|
||||
- **THEN** ответ и история содержат `attachment_ids` в том же порядке `[c, a, b]`
|
||||
|
||||
#### Scenario: Вложение другого чата или неизвестное
|
||||
|
||||
- **WHEN** `attachment_ids` содержит вложение другого чата того же пользователя или несуществующий UUID
|
||||
- **THEN** ответ `404` с кодом `not_found`, сообщение не сохраняется
|
||||
|
||||
#### Scenario: Вложение в failed
|
||||
|
||||
- **WHEN** `attachment_ids` содержит вложение этого чата в состоянии `failed`
|
||||
- **THEN** ответ `409` с кодом `conflict`, сообщение не сохраняется
|
||||
|
||||
#### Scenario: Слишком много, повторы или не UUID
|
||||
|
||||
- **WHEN** `attachment_ids` содержит 11 элементов, повторяющийся UUID или строку не в формате UUID
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Ключ не передан
|
||||
|
||||
- **WHEN** участник отправляет корректное тело без заголовка `Idempotency-Key`
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Отправитель не берётся из тела запроса
|
||||
|
||||
- **WHEN** тело запроса содержит поле `sender_id`
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Пустой или пробельный текст
|
||||
|
||||
- **WHEN** тело содержит `{"text":""}`, `{"text":"","attachment_ids":[]}` или `{"text":" "}` с вложениями или без
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Текст длиннее предела
|
||||
|
||||
- **WHEN** `text` содержит более 4000 Unicode code points
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
- **AND** длина считается в code points, а не в байтах UTF-8
|
||||
|
||||
#### Scenario: Посторонний пишет в чужой чат
|
||||
|
||||
- **WHEN** пользователь, не входящий в состав чата, отправляет корректное сообщение с ключом
|
||||
- **THEN** ответ `404` с кодом `not_found`
|
||||
- **AND** сообщение не сохраняется
|
||||
|
||||
#### Scenario: Доступ проверяется раньше содержимого
|
||||
|
||||
- **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`; записи нет
|
||||
@@ -0,0 +1,45 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Регистрация пользователя
|
||||
|
||||
Сервис 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+ символов>"}`
|
||||
- **THEN** ответ `201`, тело соответствует схеме `User`, `username` и `display_name` совпадают с запросом
|
||||
- **AND** `id` — UUID, назначенный сервером, `created_at` — RFC 3339 UTC с суффиксом `Z`
|
||||
|
||||
#### Scenario: Username занят
|
||||
|
||||
- **WHEN** приходит `POST /api/v1/users` с `username`, уже принадлежащим другому пользователю
|
||||
- **THEN** ответ `409` с телом ошибки и кодом `conflict`
|
||||
|
||||
#### Scenario: Username нарушает формат
|
||||
|
||||
- **WHEN** `username` содержит заглавные буквы, дефис, пробел, перевод строки или имеет длину вне 3–32 символов
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Display_name пуст или состоит из пробелов
|
||||
|
||||
- **WHEN** `display_name` равен `""`, `" "` или длиннее 100 code points
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
|
||||
#### Scenario: Тело запроса нарушает схему
|
||||
|
||||
- **WHEN** тело содержит лишнее поле, неверный тип поля, не содержит обязательного поля (в том числе `password`) или не является корректным JSON
|
||||
- **THEN** ответ `400` с кодом `invalid_request`
|
||||
- **AND** сообщение ошибки не содержит stack trace и внутренних деталей реализации
|
||||
|
||||
#### Scenario: Регистрация не требует идентификации
|
||||
|
||||
- **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`
|
||||
@@ -0,0 +1,46 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Вход по Basic выдаёт сессию
|
||||
|
||||
Сервис 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`
|
||||
- **THEN** ответ `201`, тело соответствует схеме `Session`, `token_type` равен `Bearer`
|
||||
- **AND** `user` побайтно равен телу ответа его регистрации, `expires_at` в будущем
|
||||
|
||||
#### Scenario: Неверный пароль и неизвестный пользователь неразличимы
|
||||
|
||||
- **WHEN** приходит `Basic` с неверным паролем существующего пользователя или с несуществующим `username`
|
||||
- **THEN** оба ответа — `401` с кодом `unauthorized` и `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`
|
||||
- **AND** тела ответов различаются только `request_id`
|
||||
|
||||
#### Scenario: Испорченный заголовок Basic
|
||||
|
||||
- **WHEN** заголовок отсутствует, содержит другую схему, невалидный base64 или строку без двоеточия
|
||||
- **THEN** ответ `401` с тем же заголовком `WWW-Authenticate: Basic ...`
|
||||
|
||||
#### Scenario: Двоеточие в пароле
|
||||
|
||||
- **WHEN** пароль пользователя содержит двоеточие и он входит по `Basic`
|
||||
- **THEN** ответ `201`: разделителем служит первое двоеточие
|
||||
|
||||
#### Scenario: Тело запроса при входе
|
||||
|
||||
- **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`; сессия не создаётся
|
||||
@@ -0,0 +1,31 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Выход инвалидирует кэш
|
||||
|
||||
Отзыв сессии SHALL инвалидировать кэш до фиксации удаления в PostgreSQL. Отозванный токен SHALL получать `401` и при гонке «чтение заполнило кэш после выхода», включая потерю или смену состояния кэша. Если инвалидация невозможна, выход SHALL отвечать `503` и SHALL NOT фиксировать удаление сессии. Если транзакция удаления не завершилась, выход SHALL отвечать `503` и SHALL снимать отметку отзыва: сессия остаётся действующей. Основание: `contracts/README.md`, выход и абсолютный TTL; `README.md`, уровень «3», сохранение минимума lab2.
|
||||
|
||||
#### Scenario: Отозванный токен не оживает из кэша
|
||||
|
||||
- **WHEN** токен закэширован, после чего пользователь выполняет `DELETE /api/v1/auth/sessions/current`
|
||||
- **THEN** ответ `204`, а следующий запрос с этим токеном получает `401`
|
||||
|
||||
#### Scenario: Выход при недоступном кэше
|
||||
|
||||
- **WHEN** Valkey остановлен и пользователь выполняет `DELETE /api/v1/auth/sessions/current`
|
||||
- **THEN** ответ `503` с кодом `unavailable`, а после запуска Valkey повторный выход отвечает `204`
|
||||
|
||||
#### Scenario: Выход при сбое 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`
|
||||
@@ -0,0 +1,21 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Готовность backend и обновление адресов
|
||||
|
||||
Балансировщик SHALL активно проверять каждую реплику запросом `GET /health/ready` и SHALL исключать из ротации реплику, которая не отвечает `200`. Адреса реплик SHALL обновляться через DNS без перезапуска балансировщика: остановленная реплика исчезает из ротации, запущенная или пересозданная появляется сама. Ответы, сформированные самим балансировщиком (`502`, `503`, `504`), SHALL иметь тело в общем формате ошибки с `request_id`, равным заголовку `X-Request-Id`.
|
||||
|
||||
#### Scenario: Реплика возвращается в ротацию
|
||||
|
||||
- **WHEN** остановленная реплика снова запущена
|
||||
- **THEN** после успешных проверок готовности балансировщик снова направляет на неё запросы без перезапуска `lb`
|
||||
|
||||
#### Scenario: Нет ни одной готовой реплики
|
||||
|
||||
- **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`
|
||||
@@ -0,0 +1,35 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Тип определяется по содержимому
|
||||
|
||||
Сервис SHALL принимать только `Content-Type` `image/png` и `image/jpeg` (параметры заголовка и регистр не важны) и SHALL проверять, что сигнатура и структура файла соответствуют заявленному типу, а файл читается без ошибок. Иной или отсутствующий `Content-Type`, несовпадение заявленного типа и содержимого, пустое тело, обрезанный или повреждённый файл, GIF, WebP и текст SHALL давать `415` с кодом `unsupported_media_type`.
|
||||
|
||||
#### Scenario: Подмена MIME
|
||||
|
||||
- **WHEN** JPEG, GIF или текст отправлены с `Content-Type: image/png`
|
||||
- **THEN** ответ `415` с кодом `unsupported_media_type`
|
||||
|
||||
#### Scenario: Обрезанное изображение
|
||||
|
||||
- **WHEN** отправлена первая половина корректного PNG или JPEG с верным `Content-Type`
|
||||
- **THEN** ответ `415`
|
||||
|
||||
#### Scenario: Неподдерживаемый Content-Type
|
||||
|
||||
- **WHEN** корректный PNG отправлен с `Content-Type: application/octet-stream` или без `Content-Type`
|
||||
- **THEN** ответ `415`
|
||||
|
||||
#### Scenario: Повреждённый поток пикселей при корректных CRC
|
||||
|
||||
- **WHEN** участник отправляет PNG с корректными CRC и IEND, но ошибочным zlib-потоком IDAT, его контрольной суммой, числом байтов строк или кодом фильтра
|
||||
- **THEN** `POST /api/v1/chats/{chat_id}/attachments` отвечает `415` с кодом `unsupported_media_type`, `X-Request-Id` и `X-Instance-Id`; строка вложения и объект не создаются
|
||||
|
||||
#### Scenario: Корректные варианты PNG
|
||||
|
||||
- **WHEN** участник загружает корректный PNG в пределах лимитов, в том числе Adam7, с разрешёнными глубиной цвета и фильтрами, а IDAT разделён на несколько чанков
|
||||
- **THEN** ответ `202 queued`; после обработки worker вложение становится `ready`, скачивание другим участником возвращает исходные байты
|
||||
|
||||
#### Scenario: Неоднозначный заголовок PNG
|
||||
|
||||
- **WHEN** участник отправляет PNG с повторным IHDR до IEND, даже при одинаковых размерах и корректных CRC, или с IHDR не первым чанком
|
||||
- **THEN** `POST /api/v1/chats/{chat_id}/attachments` отвечает `415` с кодом `unsupported_media_type`, `X-Request-Id` и `X-Instance-Id`; строка вложения и объект не создаются
|
||||
@@ -0,0 +1,59 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Crop и optimized
|
||||
|
||||
Worker SHALL строить для каждого задания, кроме `thumbnail`, вариант `crop` — JPEG, центрированный квадрат 128×128 после применения EXIF orientation, с увеличением маленьких исходников, — и вариант `optimized` — WebP, вписанный в 1280×1280 с сохранением пропорций, без увеличения, размеры округлены вниз и не меньше 1 px. Прозрачность (альфа-канал и PNG tRNS) во всех вариантах обеих версий pipeline SHALL компоноваться на белый фон согласно `contracts/README.md` («Вложения»). Варианты SHALL NOT содержать EXIF, ICC и XMP; параметры кодирования SHALL быть документированы (`crop` — JPEG `quality` 85, `optimized` — WebP с потерями `quality` 80, `method` 4). Метаданные каждого варианта (`content_type`, `size_bytes`, `width`, `height`, `sha256`) SHALL совпадать с байтами, которые отдаёт `/content?variant=<имя>`.
|
||||
|
||||
#### Scenario: Fixture 320×200
|
||||
|
||||
- **WHEN** обработана `tests/fixtures/sample.png`
|
||||
- **THEN** у вложения варианты `crop` 128×128 `image/jpeg`, `optimized` 320×200 `image/webp` и `thumbnail` 256×160, каждый `/content?variant=<имя>` отдаёт настоящий файл этого формата длиной `size_bytes` с SHA-256 из метаданных и реальными размерами из метаданных
|
||||
|
||||
#### Scenario: Большой и вытянутый исходник
|
||||
|
||||
- **WHEN** обработаны JPEG 4000×3000 и PNG 3000×2
|
||||
- **THEN** `optimized` 1280×960 и 1280×1 соответственно, `crop` в обоих случаях 128×128
|
||||
|
||||
#### Scenario: Ориентация и прозрачность
|
||||
|
||||
- **WHEN** обработаны JPEG 400×200 с EXIF orientation 6 и PNG RGBA с прозрачным фоном
|
||||
- **THEN** `optimized` первого 200×400, прозрачные области `crop` и `optimized` второго белые, ни в одном варианте нет EXIF
|
||||
|
||||
#### Scenario: Прозрачность tRNS без альфа-канала
|
||||
|
||||
- **WHEN** загружен допустимый PNG RGB, L, 1-битный или 16-битный grayscale с tRNS
|
||||
- **THEN** прозрачные пиксели `thumbnail`, `crop` и `optimized` белые, непрозрачные сохраняют цвет с учётом кодирования; соседнее непрозрачное значение 16-битного grayscale не становится прозрачным при округлении до 8 бит
|
||||
|
||||
#### Scenario: Исходная глубина tRNS
|
||||
|
||||
- **WHEN** обрабатываются допустимые PNG grayscale 2/4 бита с ненулевым tRNS или RGB16 с tRNS, включая фильтры 0–4, Adam7 и EXIF orientation
|
||||
- **THEN** во всех вариантах v1/v2 прозрачные области белые, а пиксели, отличающиеся от tRNS только младшим битом любого канала RGB16, остаются непрозрачными; ориентация, размеры и цвета соответствуют исходнику с явно наложенной на белый фон прозрачностью
|
||||
|
||||
### Requirement: Пределы обработки изображения в worker
|
||||
|
||||
Worker SHALL ограничивать обработку одного задания: размер оригинала — `MAX_UPLOAD_BYTES`, число пикселей по заголовку до декодирования — `MAX_IMAGE_PIXELS`, время рендера — `RENDER_TIMEOUT_SECONDS`, адресное пространство процесса рендера — `RENDER_MEMORY_MB`; рендер SHALL выполняться в отдельном процессе, число одновременных рендеров SHALL не превышать `WORKER_CONCURRENCY`, а процесс worker SHALL иметь предел памяти контейнера не меньше суммы пределов рендеров и собственной памяти. Превышение предела SHALL переводить вложение в `failed` с `processing_failed` без повторов; процесс, превысивший время, SHALL принудительно завершаться. Падение процесса рендера по внешней причине SHALL считаться временной ошибкой. Worker SHALL продолжать обрабатывать другие задания после любого из этих исходов.
|
||||
|
||||
#### Scenario: Рендер дольше предела
|
||||
|
||||
- **WHEN** worker запущен с `RENDER_TIMEOUT_SECONDS` меньше времени рендера загруженного изображения
|
||||
- **THEN** вложение становится `failed` с `processing_failed` после первой попытки, процесс worker продолжает работать, следующая загрузка становится `ready`
|
||||
|
||||
#### Scenario: Рендер больше предела памяти
|
||||
|
||||
- **WHEN** worker запущен с `RENDER_MEMORY_MB` меньше пика рендера изображения 40 Мпикс
|
||||
- **THEN** вложение становится `failed` с `processing_failed`, процесс worker продолжает работать
|
||||
|
||||
#### Scenario: Изображение на пределе пикселей
|
||||
|
||||
- **WHEN** со штатными пределами загружен PNG 8000×5000
|
||||
- **THEN** вложение становится `ready` с тремя вариантами, пик памяти контейнера worker ниже его предела
|
||||
|
||||
#### Scenario: Прозрачный PNG на пределе пикселей
|
||||
|
||||
- **WHEN** последовательно обработаны PNG 8000×5000 grayscale 2/4/16 и RGB16 с tRNS при штатных 448 MiB адресного пространства рендера и 30 с на задание, затем запрошена версия pipeline 2
|
||||
- **THEN** каждый upload отвечает `202 queued`, обе версии становятся `ready` с тремя вариантами и неизменным оригиналом; прозрачные области белые, соседний непрозрачный цвет сохраняется, worker остаётся работоспособным и обрабатывает следующее обычное задание
|
||||
|
||||
#### Scenario: Пиксели сверх предела по заголовку
|
||||
|
||||
- **WHEN** worker получает задание на оригинал, у которого по заголовку больше `MAX_IMAGE_PIXELS` пикселей
|
||||
- **THEN** изображение не декодируется, вложение становится `failed` с `invalid_image`
|
||||
@@ -0,0 +1,20 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Брокер и отдельные процессы в стенде
|
||||
|
||||
Стенд SHALL содержать сервисы `broker` (RabbitMQ с volume и фиксированным именем узла), `relay` и `worker`, запускаемые из того же образа, что и API, но отдельными процессами. Очередь заданий SHALL быть durable quorum-очередью с dead-letter exchange. Повторные доставки при инфраструктурной ошибке до фиксации результата SHALL NOT исчерпываться транспортным лимитом; обработка задания SHALL оставаться ограниченной `JOB_MAX_ATTEMPTS` согласно уровню «3» `README.md`. Наружу SHALL публиковаться только UI брокера на `127.0.0.1`; AMQP, relay и worker портов на хосте не имеют. API SHALL NOT иметь учётных данных брокера.
|
||||
|
||||
#### Scenario: Топология
|
||||
|
||||
- **WHEN** выполняется `rabbitmqctl list_queues -p messenger name type durable` и `list_consumers -p messenger`
|
||||
- **THEN** `attachments.process` и `attachments.process.dlq` — `quorum`, durable; у `attachments.process` один consumer worker с `prefetch_count` равным `WORKER_CONCURRENCY`
|
||||
|
||||
#### Scenario: Сервисы
|
||||
|
||||
- **WHEN** выполняется `docker compose ps` после `make up`
|
||||
- **THEN** `broker`, `relay`, `worker` в состоянии `healthy`, процессы не от root, опубликованы только порты `lb` и UI брокера на `127.0.0.1`
|
||||
|
||||
#### Scenario: БД недоступна дольше десяти доставок
|
||||
|
||||
- **WHEN** принятое задание опубликовано, а PostgreSQL недоступен при захвате более десяти повторных доставок
|
||||
- **THEN** сообщение остаётся доступным в рабочей очереди с теми же `job_id` и `attempt`, DLQ не пополняется из-за этого отказа; после восстановления БД вложение становится `ready` без replay, с одним набором вариантов
|
||||
@@ -0,0 +1,20 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Реестр failed и явный replay
|
||||
|
||||
Задания в `failed` SHALL быть доступны оператору списком с `attachment_id`, `job_id`, `error_code`, `attempt`, классом последней ошибки и временем. Команда `python -m messenger.admin replay --attachment-id <id>` SHALL переводить вложение `failed` в `queued` тем же `job_id` с `attempt` 1 и новой публикацией, записывая в журнал задания событие `replayed` с оператором; для вложения в `ready`, `queued` или `processing` SHALL отвечать `noop` и записывать `replay_noop`, не создавая работы; для `failed`, чей staging уже удалён по retention, — `expired`. Последняя строка вывода команды SHALL быть JSON с полем `result`. Сообщения не по схеме SHALL попадать в dead-letter очередь, которую оператор просматривает без извлечения. Недоступность БД SHALL NOT отправлять принятое задание в DLQ по числу доставок; ограничение попыток обработки и реестр failed SHALL сохраняться согласно уровню «3»/«4» `README.md`.
|
||||
|
||||
#### Scenario: Replay после retry_exhausted
|
||||
|
||||
- **WHEN** вложение `failed` с `retry_exhausted`, оператор выполняет replay
|
||||
- **THEN** вывод `{"result": "replayed", ...}`, вложение становится `ready`, `attempt` не превышает `JOB_MAX_ATTEMPTS`, в журнале есть `replayed`
|
||||
|
||||
#### Scenario: Replay готового вложения
|
||||
|
||||
- **WHEN** оператор повторяет replay уже `ready`-вложения
|
||||
- **THEN** вывод `{"result": "noop", ...}`, в очередь ничего не публикуется, метаданные и строки вариантов не меняются
|
||||
|
||||
#### Scenario: Реестр
|
||||
|
||||
- **WHEN** оператор выполняет `python -m messenger.admin failed`
|
||||
- **THEN** вывод — JSON-список `failed`-заданий без текста исключений, ключей S3 и учётных данных
|
||||
@@ -0,0 +1,15 @@
|
||||
## 1. Наследуемый уровень 3
|
||||
- [ ] 1.1 Перенести identity validation/cache и regression tests; проверить cache races и logout failures.
|
||||
- [ ] 1.2 Перенести messaging NUL validation и regression tests.
|
||||
- [ ] 1.3 Перенести PNG validation/transparency/memory и тесты, с локальными fixtures.
|
||||
- [ ] 1.4 Перенести HAProxy/RabbitMQ, сохранив OTel; адаптировать вспомогательные проверки к ЛР6.
|
||||
- [ ] 1.5 Выполнить make check/validate/lint/student-test; создать коммит runtime.
|
||||
## 2. Затронутые гарантии уровня 4
|
||||
- [ ] 2.1 Реальный стенд: network, HAProxy errors, cache outage, PostgreSQL requeue более 10 раз.
|
||||
- [ ] 2.2 PNG HTTP, 40MP и concurrent worker, forced limits/recovery; smoke/persistence/failover.
|
||||
- [ ] 2.3 Проверить конфиги, API/job/retry traces, логи без утечек и alerts после переноса.
|
||||
## 3. Трек 5 и завершение
|
||||
- [ ] 3.1 Повторить 15 затронутых cost-series последовательно; сохранить фон, SHA и сырые результаты.
|
||||
- [ ] 3.2 Свести результаты/графики, ограничения и полный source inventory в evidence/forward-port.md.
|
||||
- [ ] 3.3 Восстановить штатные настройки, выполнить финальные проверки и остановить собственный стенд без удаления volumes.
|
||||
- [ ] 3.4 Синхронизировать specs, архивировать change и закоммитить после make lint; чистое дерево.
|
||||
Reference in New Issue
Block a user