Files
mtusi2026lab4/openspec/changes/fix-upload-put-flake/specs/attachments/spec.md
T
2026-10-22 22:52:59 +03:00

2.8 KiB
Raw Blame History

Spec Delta

MODIFIED Requirements

Requirement: Недоступность S3

Если S3 недоступен, не ответил за срок вызова или отказал (object-storage), загрузка и скачивание байтов SHALL отвечать 503 unavailable в формате ошибки. Ответ SHALL приходить не позже срока вызова S3 с запасом, а не 500 и не зависанием. Без S3 SHALL работать:

  • метаданные вложения;
  • история чата с attachment_ids;
  • отправка сообщений, в том числе со ссылкой на готовое вложение;
  • /health/ready.

После возврата S3 загрузка и скачивание SHALL проходить без перезапуска API.

503 на загрузке и скачивании SHALL означать только такой отказ S3: недоступен, не ответил за срок или отказал. Доступный S3 MUST NOT давать 503 из-за того, что реплика какое-то время не обращалась к нему, в том числе после скачивания больших оригиналов.

Scenario: S3 остановлен

  • WHEN вложение загружено, затем S3 остановлен, и участник скачивает байты, читает метаданные, отправляет сообщение с этим вложением и запрашивает /health/ready
  • THEN скачивание — 503 unavailable, метаданные — 200, сообщение — 201, готовность — 200
  • AND после возврата S3 скачивание — 200 с теми же байтами

Scenario: S3 завис

  • WHEN контейнер S3 заморожен (docker pause), и участник загружает файл и скачивает байты готового вложения
  • THEN оба ответа 503 unavailable не позже срока вызова S3 с запасом, а после разморозки скачивание — 200

Scenario: Загрузка после простоя S3

  • WHEN участники одновременно скачали оригинал в несколько MiB, затем реплика дольше срока вызова S3 не обращалась к S3, а S3 всё это время доступен, и участник одну за другой загружает файлы
  • THEN каждая загрузка — 201, ни одной 503
  • AND скачанные байты совпадают с загруженными