forked from mtusi2026/mtusi2026lab4
4.7 KiB
4.7 KiB
Лабораторная 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; приложен вывод.