Files
mtusi2026lab2/REPORT.md
T
Atelier77 7dcef08d8b
Skeleton contracts / contracts (pull_request) Canceled after 0s
feat-(report ready)
2026-11-07 13:25:04 +03:00

4.7 KiB

Отчёт — лабораторная 2

  • Автор, группа: Синюк Максим Павлович, БПИ2301
  • Целевая оценка; выбранный трек 5, если нужен: 4
  • Commit/PR: 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 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 | | Индекс истории обоснован запросом и EXPLAIN (ANALYZE, BUFFERS) на ≥10 000 сообщениях| docker compose exec api python -m scripts.explain_messages | Индекс в десятки раз уменьшает latency запроса | results/explain_comparison.txt | Выбранный трек 5, если заявлен | TODO | TODO | TODO |

TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.

Эксперименты и отказы

TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
TODO TODO TODO TODO

Ограничения и следующие шаги

TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.