Сохранить проверки отказов, перегрузки и отчёт

This commit is contained in:
2026-10-30 17:30:32 +03:00
parent ed5da7cdfb
commit 35764f730c
20 changed files with 5806 additions and 36 deletions
+15 -14
View File
@@ -1,18 +1,19 @@
## Лабораторная 2
Автор / группа: TODO
Целевая оценка (3/4/5): TODO
Трек 5, если заявлен: TODO
Васильев Никита, БВТ2301. Целевая оценка5. Трек: План запроса и восстановление.
Что реализовано и что перенесено: TODO
Команды запуска из чистого clone: TODO
Результаты проверок и ссылка на REPORT.md: TODO
Ограничения / известные ошибки: TODO
Источники и использование ИИ: TODO
Реализованы обязательный API и все пункты уровня4; методика выбранного исследования,
реальные результаты и ограничения приведены в [REPORT.md](../../REPORT.md).
Команды запуска: `uv sync --locked --python 3.12`, `make up`, `make test`,
`make check validate PYTHON=.venv/bin/python`, `make lint test-student`.
Подробные проверки отказов и повторение исследования — в отчёте.
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [ ] Контракт и публичные тесты не ослаблены.
- [ ] make check и make test выполнены; приложен реальный вывод.
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Исходные contracts и публичные tests сохранены. Secrets, .env и volumes в Git не входят.
Чистый clone проверен отдельно; evidence локальные, удалённый CI пока не запускался.
Публикация в собственный fork и фактический URL МР будут добавлены после получения аккаунта.
Помощь ИИ использована при подготовке и проверке; результаты проверены реальными запусками.
- [x] Обязательный минимум сохранён с объявленным переходом API.
- [x] Контракт и публичные tests не ослаблены.
- [x] Проверки и ограничения описаны в REPORT.md.
- [x] Исходный README задания сохранён.
+2
View File
@@ -30,3 +30,5 @@ coverage/
.vscode/
# Keep small, sanitized evidence summaries in evidence/ under version control.
# Inspect git diff --cached: ignore rules are not a secret scanner.
.pytest_cache/
.ruff_cache/
+141 -21
View File
@@ -1,37 +1,157 @@
# Отчёт — лабораторная 2
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
Автор: **Васильев Никита, БВТ2301**. Целевая оценка: **5**.
Публикация пока не выполнялась: аккаунт и собственный fork будут предоставлены позднее.
Ветка: `solution/bvt2301-vasilev`. Автор коммитов: `n.a.vasilev@edu.mtuci.ru`.
Исходные README, COURSE, CONTRIBUTING, contracts и публичные tests сохранены.
Помощь ИИ использована при разборе требований, подготовке реализации, тестов и
материалов защиты. Все заявленные результаты подтверждаются реальными запусками;
чужие реализации, история и результаты измерений не использованы как собственные.
Выбран трек2: **план запроса и восстановление**.
Исходный проект: https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2
Название будущего МР: **ЛР 2 — БВТ2301 — Васильев — на 5**.
## Запуск из чистого clone
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
Нужны Docker с Compose, Git, uv и Python3.12. Все зависимости закреплены uv.lock.
Runtime Python3.12.13, FastAPI0.162.0, Pydantic2.14.2, Uvicorn0.54.0;
PostgreSQL17.10-alpine и Valkey8.1.3-alpine. Dockerfile использует digest Python.
## Архитектура и решения
```sh
uv sync --locked --python 3.12
make up
make check validate PYTHON=.venv/bin/python
make lint test-student
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
```
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
`make up` вызывает bootstrap, собирает образ с OCI revision, поднимает PostgreSQL
и Valkey, выполняет миграции отдельным сервисом, ждёт healthy API.
API: http://127.0.0.1:8082. Обычный Compose не публикует порты PostgreSQL/Valkey.
Полная проверка короткого TTL и реальных отказов:
```sh
VCS_REF=$(git rev-parse HEAD) docker compose -f compose.yaml -f compose.test.yaml up -d --build --wait
python3 scripts/verify_lifecycle.py --output evidence/lifecycle-repeat.json
python3 scripts/verify_pool.py --output evidence/pool-repeat.json
uv run --locked python research/run.py --output evidence/query-study-repeat.json
uv run --locked python research/analyze.py evidence/query-study-repeat.json
```
Test override добавляет только отдельную API на127.0.0.1:18082 с TTL2s. Обычный
TTL3600s, для public persistence не меньше300s. Эксперименты отказов запускать
последовательно. Каждому повтору нужен новый evidence-файл.
Остановка с сохранением данных: `docker compose -f compose.yaml -f compose.test.yaml down`.
Намеренное удаление **только данных этой учебной ЛР2**: та же команда с `--volumes`;
она необратимо удаляет пользователей, сообщения и сессии. Обычная остановка volumes
не удаляет. Не используйте глобальную очистку Docker.
### Настройки и секреты
`scripts/bootstrap.py` создаёт secrets один раз и сохраняет существующие значения.
`.env.example` исходный, переменные сопоставлены так: `APP_HOST/APP_PORT` читаются
сервером; `APP_ENV` зарезервирован; `SESSION_TTL_SECONDS` — срок сессии;
`DATABASE_URL_FILE` и `CACHE_URL_FILE` — файлы URL подключений; `SESSION_STORE`
в этой реализации фиксирован PostgreSQL. Созданный `.env` содержит только PUBLIC_PORT
и TTL. Для другого порта задайте PUBLIC_PORT в окружении и make test PUBLIC_PORT=...
Secrets каталог имеет host mode0700. Файлы0644 внутри него нужны для переносимых
file-backed Compose secret mounts non-root API; в API смонтированы только DB/cache URL,
в PostgreSQL только password. Ни значения, ни `.env`, ни volumes не входят в Git,
образ и сдаваемый пакет. При сохранённых volumes нельзя генерировать новый пароль
вместо старого. Valkey не требует пароля в изолированной внутренней сети; пользователь
с доступом к Docker-host считается доверенным. Для удалённого стенда это требует
дополнительного hardening и TLS.
## Архитектура, схема, транзакции
Клиент → один API → PostgreSQL; Valkey содержит disposable User-карточки с TTL60s.
Из собственной ЛР1 перенесены маршруты, строгие схемы, ошибки, ACL, cursor и тесты.
In-memory adapter заменён на `src/messenger/postgres.py`; добавлены password и сессии.
Оригинальные contracts/tests ЛР2 сохранены. Проект не зависит от соседней lab1.
Схема и границы были описаны до SQL: [SCHEMA.md](SCHEMA.md).
Миграция: [001_initial.sql](migrations/001_initial.sql). PK/FK/UNIQUE защищают
users/chats/members/messages/sessions. Составной FK сообщения требует реального
участника чата. Порядок member_ids сохраняется через position. Создание чата и
всех membership — одна транзакция; неизвестный участник откатывает всё.
Миграции выполняются под advisory lock, сохраняют checksum и при изменении
применённого файла завершаются ошибкой. Повторный запуск идемпотентен.
Все значения SQL параметризованы. Пул1..8 соединений, очередь≤32, ожидание2s,
connect2s, statement2.5s, lock1.5s; исчерпание и недоступность дают503.
История использует `(chat_id,created_at,id)` и keyset, без OFFSET.
Чтения autocommit, составные записи в явной транзакции.
Пароли12..128 Unicode code points, без усечения, Argon2id time_cost2,
memory_cost65536KiB, parallelism1, максимум2 KDF одновременно. Basic разбирается
как UTF-8 по первому двоеточию, только при создании сессии; тело входа игнорируется.
Opaque token —32 случайных байта; PostgreSQL хранит SHA-256 token и абсолютный expiry.
Каждый защищённый запрос сначала читает сессию из PostgreSQL, затем карточку из
Valkey или PostgreSQL. Logout удаляет сессию из источника истины. Кэш не может
воскресить её после logout/expiry и не разрешает авторизацию при отказе PostgreSQL.
Карточки User неизменяемы в обязательном API; поэтому не требуется инвалидация,
TTL/eviction/flush/restart безопасны. История не кэшируется и не бывает stale.
## Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | make test | TODO | TODO |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
| Критерий README | Реализация / команда | Наблюдение / evidence |
|---|---|---|
| Сохранённый API с новой идентификацией | make test | [smoke-final.txt](evidence/smoke-final.txt) |
| PG users/chats/members/messages, FK/UNIQUE, атомарность | migrations; test_chat_validation_and_atomicity | [tests-final.txt](evidence/tests-final.txt), [lifecycle.json](evidence/lifecycle.json) |
| Basic/Bearer, password KDF, TTL/logout, X-User-Id игнорируется | test_sessions.py; verify_lifecycle.py | [tests-final.txt](evidence/tests-final.txt), [lifecycle.json](evidence/lifecycle.json) |
| Перезапуск API+PG+cache с тем же токеном | public persistence и actual CID/PID/StartedAt | [lifecycle.json](evidence/lifecycle.json) |
| Повтор миграций, secrets вне Git | verify_lifecycle.py; bootstrap; audit | [lifecycle.json](evidence/lifecycle.json), [audit.json](evidence/audit.json) |
| Valkey реально кэширует, TTL/flush/failure | DBSIZE→flush→repopulate, stop cache | [lifecycle.json](evidence/lifecycle.json) |
| SQL/pool/timeouts, гонка username, rollback | собственные HTTP-тесты; verify_pool.py | [tests-final.txt](evidence/tests-final.txt), [pool.json](evidence/pool.json) |
| Индекс и EXPLAIN≥10000 | реальный dataset100000 | [query-study-final.json](evidence/query-study-final.json) |
| Автоматические expiry/logout/wrong password/отказы | короткий TTL2s, рестарт short API, stopPG/cache | [lifecycle.json](evidence/lifecycle.json) |
| Трек5:100k/skew/2индекса/запись/backup/restore | research/run.py | [Методика](research/README.md), [raw](evidence/query-study-final.json), [график](evidence/query-study-final.svg) |
| Чистый независимый clone | новый project/secrets/volume | [clean-clone.json](evidence/clean-clone.json) |
| Структура, OpenAPI, lint | make check validate lint | [contract-final.txt](evidence/contract-final.txt) |
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
## Исследование и отказы
## Эксперименты и отказы
100000 сообщений, размеры чатов80000/15000/8×625. Сравниваются индекс chat_id
и индекс(chat_id,created_at,id), одинаковый запрос глубокой страницы,5 прогревов,
3фазы на индекс и7 EXPLAIN на фазу. Измерены insertion5000+COMMIT, размер и WAL.
Порядок A/B, B/A, A/B уменьшает дрейф. Все EXPLAIN ANALYZE BUFFERS сохранены.
Числа приведены в [итоге исследования](evidence/query-study-final-summary.md).
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
Реальный pg_dump-Fc восстановлен в новую БД; совпали counts всех5таблиц,
20полных сообщений и checksum всех100000. Исследовательские БД удаляются finally;
рабочая messenger не очищается. При реальном stopPG старый token получает503,
после восстановления снова действует. При stopcache корректный fallback сохраняет
доступ, а анонимный запрос остаётся401. Повторный logout/expiry —401.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| TODO | TODO | TODO | TODO |
SQL latency не равна HTTP latency. WAL общий для кластера; короткие3серии записи
не доказывают небольшое ускорение/замедление. Прогретый локальный restore не включает
доставку копии или замену hardware. Backup отражает снимок; изменения после него
потеряются без PITR. Одна БД, одинhost и отсутствие TLS остаются ограничениями.
Список чатов содержит дополнительные SQL-запросы для member_ids (N+1 до100чатов);
это ограничивает масштабирование, но не корректность. Старые истёкшие сессии могут
оставаться в таблице до операторской уборки, хотя авторизоваться ими нельзя.
## Ограничения и следующие шаги
## Ответы на вопросы защиты
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
1. **COMMIT:** транзакция становится видимой целиком. fsync=on,
synchronous_commit=on и full_page_writes=on обеспечивают запись WAL по настройкам
PostgreSQL; volume сохраняет данные при рестарте, но не при потере единственного диска.
2. **Сессии:** digest и expiry находятся в PostgreSQL. Flush/restart Valkey теряет
только кэш публичных карточек; срок сессии не продлевается и logout не отменяется.
3. **Аутентификация/ACL:** Bearer определяет пользователя, membership разрешает
конкретный чат. Даже действующий token постороннего получает404.
4. **Пароль/checksum:** пароль низкоэнтропийный, нужен дорогой salted KDF;
случайный256-битный token имеет другую модель, SHA-256 используется для его поиска
без хранения оригинального секрета. SHA не подходит вместо Argon2id для паролей.
Подробный конспект: [DEFENSE.md](DEFENSE.md).
Источники: исходный контракт, [PostgreSQL](https://www.postgresql.org/docs/17/),
[psycopg](https://www.psycopg.org/psycopg3/docs/),
[Argon2](https://argon2-cffi.readthedocs.io/), [Valkey](https://valkey.io/topics/).
+14
View File
@@ -0,0 +1,14 @@
{
"passed": true,
"candidate_files": 73,
"reachable_objects": 85,
"required_source_files": {
"README.md": "unchanged",
"COURSE.md": "unchanged",
"CONTRIBUTING.md": "unchanged",
"contracts": "unchanged",
"tests": "unchanged"
},
"known_local_password_checked": true,
"scope": "candidate files and all reachable Git objects; no remote publication"
}
+108
View File
@@ -0,0 +1,108 @@
Image mtusi-vasilev:lab2 Building
Image mtusi-vasilev:lab2 Building
#1 [internal] load local bake definitions
#1 reading from stdin 1.23kB done
#1 DONE 0.0s
#2 [migrate internal] load build definition from Dockerfile
#2 transferring dockerfile: 941B done
#2 DONE 0.0s
#3 [migrate internal] load metadata for ghcr.io/astral-sh/uv:0.11.7
#3 DONE 0.0s
#4 [api internal] load metadata for docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b
#4 DONE 0.0s
#5 [api internal] load .dockerignore
#5 transferring context: 109B done
#5 DONE 0.0s
#6 [api internal] load build context
#6 transferring context: 11.64kB done
#6 DONE 0.0s
#7 [migrate build 1/5] FROM docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b
#7 resolve docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b done
#7 DONE 0.0s
#8 [api] FROM ghcr.io/astral-sh/uv:0.11.7@sha256:240fb85ab0f263ef12f492d8476aa3a2e4e1e333f7d67fbdd923d00a506a516a
#8 resolve ghcr.io/astral-sh/uv:0.11.7@sha256:240fb85ab0f263ef12f492d8476aa3a2e4e1e333f7d67fbdd923d00a506a516a done
#8 DONE 0.0s
#9 [migrate build 3/5] WORKDIR /app
#9 CACHED
#10 [migrate build 5/5] RUN uv sync --locked --no-dev --no-install-project --python /usr/local/bin/python
#10 CACHED
#11 [migrate build 2/5] COPY --from=ghcr.io/astral-sh/uv:0.11.7 /uv /usr/local/bin/uv
#11 CACHED
#12 [migrate stage-1 2/5] WORKDIR /app
#12 CACHED
#13 [migrate build 4/5] COPY pyproject.toml uv.lock ./
#13 CACHED
#14 [api stage-1 3/5] COPY --from=build /app/.venv /app/.venv
#14 CACHED
#15 [api stage-1 4/5] COPY src ./src
#15 DONE 0.0s
#16 [migrate stage-1 5/5] COPY migrations ./migrations
#16 DONE 0.0s
#17 [api] exporting to image
#17 exporting layers 0.0s done
#17 exporting manifest sha256:42d0b1c18c4aa8b6a295c492ead287ece57a3187acd7db461d8e848d6330aa25 done
#17 exporting config sha256:8449b4652509011c64cb2779c5708c8eb31137f461238e926a636739d5706e1a done
#17 exporting attestation manifest sha256:603b58c37312ba725c194aba4b804c8774df018263c58a610a3fe87441801c93
#17 exporting attestation manifest sha256:603b58c37312ba725c194aba4b804c8774df018263c58a610a3fe87441801c93 0.0s done
#17 exporting manifest list sha256:2ea0407e09abffcf5f1e1905a395fcea97b988085675ab77e805d83758db43cc done
#17 naming to docker.io/library/mtusi-vasilev:lab2 done
#17 unpacking to docker.io/library/mtusi-vasilev:lab2 0.0s done
#17 DONE 0.1s
#18 [migrate] exporting to image
#18 exporting layers 0.0s done
#18 exporting manifest sha256:f93fcbfab9362ac536c54359b4d63fa2b9f1b2c6bbd020f03bbc60b4e71606ba done
#18 exporting config sha256:801010193b0453f24d48c97a39d21f5b3f5b104568d4ec2c59c7e3209040654c done
#18 exporting attestation manifest sha256:9000fcdcf7fdb3d2f6461b3e7b9fc26ccec4c23915ea2cd80df4fc9492c973fc 0.0s done
#18 exporting manifest list sha256:1940fd33577ea36bd5f65c20e9b7ba73f83f347d5bd0565af0e5b5629c8af1b7 done
#18 naming to docker.io/library/mtusi-vasilev:lab2 done
#18 unpacking to docker.io/library/mtusi-vasilev:lab2 done
#18 DONE 0.1s
#19 [api] resolving provenance for metadata file
#19 DONE 0.0s
#20 [migrate] resolving provenance for metadata file
#20 DONE 0.0s
Image mtusi-vasilev:lab2 Built
Image mtusi-vasilev:lab2 Built
Container mtusi-vasilev-lab2-postgres-1 Running
Container mtusi-vasilev-lab2-cache-1 Running
Container mtusi-vasilev-lab2-migrate-1 Recreate
Container mtusi-vasilev-lab2-migrate-1 Recreated
Container mtusi-vasilev-lab2-api-1 Recreate
Container mtusi-vasilev-lab2-api-1 Recreated
Container mtusi-vasilev-lab2-postgres-1 Waiting
Container mtusi-vasilev-lab2-postgres-1 Healthy
Container mtusi-vasilev-lab2-migrate-1 Starting
Container mtusi-vasilev-lab2-migrate-1 Started
Container mtusi-vasilev-lab2-migrate-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Waiting
Container mtusi-vasilev-lab2-migrate-1 Exited
Container mtusi-vasilev-lab2-cache-1 Healthy
Container mtusi-vasilev-lab2-api-1 Starting
Container mtusi-vasilev-lab2-api-1 Started
Container mtusi-vasilev-lab2-api-1 Waiting
Container mtusi-vasilev-lab2-postgres-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Waiting
Container mtusi-vasilev-lab2-migrate-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Healthy
Container mtusi-vasilev-lab2-postgres-1 Healthy
Container mtusi-vasilev-lab2-migrate-1 Exited
Container mtusi-vasilev-lab2-api-1 Healthy
+135
View File
@@ -0,0 +1,135 @@
Image mtusi-vasilev:lab2 Building
Image mtusi-vasilev:lab2 Building
Image mtusi-vasilev:lab2 Building
#1 [internal] load local bake definitions
#1 reading from stdin 1.91kB done
#1 DONE 0.0s
#2 [api internal] load build definition from Dockerfile
#2 transferring dockerfile: 941B done
#2 DONE 0.0s
#3 [api internal] load metadata for docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b
#3 DONE 0.0s
#4 [api-short internal] load metadata for ghcr.io/astral-sh/uv:0.11.7
#4 DONE 0.0s
#5 [api-short internal] load .dockerignore
#5 transferring context: 109B done
#5 DONE 0.0s
#6 [api internal] load build context
#6 transferring context: 9.70kB done
#6 DONE 0.0s
#7 [api-short build 1/5] FROM docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b
#7 resolve docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b 0.0s done
#7 DONE 0.0s
#8 [api-short] FROM ghcr.io/astral-sh/uv:0.11.7@sha256:240fb85ab0f263ef12f492d8476aa3a2e4e1e333f7d67fbdd923d00a506a516a
#8 resolve ghcr.io/astral-sh/uv:0.11.7@sha256:240fb85ab0f263ef12f492d8476aa3a2e4e1e333f7d67fbdd923d00a506a516a 0.0s done
#8 DONE 0.0s
#9 [api stage-1 2/5] WORKDIR /app
#9 CACHED
#10 [api build 5/5] RUN uv sync --locked --no-dev --no-install-project --python /usr/local/bin/python
#10 CACHED
#11 [api build 4/5] COPY pyproject.toml uv.lock ./
#11 CACHED
#12 [api build 2/5] COPY --from=ghcr.io/astral-sh/uv:0.11.7 /uv /usr/local/bin/uv
#12 CACHED
#13 [api build 3/5] WORKDIR /app
#13 CACHED
#14 [api stage-1 3/5] COPY --from=build /app/.venv /app/.venv
#14 CACHED
#15 [api-short stage-1 4/5] COPY src ./src
#15 DONE 0.0s
#16 [migrate stage-1 5/5] COPY migrations ./migrations
#16 DONE 0.0s
#17 [api] exporting to image
#17 exporting layers 0.1s done
#17 exporting manifest sha256:432f1d88a72a81ebe646da23f3af7eb1eb0ca2938d88f24eaae54042ede38952
#17 exporting manifest sha256:432f1d88a72a81ebe646da23f3af7eb1eb0ca2938d88f24eaae54042ede38952 done
#17 exporting config sha256:1b5cc3ea17af385ea711e8686c39c109a0284e6263a6852a8d94db000b3970d4 done
#17 exporting attestation manifest sha256:87135ff983f505b882a8aefcdc2acf64f7e72d35b7c4604f7066cef6893ff64f 0.0s done
#17 exporting manifest list sha256:f6e168c1f546b74ac5180bd3aa195e8f4cf5f002c9ae366d16bf7f574c6a09eb 0.0s done
#17 naming to docker.io/library/mtusi-vasilev:lab2 done
#17 unpacking to docker.io/library/mtusi-vasilev:lab2 0.0s done
#17 DONE 0.1s
#18 [migrate] exporting to image
#18 exporting layers 0.1s done
#18 exporting manifest sha256:391536dc94736476a626531cce9d1fd30471f5daa44139f932596d818182cb6e done
#18 exporting config sha256:8e63b319ea923b635b77feba2f00aeff8fc6b8d35579d2d7b3ac9c1135e0c3c8 done
#18 exporting attestation manifest sha256:7c69a3e54c93e797e961190b37e5f3993adad21d31b3db18a599d0c290344cad 0.0s done
#18 exporting manifest list sha256:49dd8cf9ad65fe8ab8934a5a95987674643c3cc9aa9805cabf12e77662bbc291 done
#18 naming to docker.io/library/mtusi-vasilev:lab2 done
#18 unpacking to docker.io/library/mtusi-vasilev:lab2 0.0s done
#18 DONE 0.1s
#19 [api-short] exporting to image
#19 exporting layers 0.1s done
#19 exporting manifest sha256:45021bba21b93e50c897e3d4812790e0b6b674d0f5bd3f423b0847124262fb52 0.0s done
#19 exporting config sha256:bbd200e3f66dd1035503f37a73ffd1bb10f73619e0447a512ea6085891f5f496 done
#19 exporting attestation manifest sha256:772c450f4673d5d7dc6f4e8c55c92d22c444ae88a3d36c4322a835a142a0ded7 0.0s done
#19 exporting manifest list sha256:068b48dec587d6fa1758022fe42da6a2cfb95bb68e56303ef23d0115b0284598 done
#19 naming to docker.io/library/mtusi-vasilev:lab2 done
#19 unpacking to docker.io/library/mtusi-vasilev:lab2 0.0s done
#19 DONE 0.1s
#20 [migrate] resolving provenance for metadata file
#20 DONE 0.0s
#21 [api] resolving provenance for metadata file
#21 DONE 0.0s
#22 [api-short] resolving provenance for metadata file
#22 DONE 0.0s
Image mtusi-vasilev:lab2 Built
Image mtusi-vasilev:lab2 Built
Image mtusi-vasilev:lab2 Built
Container mtusi-vasilev-lab2-migrate-1 Recreate
Container mtusi-vasilev-lab2-migrate-1 Recreated
Container mtusi-vasilev-lab2-api-short-1 Creating
Container mtusi-vasilev-lab2-api-1 Recreate
Container mtusi-vasilev-lab2-api-short-1 Created
Container mtusi-vasilev-lab2-api-1 Recreated
Container mtusi-vasilev-lab2-postgres-1 Starting
Container mtusi-vasilev-lab2-cache-1 Starting
Container mtusi-vasilev-lab2-cache-1 Started
Container mtusi-vasilev-lab2-postgres-1 Started
Container mtusi-vasilev-lab2-postgres-1 Waiting
Container mtusi-vasilev-lab2-postgres-1 Healthy
Container mtusi-vasilev-lab2-migrate-1 Starting
Container mtusi-vasilev-lab2-migrate-1 Started
Container mtusi-vasilev-lab2-migrate-1 Waiting
Container mtusi-vasilev-lab2-migrate-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Healthy
Container mtusi-vasilev-lab2-migrate-1 Exited
Container mtusi-vasilev-lab2-migrate-1 Exited
Container mtusi-vasilev-lab2-cache-1 Healthy
Container mtusi-vasilev-lab2-api-short-1 Starting
Container mtusi-vasilev-lab2-api-1 Starting
Container mtusi-vasilev-lab2-api-1 Started
Container mtusi-vasilev-lab2-api-short-1 Started
Container mtusi-vasilev-lab2-cache-1 Waiting
Container mtusi-vasilev-lab2-migrate-1 Waiting
Container mtusi-vasilev-lab2-api-1 Waiting
Container mtusi-vasilev-lab2-postgres-1 Waiting
Container mtusi-vasilev-lab2-api-short-1 Waiting
Container mtusi-vasilev-lab2-postgres-1 Healthy
Container mtusi-vasilev-lab2-migrate-1 Exited
Container mtusi-vasilev-lab2-cache-1 Healthy
Container mtusi-vasilev-lab2-api-1 Healthy
Container mtusi-vasilev-lab2-api-short-1 Healthy
+111
View File
@@ -0,0 +1,111 @@
Image mtusi-vasilev:lab2 Building
Image mtusi-vasilev:lab2 Building
#1 [internal] load local bake definitions
#1 reading from stdin 1.23kB done
#1 DONE 0.0s
#2 [migrate internal] load build definition from Dockerfile
#2 transferring dockerfile: 941B done
#2 DONE 0.0s
#3 [api internal] load metadata for docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b
#3 DONE 0.0s
#4 [api internal] load metadata for ghcr.io/astral-sh/uv:0.11.7
#4 DONE 0.0s
#5 [api internal] load .dockerignore
#5 transferring context: 109B done
#5 DONE 0.0s
#6 [migrate internal] load build context
#6 transferring context: 586B done
#6 DONE 0.0s
#7 [api] FROM ghcr.io/astral-sh/uv:0.11.7@sha256:240fb85ab0f263ef12f492d8476aa3a2e4e1e333f7d67fbdd923d00a506a516a
#7 resolve ghcr.io/astral-sh/uv:0.11.7@sha256:240fb85ab0f263ef12f492d8476aa3a2e4e1e333f7d67fbdd923d00a506a516a done
#7 DONE 0.0s
#8 [api build 1/5] FROM docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b
#8 resolve docker.io/library/python:3.12-slim@sha256:646fb0bca3dd3ea1bcc6feb72c17ed16eed6e10cffc732fcc1478bd3e7f02d7b done
#8 DONE 0.0s
#9 [api build 2/5] COPY --from=ghcr.io/astral-sh/uv:0.11.7 /uv /usr/local/bin/uv
#9 CACHED
#10 [api build 4/5] COPY pyproject.toml uv.lock ./
#10 CACHED
#11 [api stage-1 4/5] COPY src ./src
#11 CACHED
#12 [api stage-1 2/5] WORKDIR /app
#12 CACHED
#13 [api build 5/5] RUN uv sync --locked --no-dev --no-install-project --python /usr/local/bin/python
#13 CACHED
#14 [api build 3/5] WORKDIR /app
#14 CACHED
#15 [api stage-1 3/5] COPY --from=build /app/.venv /app/.venv
#15 CACHED
#16 [migrate stage-1 5/5] COPY migrations ./migrations
#16 CACHED
#17 [api] exporting to image
#17 exporting layers done
#17 exporting manifest sha256:a767adf69349b1bb5561480dbf515c392464a1957932c97e1ca1bd0cf159253f done
#17 exporting config sha256:ba01ce5652357b766bc456c242e3101eb21bd40d5531376cbcd32fdbfa79d71a done
#17 exporting attestation manifest sha256:425e718cd419a7742bd0a810cd660eceab2ce3377d2e5877b4a24dc051816515 0.0s done
#17 exporting manifest list sha256:cefafcb7c510133bef6010069951db0afd233005fc01e791ab3fcc59436e717f done
#17 naming to docker.io/library/mtusi-vasilev:lab2 done
#17 unpacking to docker.io/library/mtusi-vasilev:lab2 done
#17 DONE 0.0s
#18 [migrate] exporting to image
#18 exporting layers done
#18 exporting manifest sha256:5908354cc99a403d6885ba41971b36feea08217e3a10e8d5172939e8a8db8495 done
#18 exporting config sha256:8fbc9f74072452224d88e4ec4aae7d226f608649d38c1125573666ddfe91ebf9 done
#18 exporting attestation manifest sha256:1b82bbbfc074915201d8e616d64f87cc7ffdf060e742637775b19026380df44d 0.0s done
#18 exporting manifest list sha256:1c9527cd7b80ac00a7d5d43ec865ae759ddb11b275802ff0df97b87b74627073 done
#18 naming to docker.io/library/mtusi-vasilev:lab2 done
#18 unpacking to docker.io/library/mtusi-vasilev:lab2 done
#18 DONE 0.0s
#19 [api] resolving provenance for metadata file
#19 DONE 0.0s
#20 [migrate] resolving provenance for metadata file
#20 DONE 0.0s
Image mtusi-vasilev:lab2 Built
Image mtusi-vasilev:lab2 Built
Container mtusi-vasilev-lab2-migrate-1 Creating
Container mtusi-vasilev-lab2-cache-1 Recreate
Container mtusi-vasilev-lab2-migrate-1 Created
Container mtusi-vasilev-lab2-cache-1 Recreated
Container mtusi-vasilev-lab2-api-1 Creating
Container mtusi-vasilev-lab2-api-1 Created
Container mtusi-vasilev-lab2-cache-1 Starting
Container mtusi-vasilev-lab2-postgres-1 Starting
Container mtusi-vasilev-lab2-cache-1 Started
Container mtusi-vasilev-lab2-postgres-1 Started
Container mtusi-vasilev-lab2-postgres-1 Waiting
Container mtusi-vasilev-lab2-postgres-1 Healthy
Container mtusi-vasilev-lab2-migrate-1 Starting
Container mtusi-vasilev-lab2-migrate-1 Started
Container mtusi-vasilev-lab2-cache-1 Waiting
Container mtusi-vasilev-lab2-migrate-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Healthy
Container mtusi-vasilev-lab2-migrate-1 Exited
Container mtusi-vasilev-lab2-api-1 Starting
Container mtusi-vasilev-lab2-api-1 Started
Container mtusi-vasilev-lab2-api-1 Waiting
Container mtusi-vasilev-lab2-postgres-1 Waiting
Container mtusi-vasilev-lab2-cache-1 Waiting
Container mtusi-vasilev-lab2-migrate-1 Waiting
Container mtusi-vasilev-lab2-migrate-1 Exited
Container mtusi-vasilev-lab2-cache-1 Healthy
Container mtusi-vasilev-lab2-postgres-1 Healthy
Container mtusi-vasilev-lab2-api-1 Healthy
+6
View File
@@ -0,0 +1,6 @@
.venv/bin/python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
uv run --locked ruff check src student-tests research
All checks passed!
+4
View File
@@ -0,0 +1,4 @@
.venv/bin/python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
+1
View File
@@ -0,0 +1 @@
PASS: real restart, same token, cache/DB faults, rollback, expiry and logout
+63
View File
@@ -0,0 +1,63 @@
{
"date_utc": "2026-10-30T14:29:20.955064+00:00",
"passed": true,
"public_persistence": "Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.\nPASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.",
"before": {
"api": {
"cid": "1a09782c5a2e1415b9d658444fc0336bb5eda6ad0660e36cf84659fd2bbb7594",
"pid": 19077,
"started_at": "2026-10-30T14:28:23.635694089Z"
},
"cache": {
"cid": "12a042ef8a5ab3098d941461b5971c7521ecd7a0838b1f1eb2f2319a8587313b",
"pid": 18807,
"started_at": "2026-10-30T14:28:20.486422322Z"
},
"postgres": {
"cid": "3e542fd46e4ff3e93f51a47a2de728ef0d5d9146373671ae461aa82e81ed28bb",
"pid": 18806,
"started_at": "2026-10-30T14:28:20.486758282Z"
}
},
"after": {
"api": {
"cid": "1a09782c5a2e1415b9d658444fc0336bb5eda6ad0660e36cf84659fd2bbb7594",
"pid": 21859,
"started_at": "2026-10-30T14:29:22.238596408Z"
},
"cache": {
"cid": "12a042ef8a5ab3098d941461b5971c7521ecd7a0838b1f1eb2f2319a8587313b",
"pid": 21728,
"started_at": "2026-10-30T14:29:22.040913407Z"
},
"postgres": {
"cid": "3e542fd46e4ff3e93f51a47a2de728ef0d5d9146373671ae461aa82e81ed28bb",
"pid": 21673,
"started_at": "2026-10-30T14:29:22.004637237Z"
}
},
"same_token_and_message_after_restart": true,
"cache_flush_repopulates": true,
"cache_failure": {
"authenticated_status": 200,
"anonymous_status": 401,
"seconds": 0.0427
},
"database_failure": {
"cached_actor_status": 503,
"ready_status": 503,
"live_status": 200,
"seconds": 2.0018
},
"session_after_database_recovery": true,
"failed_chat_transaction_left_rows": 0,
"migrations_reapplied_twice": true,
"expiry": {
"configured_ttl_seconds": 2,
"observed_after_seconds": 2.3825,
"expired_status": 401,
"short_api_restarted_before_check": true
},
"logout_with_cached_user": 401,
"credentials_absent_from_api_logs": true
}
+1
View File
@@ -0,0 +1 @@
PASS: real bounded connection pool overload returns 503
+212
View File
@@ -0,0 +1,212 @@
{
"passed": true,
"clients": 50,
"max_pool_size": 8,
"max_waiting": 32,
"admitted": 8,
"rejected_503": 42,
"max_seconds": 2.226985312998295,
"rows": [
{
"status": 503,
"seconds": 2.0008593890233897
},
{
"status": 503,
"seconds": 9.08802030608058e-06
},
{
"status": 200,
"seconds": 2.2165114110102877
},
{
"status": 200,
"seconds": 2.226985312998295
},
{
"status": 503,
"seconds": 1.3715005479753017e-05
},
{
"status": 503,
"seconds": 2.0015193020226434
},
{
"status": 503,
"seconds": 2.001966067997273
},
{
"status": 503,
"seconds": 8.628994692116976e-06
},
{
"status": 503,
"seconds": 2.0018118239822797
},
{
"status": 503,
"seconds": 3.668013960123062e-06
},
{
"status": 503,
"seconds": 8.004019036889076e-06
},
{
"status": 503,
"seconds": 2.001962565991562
},
{
"status": 503,
"seconds": 2.002134026028216
},
{
"status": 503,
"seconds": 2.001673088001553
},
{
"status": 503,
"seconds": 2.002291854994837
},
{
"status": 503,
"seconds": 2.002486660028808
},
{
"status": 503,
"seconds": 2.00323870300781
},
{
"status": 503,
"seconds": 2.001060738984961
},
{
"status": 503,
"seconds": 2.0012402459979057
},
{
"status": 503,
"seconds": 3.959983587265015e-06
},
{
"status": 200,
"seconds": 2.2083417040412314
},
{
"status": 200,
"seconds": 2.214471307990607
},
{
"status": 200,
"seconds": 2.2163876409758814
},
{
"status": 503,
"seconds": 2.001500209036749
},
{
"status": 503,
"seconds": 2.0021683349623345
},
{
"status": 503,
"seconds": 2.0028698940295726
},
{
"status": 503,
"seconds": 2.960034180432558e-06
},
{
"status": 503,
"seconds": 3.709981683641672e-06
},
{
"status": 503,
"seconds": 2.0020870030275546
},
{
"status": 503,
"seconds": 2.00253055797657
},
{
"status": 503,
"seconds": 2.0026431559817865
},
{
"status": 503,
"seconds": 2.0026960149989463
},
{
"status": 503,
"seconds": 2.002982742036693
},
{
"status": 503,
"seconds": 2.002759379975032
},
{
"status": 503,
"seconds": 7.504015229642391e-06
},
{
"status": 503,
"seconds": 3.668013960123062e-06
},
{
"status": 503,
"seconds": 3.001012373715639e-06
},
{
"status": 503,
"seconds": 2.0022876450093463
},
{
"status": 503,
"seconds": 3.001012373715639e-06
},
{
"status": 503,
"seconds": 2.0025205940473825
},
{
"status": 503,
"seconds": 1.2798001989722252e-05
},
{
"status": 503,
"seconds": 5.378038622438908e-06
},
{
"status": 503,
"seconds": 1.496501499786973e-05
},
{
"status": 200,
"seconds": 2.222472182009369
},
{
"status": 200,
"seconds": 2.222849245008547
},
{
"status": 503,
"seconds": 2.002373645955231
},
{
"status": 503,
"seconds": 5.418958608061075e-06
},
{
"status": 503,
"seconds": 2.003417416999582
},
{
"status": 503,
"seconds": 3.627035766839981e-06
},
{
"status": 200,
"seconds": 2.2056722860434093
}
],
"date_utc": "2026-10-30T14:29:39.194790+00:00"
}
File diff suppressed because it is too large Load Diff
+34
View File
@@ -0,0 +1,34 @@
<svg xmlns="http://www.w3.org/2000/svg" width="900" height="610" viewBox="0 0 900 610">
<rect width="900" height="610" fill="white"/>
<g font-family="sans-serif" font-size="15" fill="#172033">
<text x="30" y="30" font-size="21">100 000 messages: warm PostgreSQL comparison</text>
<text x="30" y="65">SQL median, ms</text>
<text x="30" y="99">chat_only</text>
<rect x="140" y="80" width="530.00" height="24" fill="#d68439"/>
<text x="680.00" y="98">3.433</text>
<text x="30" y="132">composite</text>
<rect x="140" y="113" width="2.01" height="24" fill="#346dc4"/>
<text x="152.01" y="131">0.013</text>
<text x="30" y="195">INSERT 5000 + COMMIT, s</text>
<text x="30" y="229">chat_only</text>
<rect x="140" y="210" width="530.00" height="24" fill="#d68439"/>
<text x="680.00" y="228">0.0497117</text>
<text x="30" y="262">composite</text>
<rect x="140" y="243" width="420.51" height="24" fill="#346dc4"/>
<text x="570.51" y="261">0.0394425</text>
<text x="30" y="325">Index size, bytes</text>
<text x="30" y="359">chat_only</text>
<rect x="140" y="340" width="64.60" height="24" fill="#d68439"/>
<text x="214.60" y="358">720896</text>
<text x="30" y="392">composite</text>
<rect x="140" y="373" width="530.00" height="24" fill="#346dc4"/>
<text x="680.00" y="391">5.91462e+06</text>
<text x="30" y="455">WAL for INSERT 5000, bytes</text>
<text x="30" y="489">chat_only</text>
<rect x="140" y="470" width="420.37" height="24" fill="#d68439"/>
<text x="570.37" y="488">1.40879e+06</text>
<text x="30" y="522">composite</text>
<rect x="140" y="503" width="530.00" height="24" fill="#346dc4"/>
<text x="680.00" y="521">1.77618e+06</text>
<text x="30" y="595">3 phases/index; 7 reads/phase; same data and limits. SQL time is not HTTP time.</text>
</g></svg>

After

Width:  |  Height:  |  Size: 1.7 KiB

+2
View File
@@ -0,0 +1,2 @@
python3 tests/smoke.py --base-url "http://127.0.0.1:8082"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
+2
View File
@@ -0,0 +1,2 @@
python3 tests/smoke.py --base-url "http://127.0.0.1:8082"
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
+3
View File
@@ -0,0 +1,3 @@
BASE_URL=http://127.0.0.1:8082 uv run --locked pytest -q
............................................................. [100%]
61 passed in 17.63s
+2
View File
@@ -0,0 +1,2 @@
............................... [100%]
31 passed in 11.80s
+1 -1
View File
@@ -44,7 +44,7 @@ def main():
if path.exists():
raise SystemExit("Choose a new evidence filename")
process = subprocess.run(
["docker", "compose", "exec", "-T", "api", "python", "-c", PROBE],
["docker", "compose", "run", "--rm", "--no-deps", "-T", "api", "python", "-c", PROBE],
cwd=ROOT,
capture_output=True,
text=True,