forked from mtusi2026/mtusi2026lab2
47 lines
3.7 KiB
Markdown
47 lines
3.7 KiB
Markdown
# Отчёт — лабораторная 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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
|