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

3.4 KiB
Raw Blame History

Лабораторная 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:

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.
  • 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 (реализация, отладка, отчёт).

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.

  • Контракт и публичные тесты не ослаблены.

  • make check и make test выполнены; приложен реальный вывод.

  • Сценарии отказов/безопасности своего уровня воспроизведены.

  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.

  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.