503 от POST-запросов при тестах с хоста.
Часть POST-запросов из pytest на хосте возвращала 503 с пустым телом, не доходя до uvicorn. При запуске тестов внутри сети docker compose проблема не воспроизводится. Вероятная причина — сервис не успевал подняться или был недоступен по host-адресу до прохождения healthcheck. Workaround: запускать pytest внутри контейнера (docker compose exec api ...) или дождаться health/ready перед тестами.
Ограничения concurrent-тестов. student-tests/concurrent_test.py проверяет корректность при параллельных запросах, но не покрывает сетевые сбои, таймауты и падение БД. Сценарии отказов ограничены tests/resilience.py --mode persistence.
Кроссплатформенность.
Команды в README и PR написаны для Linux/macOS. На Windows нужно использовать py -3 вместо python3, copy вместо cp, curl.exe вместо curl, а также синтаксис переменных конкретной оболочки ($env:VAR в PowerShell, %VAR% в cmd). В PowerShell curl — это алиас для Invoke-WebRequest, поэтому нужен именно curl.exe.
Не реализовано / вне скоупа.
Refresh-токены, горизонтальное масштабирование, шардирование, мониторинг (Prometheus/Grafana), CI/CD — вне задачи.
Известные баги.
При высокой конкурентности (сотни одновременных 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 содержит инструкцию именно моего решения.
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.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 2
Автор / группа: Максимова Снежана Игоревна / БПИ2302
Целевая оценка (3/4/5): 5
Трек A, если заявлен: A
Что реализовано и что перенесено
Реализовано:
scripts/track_a_bench.py).Перенесено из предыдущей работы:
Команды запуска из чистого clone
Дополнительные проверки (после старта контейнеров):
Результаты проверок и ссылка на 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
Ограничения / известные ошибки
503 от POST-запросов при тестах с хоста.
Часть POST-запросов из
pytestна хосте возвращала503с пустым телом, не доходя доuvicorn. При запуске тестов внутри сетиdocker composeпроблема не воспроизводится. Вероятная причина — сервис не успевал подняться или был недоступен по host-адресу до прохождения healthcheck. Workaround: запускатьpytestвнутри контейнера (docker compose exec api ...) или дождатьсяhealth/readyперед тестами.Ограничения concurrent-тестов.
student-tests/concurrent_test.pyпроверяет корректность при параллельных запросах, но не покрывает сетевые сбои, таймауты и падение БД. Сценарии отказов ограниченыtests/resilience.py --mode persistence.Кроссплатформенность.
Команды в README и PR написаны для Linux/macOS. На Windows нужно использовать
py -3вместоpython3,copyвместоcp,curl.exeвместоcurl, а также синтаксис переменных конкретной оболочки ($env:VARв PowerShell,%VAR%в cmd). В PowerShellcurl— это алиас дляInvoke-WebRequest, поэтому нужен именноcurl.exe.Не реализовано / вне скоупа.
Refresh-токены, горизонтальное масштабирование, шардирование, мониторинг (Prometheus/Grafana), CI/CD — вне задачи.
Известные баги.
При высокой конкурентности (сотни одновременных 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. ИИ использовался для черновика кода, финальный код проверен вручную.
WWW-Authenticateсcharset="UTF-8".ANALYZE, BUFFERS.Принято. Закрываю МР.
Pull request closed