Files
mtusi2026lab4/.github/pull_request_template.md

3.9 KiB

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

Автор / группа: Долда Кирилл / БПИ2301 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: Трек 2

Что реализовано и что перенесено:

Из lab3 перенесены PostgreSQL, Redis, Alembic, Bearer-токены, реплики, Idempotency-Key, лимиты CPU/RAM, X-Instance-Id.

Добавлены MinIO с приватным bucket, таблица attachments, поле attachment_ids в сообщениях, загрузка и скачивание файлов через API, проверки MIME, пикселей и размера, S3-пользователь api-user с ограниченными правами (не admin), reconciler для orphan и missing, тесты вложений, RAM-эксперимент, stream-limit, тесты grace period и используемых вложений.

Команды запуска из чистого clone:

1. Подготовка cp .env.example .env

2. Сборка и запуск docker compose up -d --build docker compose restart nginx

3. Ожидание готовности until curl -sf http://localhost:8080/health/ready

4. Миграции (однократно, до трафика) docker compose exec -w /app app1 alembic upgrade head

Bootstrap S3 проверка: docker compose exec minio sh -c 'mc alias set myminio http://localhost:9000 minioadmin minioadmin > /dev/null && mc admin user list myminio'

Ожидаемо: api-user, minioadmin

5. Остановка контейнера docker compose down

Результаты проверок и ссылка на REPORT.md:

  • make test — PASS: lab4 public API scenario.

  • make test-attachments — PASS (5/5)

  • make stream-limit — PASS: 100 МБ -> 413 за 0.10s, память не растёт.

  • make ram-experiment — 10/10 (201), avg 6.37 МБ, пик памяти app1 ~290 МБ / 512 МБ, OOM нет.

  • make reconcile-test — PASS: [ORPHAN] + [MISSING] в dry-run -> [DELETED] в execute -> повторный dry-run 0/0 (идемпотентность).

  • make grace-period-test — PASS: [SKIP] (1 сек < grace 10) -> [ORPHAN] (12 сек > grace 10) -> [DELETED].

  • make used-attachment-test — PASS

  • make reconcile-cost — 50 файлов / 1.012s (~2 мс/файл, линейная O(N)).

  • make private-bucket — 403 AccessDenied (bucket приватный).

  • make s3-user-check — api-user не admin: mc admin user add / mc admin policy attach / mc admin user remove -> Access Denied.

Ограничения / известные ошибки:

  • Grace period в тестах — 10 секунд (в проде — 1 час: защита от удаления свежих загрузок, которые могут быть в процессе).
  • Стоимость reconciler — 50 файлов / 1.012s (~2 мс/файл).

Источники и использование ИИ:

FastAPI, SQLAlchemy, asyncpg, Alembic, passlib[bcrypt], redis, psycopg2-binary, minio, filetype, Pillow, python-multipart, pytest, nginx:alpine, postgres:16-alpine, redis:7-alpine, pgsty/silo:latest

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