Files
mtusi2026lab4/.github/pull_request_template.md
T

3.4 KiB
Raw Blame History

Лабораторная 4

Автор / группа: Лесковский Сергей БПИ2304 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено: весь обязательный минимум lab3 (users/chats/messages/sessions/idempotency, PostgreSQL, Basic→Bearer, ≥2 API-реплики за nginx, Idempotency-Key, X-Instance-Id) сохранён. Добавлено: S3-совместимое хранилище (MinIO) в общем стенде, приватный bucket, POST вложения (201 ready) с проверкой MIME по содержимому и лимитами ≤10 MiB / ≤40 Мп, безопасный filename, авторизованный download через API без redirect, attachment_ids в сообщениях, ACL (посторонний → 404), checksum sha256 оригинала.

Команды запуска из чистого clone: см. REPORT.md, раздел «Запуск из чистого clone». Кратко:

  • секреты в secrets/*.txt и .env генерируются локально PowerShell-блоком из REPORT.md;
  • docker compose --env-file .env build api1 && docker compose --env-file .env up -d;
  • $env:PYTHONUTF8 = "1"; python tests\smoke.py --base-url http://localhost:8080;
  • persistence: python tests\resilience.py --mode persistence --action-script scripts\restart_local.cmd --base-url http://localhost:8080;
  • failover: python tests\resilience_local.py --mode failover --action-script scripts\stop-one_local.cmd --base-url http://localhost:8080.

Результаты проверок и ссылка на REPORT.md: smoke PASS; persistence PASS; failover PASS (81 запись, 0 ошибок, recovery 2.17 s). Подробности — в REPORT.md, файлы evidence/smoke.txt, evidence/persistence.txt, evidence/failover.txt.

Ограничения / известные ошибки: create_all вместо Alembic; компенсация orphan в S3 — best-effort; API использует root-креды MinIO (уровень 4 — отдельная политика); нагрузочные эксперименты уровня 4 не проводились; на Windows .sh запускаются через .cmd-обёртки и Git Bash, для failover использована копия tests/resilience_local.py с timeout=10 (исходный tests/resilience.py не менялся).

Источники и использование ИИ: официальная документация FastAPI, SQLAlchemy 2.x, boto3, MinIO, PostgreSQL.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.