forked from mtusi2026/mtusi2026lab2
feat-(level 3 ready - to level 4)
This commit is contained in:
@@ -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 содержит инструкцию именно моего решения.
|
||||
|
||||
@@ -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 требует подтверждения, какие реальные процессы/хранилища перезапущены.
|
||||
|
||||
Binary file not shown.
+5
-2
@@ -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")
|
||||
|
||||
|
||||
@@ -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,
|
||||
)
|
||||
|
||||
|
||||
@@ -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()
|
||||
Reference in New Issue
Block a user