Files
mtusi2026lab5/openspec/changes/track1-queue-overload/specs/attachments/spec.md
T
2026-11-01 05:28:05 +03:00

2.6 KiB
Raw Blame History

MODIFIED Requirements

Requirement: Порядок проверок загрузки

Если у загрузки несколько ошибок, ответ SHALL определяться первой из них по порядку:

  1. 401 — нет действительной сессии;
  2. 400 — неверный chat_id или filename;
  3. 404 — чата нет или пользователь в нём не состоит;
  4. 415 — Content-Type запроса;
  5. 413 — Content-Length запроса;
  6. 429 — незавершённых заданий не меньше предела (queue-overload, «Предел незавершённых заданий»);
  7. 429 — нет места для загрузки (требование «Одновременные загрузки реплики»);
  8. тело: 413 — прочитано больше лимита; 400 — тело не пришло за срок (требование «Срок передачи тела») или клиент оборвал передачу;
  9. 415 или 413 — содержимое: формат и целостность или число пикселей.

Тело MUST NOT читаться, пока не пройдены проверки 1–7. Загрузка, отклонённая на проверках 1–6, MUST NOT ждать места и занимать его. Ошибка клиента MUST NOT давать 500.

Scenario: Посторонний с большим файлом

  • WHEN Ева загружает 30 MiB в чат Алисы и Боба
  • THEN ответ 404 not_found, а не 413

Scenario: Без сессии с опасным именем

  • WHEN загрузка без Authorization идёт с filename a/b.png, а затем с допустимым именем
  • THEN оба ответа 401 unauthorized с WWW-Authenticate: Bearer

Scenario: Неверный тип и большой размер

  • WHEN участник загружает 30 MiB с Content-Type: text/plain
  • THEN ответ 415 unsupported_media_type

Scenario: Отказ раньше очереди

  • WHEN все места загрузки процесса заняты и очередь ожидания полна, и посторонний загружает файл в чат, участник загружает 30 MiB с Content-Length 31 457 280, а затем PNG с Content-Type: text/plain
  • THEN ответы 404, 413 и 415 приходят сразу, без ожидания места, а не 429