Files
mtusi2026lab4/.github/pull_request_template.md
T

4.7 KiB
Raw Blame History

Лабораторная 4 — S3-хранилище и вложения

Автор / группа: Перевалова Виктория, БПИ2302

Целевая оценка: 5

Трек: Track 1 — Presigned Upload

Что реализовано

  • Перенесена основа предыдущей лабораторной; сохранены публичные API-сценарии и контракт.
  • Реализованы Proxy Upload и Presigned Upload с проверкой членства в чате, уникальными ключами, TTL, проверкой размера, SHA-256 и фактического формата изображения при complete.
  • Метаданные хранятся в PostgreSQL, бинарные данные — в приватном S3-compatible bucket.
  • Добавлены cleanup незавершённых presigned-загрузок, best-effort компенсация при ошибке записи метаданных, ограниченные S3 credentials и bootstrap bucket.
  • Стенд включает PostgreSQL, Redis, S3-compatible storage, миграции, Traefik и две API-реплики.

Запуск

См. REPORT.md, раздел «Запуск из чистого clone». Для локального Compose используется .env.compose.example; после копирования в .env необходимо заменить демонстрационные значения.

Проверки и доказательства

  • scripts/check_contract.py — PASS.
  • Python compileall — PASS.
  • Публичный smoke — PASS: повторно выполнен после исправления маршрутизации Traefik; результат сохранён в evidence/smoke.txt.
  • Presigned upload, completion, idempotency и download — PASS.
  • Все негативные сценарии Presigned Upload — PASS (409/415/413/404 согласно проверяемому сценарию).
  • Негативные сценарии, cleanup, компенсация S3/PostgreSQL, S3 unavailable/security, persistence, attachment failover и нагрузочные эксперименты описаны в REPORT.md; сводки находятся в evidence/.
  • Эксперимент Track 1 подтвердил сокращение тела запроса к API до 159 байт для файла 5,5 MiB; снижение RAM не подтверждено и не заявляется.

Ограничения и отклонения

  • Между PostgreSQL и S3 нет общей распределённой транзакции; компенсация Proxy Upload best-effort. Незарегистрированные orphan-объекты требуют отдельной сверки/lifecycle policy.
  • Пиковая RAM измерялась через периодический docker stats; короткие пики могли быть пропущены.
  • В Compose используется Silo с S3 API, хотя задание буквально перечисляет MinIO, SeaweedFS или RustFS. Это отклонение явно раскрыто в REPORT.md; требуется согласование с преподавателем.

Источники и использование ИИ

Использованы исходный skeleton, контракт, документация зависимостей и материалы лабораторной. ChatGPT применялся для анализа требований, диагностики, подготовки отдельных тестов и редактирования документации. Результаты проверялись локальным запуском и тестами; ИИ не заменял выполнение проверок.

Checklist

  • Контракт и публичные tests не ослаблялись ради прохождения.
  • Сценарии отказов и безопасности уровня 4/5 воспроизведены; результаты приложены в evidence/.
  • Локальные секреты исключены из Git через .gitignore; .env не должен добавляться в PR.
  • Исходный README задания сохранён, инструкция конкретной реализации находится в REPORT.md.
  • Чистый запуск из clone и повторный make test после последних изменений подтверждены.
  • make validate выполнен с requirements-dev.txt; приложен вывод.