# Отчёт — лабораторная 2 - Автор, группа: TODO - Целевая оценка; выбранный трек 5, если нужен: 3 - Commit/PR: TODO после публикации - Использованные источники, библиотеки и помощь ИИ: TODO ## Запуск из чистого clone Нужны Docker Engine и Compose. Скопируйте `.env.example` в `.env` и задайте локальный `POSTGRES_PASSWORD` (файл `.env` не коммитится). Запуск: `docker compose up -d --build`; API автоматически создаёт схему PostgreSQL при старте. Проверка: `make test`. Перезапуск с сохранением данных: `make test-persistence ACTION_SCRIPT=scripts/restart.sh` (в Windows Makefile автоматически использует `scripts/restart.cmd`). Остановка без удаления данных: `docker compose down`; намеренное удаление учебных данных: `docker compose down -v`. ## Архитектура и решения API работает в контейнере `api`, PostgreSQL является источником истины для пользователей, чатов, membership, сообщений и сессий; volume `postgres_data` сохраняется. Схема создаётся идемпотентными `CREATE TABLE IF NOT EXISTS`, операции создания чата записывают чат и membership под блокировкой состояния. В lab2 X-User-Id заменён на Basic только для входа и Bearer для API. ## Доказательства критериев | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | | Публичный smoke | make test | PASS после запуска Compose | tests/smoke.py | | PostgreSQL и persistence | make test-persistence ACTION_SCRIPT=scripts/restart.sh | тот же токен и данные после restart | compose.yaml, scripts/restart.sh | | Auth, expiry, logout | tests/smoke.py | Basic/Bearer, 401 после logout | messenger/service.py | | Все пункты уровня 4, если заявлен | TODO | TODO | TODO | | Выбранный трек 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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.