## Лабораторная 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`](../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 - [x] Контракт и публичные tests не ослаблялись ради прохождения. - [x] Сценарии отказов и безопасности уровня 4/5 воспроизведены; результаты приложены в `evidence/`. - [x] Локальные секреты исключены из Git через `.gitignore`; `.env` не должен добавляться в PR. - [x] Исходный README задания сохранён, инструкция конкретной реализации находится в `REPORT.md`. - [ ] Чистый запуск из clone и повторный `make test` после последних изменений подтверждены. - [ ] `make validate` выполнен с `requirements-dev.txt`; приложен вывод.