Files
mtusi2026lab4/.github/pull_request_template.md
2026-10-30 21:09:56 +03:00

47 lines
3.4 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
Автор / группа: Никитин Андрей Александрович / БВТ2301
Целевая оценка (3/4/5): **5**
Трек 5, если заявлен: **трек 1 — прямой (presigned) upload**
Что реализовано и что перенесено:
- Lab3 → lab4: пользователи/чаты/сообщения, Redis-сессии, Idempotency-Key, LB ×2 API, graceful drain.
- Оценка 4: private MinIO, limited S3 creds, proxy `POST /attachments` (magic + stb_image), компенсация Put→PG / DeleteObject, `gc_orphans`, persistence/failover hooks, лимит concurrent uploads (RSS).
- Оценка 5 / трек 1: `direct_uploads` + presigned PUT (`minio-cpp` SigV4), complete (size/sha256/image), abort, GC незавершённых; proxy endpoint сохранён; сравнение RAM/трафика proxy vs direct (≥2 размера).
Команды запуска из чистого clone:
```sh
cp .env.example .env # локальные POSTGRES_*/MINIO_*/S3_BUCKET
mkdir -p secrets && # database_url, cache_url, s3_* (см. REPORT.md)
docker compose --env-file .env up -d --build
curl -fsS http://127.0.0.1:8080/health/ready
make check && make test BASE_URL=http://127.0.0.1:8080
sh student-tests/run_grade3.sh
sh student-tests/run_grade4.sh
sh student-tests/run_grade5_track1.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
```
Результаты проверок и ссылка на REPORT.md:
- Подробности, таблицы доказательств и эксперимент трека 1: [`REPORT.md`](../REPORT.md).
- Student-tests grade3/4/5 track1 — PASS на локальном стенде.
- Evidence: `evidence/load_uploads.json`, `evidence/resilience_grade4.txt`, `artifacts/track1/results.tsv`.
- Ветка решения: `solution/nikitin-bvt2301`.
Ограничения / известные ошибки:
- Без `compose.presign.yaml` PUT к MinIO — с контейнера на сети compose (порты 9000/9001 на хост не публикуются).
- Complete direct-upload кратковременно GetObject'ит объект для verify (фаза отдельно от transfer).
- Нет HA БД/MinIO; нет thumbnail/вариантов (lab5); openapi расширений трека 1 нет (факультативный API).
Источники и использование ИИ:
- Контракт/тесты курса; PostgreSQL 16, Valkey, Nginx, MinIO, libpqxx 7.10.0, libsodium, hiredis, nlohmann/json, minio-cpp v0.3.0, stb_image.
- Помощь ИИ: Cursor (реализация, отладка, отчёт).
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.