diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 8ceefa1..40a8217 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,20 @@ ## Лабораторная 2 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Автор / группа: Синюк Максим / БПИ2301 +Целевая оценка (3/4/5): 5 +Трек 1 (на оценку 5): "Согласованность кэша" -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO +Что реализовано и что перенесено: перенесены пользовательские тесты, валидация(перенастроена на пароль), роуты(перенастроены на защиту по токену сессии) +Команды запуска из чистого clone: cd mtusi2026lab2 | docker compose -d --build | docker compose logs api --tail 50 Результаты проверок и ссылка на REPORT.md: TODO Ограничения / известные ошибки: TODO Источники и использование ИИ: TODO -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +pool_size и pool_timeout защищают БД от исчерпания соединений (Connection Exhaustion) при DDoS или всплесках трафика, параметризованные запросы/безопасный ORM, Проверены гонка регистрации одинакового username(test_duplicate_username) и rollback составной операции + +- [+] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. +- [+] Контракт и публичные тесты не ослаблены. +- [+] make check и make test выполнены; приложен реальный вывод. +- [+] Сценарии отказов/безопасности своего уровня воспроизведены. +- [+] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. +- [+] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. diff --git a/REPORT.md b/REPORT.md index e42f2b0..892d94a 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,25 +1,42 @@ # Отчёт — лабораторная 2 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO +- Автор, группа: Синюк Максим Павлович, БПИ2301 +- Целевая оценка; выбранный трек 5, если нужен: 5, трек 1 - Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Использованные источники, библиотеки и помощь ИИ: перенос базы лаб1, python, fastapi, uvicorn, pydantic, pytest, sqlalchemy, argon2-cffi, redis ## Запуск из чистого clone TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +git clone -b "solution/БПИ2301-Синюк" https://gitea.privcloud.tech/Atelier77/mtusi2026lab2 +docker compose build +docker compose up -d +docker stop mtusi2026lab2-api + ## Архитектура и решения TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +описание классов для работы с таблицами БД через ORM - src/api/repositories/ +модели ORM таблиц для PostgreSQL - src/models/ +валидация - src/pydantic_valid/ + + ## Доказательства критериев | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | +| Публичный smoke | make test | PASS: lab1 public API scenario; infrastructure and grading evidence remain separate. | `results/make.log` | | Остальные пункты уровня 3 | TODO | TODO | TODO | +| Проверка контрактов | python scripts/check_contract.py | PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. | `results/check_contract.log` | +| Валидация openapi | python scripts/check_contract.py | PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. | `results/validate_openapi.log` | +| Собственные тесты | `python -m pytest student_tests -v` | 20 passed | `results/pytest.log` | +| Нагрузочный тест | `python tests/load.py --duration 30 --concurrency 10| ~100 req, 0 errors | `results/load.json` | +| Проверка нагрузки | python tests/load.py | Latency percentiles cover successes only. | `results/test_load.log` | + | Все пункты уровня 4, если заявлен | TODO | TODO | TODO | + | Выбранный трек 5, если заявлен | TODO | TODO | TODO | TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. diff --git a/results/load.json b/results/load.json new file mode 100644 index 0000000..77601e7 Binary files /dev/null and b/results/load.json differ diff --git a/src/config.py b/src/config.py index 7f5d7cb..fbcd518 100644 --- a/src/config.py +++ b/src/config.py @@ -10,8 +10,11 @@ class Settings(BaseSettings): DATABASE_URL: str = Field(..., description="Строка подключения к PostgreSQL. docker_compose перезапишет поле через .env") SESSION_TTL_SECONDS: int = 3600 - DB_POOL_SIZE: int = 5 - DB_MAX_OVERFLOW: int = 10 + DB_POOL_SIZE: int = 10 + DB_MAX_OVERFLOW: int = 20 + + DB_POOL_TIMEOUT: int = 30 + DB_POOL_RECYCLE: int = 3600 model_config = SettingsConfigDict(env_file=".env", case_sensitive=False, extra="ignore") diff --git a/src/database.py b/src/database.py index c03c4b2..c189724 100644 --- a/src/database.py +++ b/src/database.py @@ -12,6 +12,8 @@ engine = create_async_engine( echo=settings.APP_DEBUG, pool_size=settings.DB_POOL_SIZE, max_overflow=settings.DB_MAX_OVERFLOW, + pool_timeout=settings.DB_POOL_TIMEOUT, + pool_recycle=settings.DB_POOL_RECYCLE, pool_pre_ping=True, ) diff --git a/src/redis_client.py b/src/redis_client.py new file mode 100644 index 0000000..7f09936 --- /dev/null +++ b/src/redis_client.py @@ -0,0 +1,15 @@ +import os +import redis.asyncio as redis +import json + +REDIS_URL = os.getenv("REDIS_URL") + +redis_client = redis.from_url(REDIS_URL, decode_responses=True) + + +async def get_redis() -> redis.Redis: + return redis_client + + +async def close_redis(): + await redis_client.close()