ЛР 2 - БПИ2302 - Максимова - на 5 #9

Closed
kleprer wants to merge 15 commits from kleprer/mtusi2026lab2:solution/БПИ2302-Максимова into master
First-time contributor

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

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

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

Реализовано:

  • Асинхронный REST API на FastAPI.
  • PostgreSQL через SQLAlchemy 2.0 (async) + asyncpg.
  • Миграции Alembic.
  • Redis для кеша и rate limiting.
  • bcrypt для паролей.
  • Pydantic 2 для схем.
  • Dockerfile, запуск от non-root.
  • Тесты: smoke, resilience (persistence), concurrent.
  • Бенчмарк Track A (scripts/track_a_bench.py).

Перенесено из предыдущей работы:

  • Базовая структура и CRUD-контракт.
  • Публичные тесты (не ослаблены).
  • README и конфигурация.

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

git clone https://gitea.privcloud.tech/kleprer/mtusi2026lab2 && cd mtusi2026lab2
git checkout solution/БПИ2302-Максимова
cp .env.example .env          # Windows: copy .env.example .env
docker compose --env-file .env up -d --build
curl -s http://localhost:8080/health/ready   # Windows: curl.exe -s ...

Дополнительные проверки (после старта контейнеров):

python tests/smoke.py
python tests/resilience.py --mode persistence
python student-tests/concurrent_test.py
python -m pytest student-tests/
docker inspect --format='{{.Config.User}}' mtusi2026lab2-api-1
python scripts/track_a_bench.py

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

  • docker compose up — успешно, все сервисы подняты.
  • curl http://localhost:8080/health/ready — {"status":"ok"}.
  • tests/smoke.py — успешно.
  • tests/resilience.py --mode persistence — успешно.
  • student-tests/concurrent_test.py — успешно.
  • pytest student-tests/ — <N> passed.
  • docker inspect --format='{{.Config.User}}' mtusi2026lab2-api-1 — appuser (не root).
  • python scripts/track_a_bench.py --output bench_results.json — результаты в REPORT.md.

Ссылка: REPORT.md

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

  1. 503 от POST-запросов при тестах с хоста.
    Часть POST-запросов из pytest на хосте возвращала 503 с пустым телом, не доходя до uvicorn. При запуске тестов внутри сети docker compose проблема не воспроизводится. Вероятная причина — сервис не успевал подняться или был недоступен по host-адресу до прохождения healthcheck. Workaround: запускать pytest внутри контейнера (docker compose exec api ...) или дождаться health/ready перед тестами.

  2. Ограничения concurrent-тестов.
    student-tests/concurrent_test.py проверяет корректность при параллельных запросах, но не покрывает сетевые сбои, таймауты и падение БД. Сценарии отказов ограничены tests/resilience.py --mode persistence.

  3. Кроссплатформенность.
    Команды в README и PR написаны для Linux/macOS. На Windows нужно использовать py -3 вместо python3, copy вместо cp, curl.exe вместо curl, а также синтаксис переменных конкретной оболочки ($env:VAR в PowerShell, %VAR% в cmd). В PowerShell curl — это алиас для Invoke-WebRequest, поэтому нужен именно curl.exe.

  4. Не реализовано / вне скоупа.
    Refresh-токены, горизонтальное масштабирование, шардирование, мониторинг (Prometheus/Grafana), CI/CD — вне задачи.

  5. Известные баги.
    При высокой конкурентности (сотни одновременных POST) растёт p99 задержки из-за ограничений пула соединений к PostgreSQL. Пул настраивается переменными окружения SQLAlchemy. На Windows-контейнерах docker inspect может возвращать пустое .Config.User, если пользователь не задан явно; в этом проекте контейнер Linux, поле заполнено (appuser).

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

FastAPI 0.110.0, SQLAlchemy 2.0.29 (async), asyncpg 0.29.0, Alembic 1.13.1, bcrypt 4.1.2, redis-py 5.0.3, Pydantic 2.6.4. ИИ использовался для черновика кода, финальный код проверен вручную.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Максимова Снежана Игоревна / БПИ2302 Целевая оценка (3/4/5): 5 Трек A, если заявлен: A ### Что реализовано и что перенесено **Реализовано:** - Асинхронный REST API на FastAPI. - PostgreSQL через SQLAlchemy 2.0 (async) + asyncpg. - Миграции Alembic. - Redis для кеша и rate limiting. - bcrypt для паролей. - Pydantic 2 для схем. - Dockerfile, запуск от non-root. - Тесты: smoke, resilience (persistence), concurrent. - Бенчмарк Track A (`scripts/track_a_bench.py`). **Перенесено из предыдущей работы:** - Базовая структура и CRUD-контракт. - Публичные тесты (не ослаблены). - README и конфигурация. ### Команды запуска из чистого clone ```bash git clone https://gitea.privcloud.tech/kleprer/mtusi2026lab2 && cd mtusi2026lab2 git checkout solution/БПИ2302-Максимова cp .env.example .env # Windows: copy .env.example .env docker compose --env-file .env up -d --build curl -s http://localhost:8080/health/ready # Windows: curl.exe -s ... ``` Дополнительные проверки (после старта контейнеров): ```bash python tests/smoke.py python tests/resilience.py --mode persistence python student-tests/concurrent_test.py python -m pytest student-tests/ docker inspect --format='{{.Config.User}}' mtusi2026lab2-api-1 python scripts/track_a_bench.py ``` ### Результаты проверок и ссылка на REPORT.md - `docker compose up` — успешно, все сервисы подняты. - `curl http://localhost:8080/health/ready` — `{"status":"ok"}`. - `tests/smoke.py` — успешно. - `tests/resilience.py --mode persistence` — успешно. - `student-tests/concurrent_test.py` — успешно. - `pytest student-tests/` — `<N>` passed. - `docker inspect --format='{{.Config.User}}' mtusi2026lab2-api-1` — `appuser` (не root). - `python scripts/track_a_bench.py --output bench_results.json` — результаты в REPORT.md. Ссылка: [REPORT.md](https://gitea.privcloud.tech/kleprer/mtusi2026lab2/src/branch/solution/БПИ2302-Максимова/REPORT.md) ### Ограничения / известные ошибки 1. **503 от POST-запросов при тестах с хоста.** Часть POST-запросов из `pytest` на хосте возвращала `503` с пустым телом, не доходя до `uvicorn`. При запуске тестов внутри сети `docker compose` проблема не воспроизводится. Вероятная причина — сервис не успевал подняться или был недоступен по host-адресу до прохождения healthcheck. Workaround: запускать `pytest` внутри контейнера (`docker compose exec api ...`) или дождаться `health/ready` перед тестами. 2. **Ограничения concurrent-тестов.** `student-tests/concurrent_test.py` проверяет корректность при параллельных запросах, но не покрывает сетевые сбои, таймауты и падение БД. Сценарии отказов ограничены `tests/resilience.py --mode persistence`. 3. **Кроссплатформенность.** Команды в README и PR написаны для Linux/macOS. На Windows нужно использовать `py -3` вместо `python3`, `copy` вместо `cp`, `curl.exe` вместо `curl`, а также синтаксис переменных конкретной оболочки (`$env:VAR` в PowerShell, `%VAR%` в cmd). В PowerShell `curl` — это алиас для `Invoke-WebRequest`, поэтому нужен именно `curl.exe`. 4. **Не реализовано / вне скоупа.** Refresh-токены, горизонтальное масштабирование, шардирование, мониторинг (Prometheus/Grafana), CI/CD — вне задачи. 5. **Известные баги.** При высокой конкурентности (сотни одновременных POST) растёт `p99` задержки из-за ограничений пула соединений к PostgreSQL. Пул настраивается переменными окружения SQLAlchemy. На Windows-контейнерах `docker inspect` может возвращать пустое `.Config.User`, если пользователь не задан явно; в этом проекте контейнер Linux, поле заполнено (`appuser`). ### Источники и использование ИИ FastAPI 0.110.0, SQLAlchemy 2.0.29 (async), asyncpg 0.29.0, Alembic 1.13.1, bcrypt 4.1.2, redis-py 5.0.3, Pydantic 2.6.4. ИИ использовался для черновика кода, финальный код проверен вручную. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
kleprer added 15 commits 2026-10-03 00:11:41 +03:00
Owner
  • app/main.py:72: допустимый UTF-8 пароль регистрируется, но вход возвращает 401. Разбирайте Basic как UTF-8 по первому двоеточию и возвращайте полный WWW-Authenticate с charset="UTF-8".
  • app/main.py:277: курсор одного чата принимается в другом с 200. Привяжите курсор к чату; при несовпадении возвращайте 400.
  • app/main.py:186: logout без авторизации возвращает 400 вместо 401, неизвестный участник чата — 404 вместо 400. Также отклоняйте непустое тело входа: сейчас оно игнорируется и создаётся сессия.
  • app/auth.py:17: при паузе Redis бизнес-запрос не завершается за 15 секунд, а readiness остаётся 200. Добавьте таймауты и учитывайте критичное хранилище сессий в readiness.
  • REPORT.md:105: EXPLAIN выполнен на 8 837 сообщениях вместо обязательных ≥10 000. Повторите на достаточном наборе и приложите план ANALYZE, BUFFERS.
  • app/main.py:282: HTTP API обходит реализованные helpers кэша. Поэтому результат «301 → 1 SQL» представленным HTTP-путём не подтверждается. Подключите согласованный кэш и воспроизведите конкурентный эксперимент до/после, read-after-write и восстановление Redis.
- [app/main.py:72](https://gitea.privcloud.tech/kleprer/mtusi2026lab2/src/commit/34ea5ab728055ebe178e8f1f7221f614e19ac216/app/main.py#L72): допустимый UTF-8 пароль регистрируется, но вход возвращает 401. Разбирайте Basic как UTF-8 по первому двоеточию и возвращайте полный `WWW-Authenticate` с `charset="UTF-8"`. - [app/main.py:277](https://gitea.privcloud.tech/kleprer/mtusi2026lab2/src/commit/34ea5ab728055ebe178e8f1f7221f614e19ac216/app/main.py#L277): курсор одного чата принимается в другом с 200. Привяжите курсор к чату; при несовпадении возвращайте 400. - [app/main.py:186](https://gitea.privcloud.tech/kleprer/mtusi2026lab2/src/commit/34ea5ab728055ebe178e8f1f7221f614e19ac216/app/main.py#L186): logout без авторизации возвращает 400 вместо 401, неизвестный участник чата — 404 вместо 400. Также отклоняйте непустое тело входа: сейчас оно игнорируется и создаётся сессия. - [app/auth.py:17](https://gitea.privcloud.tech/kleprer/mtusi2026lab2/src/commit/34ea5ab728055ebe178e8f1f7221f614e19ac216/app/auth.py#L17): при паузе Redis бизнес-запрос не завершается за 15 секунд, а readiness остаётся 200. Добавьте таймауты и учитывайте критичное хранилище сессий в readiness. - [REPORT.md:105](https://gitea.privcloud.tech/kleprer/mtusi2026lab2/src/commit/34ea5ab728055ebe178e8f1f7221f614e19ac216/REPORT.md#L105): EXPLAIN выполнен на 8 837 сообщениях вместо обязательных ≥10 000. Повторите на достаточном наборе и приложите план `ANALYZE, BUFFERS`. - [app/main.py:282](https://gitea.privcloud.tech/kleprer/mtusi2026lab2/src/commit/34ea5ab728055ebe178e8f1f7221f614e19ac216/app/main.py#L282): HTTP API обходит реализованные helpers кэша. Поэтому результат «301 → 1 SQL» представленным HTTP-путём не подтверждается. Подключите согласованный кэш и воспроизведите конкурентный эксперимент до/после, read-after-write и восстановление Redis.
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 00:08:39 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#9