Files
mtusi2026lab5/openspec/changes/verify-lab5-grade4-sqlalchemy/design.md
T

2.2 KiB
Raw Blame History

Context

Уровень 3 подтверждён в 47ffb2d. Вложения, задания, outbox и эффекты используют SQLAlchemy2 async; Alembic head 0006. PostgreSQL хранит состояния, S3 — объекты, RabbitMQ — транспорт.

Goals / Non-Goals

Проверить crop/optimized, лимиты, COMMIT→publish, S3→COMMIT→ack, retry/DLQ/replay, fencing и staging cleanup. Не менять готовую реализацию без доказанного major и не исправлять minor limits.py.

Decisions

  • Тот же project mtusi2026lab5 и volumes, API 18085, stats/UI 25085/25086. Только последовательные проверки.
  • Suite использует fault overlay с lease=5 s, backoff base=1 s, sweep=1 s; production defaults отдельно фиксируются в заметках. Это ускоряет воспроизводимость, не является замером latency production.
  • У каждого crash сохранить docker compose ps -a до восстановления, exit=137 и состояние PostgreSQL. COMMIT outbox предшествует publish; подтверждённая публикация предшествует mark published. Consumer ack следует COMMIT результата.
  • Реальное изображение 8000×5000 проверяется при timeout=0.5 s и memory=200 MiB, затем при штатных 30 s/448 MiB. Cgroup worker 1024 MiB; штатный prefetch/concurrency=2.
  • Качество v1: JPEG 85 optimize, WebP 80 method 4; EXIF orientation до resize, alpha на белом, метаданные не передаются encoder. Thumbnail вписан без увеличения, crop 128×128, optimized вписан в 1280×1280.

Risks / Trade-offs

Ошибки диагностики сохраняются с ненулевым exit code. DLQ имеет исходные сообщения; проверяется приращение, volumes не очищаются. Сбои исполняются только на собственном стенде. Миграции и схема не меняются.