Files
mtusi2026lab4/.github/pull_request_template.md

61 lines
4.7 KiB
Markdown
Raw Permalink 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
Заголовок PR: **ЛР 4 — БПИ2301 — Черненко — на 5**
Ветка решения: `solution/bpi2301-chernenko`, база: исходный `main` skeleton (`ec540a1`).
Автор / группа: Черненко / БПИ2301.
Целевая оценка: **5**.
Трек: **2 — согласованность двух хранилищ**.
Реализован синхронный proxy upload PNG/JPEG в приватный MinIO, метаданные и ACL
в PostgreSQL, авторизованный побайтный download, сообщения с вложениями,
две FastAPI-реплики и HAProxy с readiness. Минимум lab1–3 написан по контракту
текущего skeleton: Argon2id/Bearer-сессии, PostgreSQL persistence, чаты,
keyset pagination, атомарная идемпотентность сообщений между репликами.
Предыдущее личное решение не предоставлялось, чужое решение не переносилось.
Reconciler поддерживает dry-run/apply, grace period, orphan/missing,
повторный безопасный запуск и восстановление из проверенной копии. Shared/exclusive
DB advisory locks согласуют сверку с загрузкой и привязкой. Исследование внедряет
ошибку SQL после реального PUT, удаление оригинала и неправильный backup.
Запуск из clone (Linux/macOS, Windows: `py -X utf8` вместо `python3`):
```sh
python3 scripts/setup.py
docker compose --env-file .env config --quiet
docker compose up -d --build --wait --wait-timeout 180
docker compose exec -T api1 make check validate PYTHON=python
docker compose exec -T api1 make test PYTHON=python BASE_URL=http://lb:8080
python3 scripts/run-all.py
```
При занятом 8080 задать `HOST_PORT=18084` в `.env`. Испытания проведены на 18084.
Первая сборка компилирует фиксированные официальные tags MinIO/mc, поскольку
готовые registry images были недоступны.
Проверки: полный прогон PASS, [REPORT.md](../REPORT.md),
[численные итоги](../evidence/SUMMARY.md), [памятка к защите](../DEFENSE.md).
Smoke, негативные сценарии, persistence всех хранилищ, failover каждой API,
отказы S3/PostgreSQL и сверка прошли. Публичный failover: 2,449 с до восстановления,
86 успешных записей, 1 переходная ошибка, без потерь и дублей.
60 измеряемых загрузок при concurrency=10 и двух размерах: 0 ошибок;
наблюдённые cgroup-пики обеих API ≈149/176 MiB при лимите 512 MiB.
Сверка 1085 объектов: 2 LIST, 0,136 с (один локальный проход, не production SLA).
Ограничения: один host и одиночные PostgreSQL/MinIO/LB; HTTP только локально;
ручной запуск сверки и необходимость backup при потере байтов. Сверка O(A+O)
держит exclusive DB lock на время прохода. Подробные ограничения измерений,
конкурентной пагинации и границ безопасности раскрыты в отчёте.
Источники и ИИ: нормативный skeleton, официальные Psycopg/MinIO/Pillow/S3 docs;
реализация и документация подготовлены с помощью Codex, реальные команды и
обезличенные результаты сохранены в `evidence/`. Обязательные файлы задания сохранены.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.