forked from mtusi2026/mtusi2026lab4
31 lines
4.0 KiB
Markdown
31 lines
4.0 KiB
Markdown
## Лабораторная 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 содержит инструкцию именно моего решения.
|