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

31 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Лабораторная 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:
```sh
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](../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.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; реальный вывод smoke приведён выше, результаты зафиксированы в evidence.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.