Files

3.7 KiB

Отчёт — лабораторная 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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.