Files
mtusi2026lab4/.github/pull_request_template.md
T
2026-11-06 17:28:41 +03:00

4.0 KiB
Raw Blame History

Лабораторная 4

Автор / группа: Дыханова Алина, БВТ2301 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: трек 2 — согласованность PostgreSQL/S3

Что реализовано и что перенесено: Добавлены синхронная загрузка PNG/JPEG в приватный RustFS (S3), авторизованное скачивание, проверка типа/размера/числа пикселей и метаданные вложений в PostgreSQL с привязкой к сообщениям. Перенесены возможности lab3: регистрация и Argon2id-аутентификация, сессии, чаты, keyset-пагинация и идемпотентность сообщений. Добавлены Compose-инфраструктура с двумя API-репликами, HAProxy, persistent volumes, отдельные ограниченные S3 credentials и reconciler для orphan/missing объектов с dry-run, grace period и повторной проверкой перед удалением.

Команды запуска из чистого clone:

python3 scripts/bootstrap.py
docker compose config --quiet
docker compose up -d --build --scale api=2 --wait --wait-timeout 180
make check
make test
python3 tests/attachments_negative.py

Результаты проверок и ссылка на REPORT.md: make check — PASS; make test — PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.; python3 tests/attachments_negative.py — PASS (PNG/JPEG, лимиты, повреждённое изображение, подмена MIME, чужой доступ и cross-chat). Также PASS: persistence, API failover, S3 outage, private bucket, 10-way upload load и track 2 reconciliation experiment. Подробные методика, результаты и ограничения: REPORT.md. Реальные результаты сохранены в evidence/runtime-checks.json, evidence/upload-load.json, evidence/reconcile-experiment.json и evidence/reconcile-inventory.json.

Ограничения / известные ошибки: Нагрузочные результаты получены на локальном Docker Desktop; Docker stats опрашивался примерно раз в секунду, поэтому краткий пик памяти мог быть пропущен. Между PostgreSQL и S3 нет общей транзакции; обычные ошибки компенсируются удалением объекта, аварийные расхождения исправляет reconciler. UI и presigned upload не входят в обязательный контракт и не реализованы.

Источники и использование ИИ: Задание и контракт этого репозитория (readme.md, contracts/openapi.json, contracts/README.md, тесты и карта курса); официальная документация используемых библиотек и RustFS. При разработке и проверке использовался Codex.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; реальный вывод smoke приведён выше, результаты зафиксированы в evidence.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.