Автор / группа: Сафронов Роман Николаевич, БВТ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: трек 2 — план запроса и восстановление
Что реализовано и что перенесено:
Перенесён минимум лабы 1 (FastAPI, Python 3.12) с объявленным переходом 1 → 2: MemoryStore заменён PostgreSQL 18, X-User-Id — Bearer-сессией, при регистрации нужен пароль.
PostgreSQL — источник истины: users, chats, chat_members, messages, sessions; PK/FK, UNIQUE username, CHECK по контракту; миграции alembic отдельным сервисом migrate до старта API, повторный запуск ничего не меняет. Чат с участниками создаётся в одной транзакции.
Пароли — Argon2id (RFC 9106 low-memory), считаются в потоке со своим лимитом. Basic — только на POST /auth/sessions, остальное — opaque Bearer (256 бит, в БД только SHA-256), срок [auth] session_ttl_seconds, мгновенный отзыв. X-User-Id игнорируется.
Уровень 4: Valkey 9.1 — кэш карточек чатов (cache-aside, истина в PostgreSQL, TTL 3600 с, LRU в 64 МБ; инвалидация не нужна — по контракту чаты неизменяемы). Если Valkey отказал, запрос идёт в обход кэша: задержка не больше 0,2 с, ответ тот же. Пул 10 + 5, таймауты на подключение, ожидание соединения, statement_timeout и весь запрос; БД недоступна — 503 unavailable, а не 401 и не анонимный доступ. Индекс истории (chat_id, created_at, id) + keyset обоснованы EXPLAIN (ANALYZE, BUFFERS) на 10k / 100k / 500k.
Трек 2, часть 1: 110k / 200k / 600k сообщений в 1 111 чатах от 10 до 500 000; сравнены 6 вариантов индекса и запроса и стоимость записи по 4 вариантам. Индекс приложения: 5–55 буферов на любой странице любого чата. OR-курсор: 252 338 буферов на середине чата 500k. covering: 5 буферов, но сообщение из 4000 символов не вставляется. Индекс оставлен по правилу выбора, записанному до замера.
Трек 2, часть 2: pg_dump под нагрузкой записи → pg_restore -j 4 в новый контейнер на новом volume → построчная сверка (md5 полей каждого сообщения) и сверка через HTTP. Всё, что было до backup, восстановлено; потеряны только записи после снимка. RTO 2,9–4,8 с; после восстановления обязателен FLUSHALL (измерено).
Свои тесты: student-tests/ (black-box по HTTP, pytest) и отдельный стенд для проверок отказов.
Команды запуска из чистого clone:
git clone -b solution/bvt2301-safronov <fork> && cd <каталог>
make run_docker # .env и config.toml со случайными паролями → build → postpi
curl -s localhost:8080/health/ready
make check && make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test_isolated # образ на временной базе: smoke + student-tests (нужен uv
make failure_checks # проверки отказов уровня 4 на отдельном стенде, ~45 с
make bench_quick && make bench_restore_quick # трек 2 на малых размерах, ~3 и
Подробно, включая make run_dev, — REPORT.md, раздел «Запуск из чистого clone».
Результаты проверок и ссылка на REPORT.md:REPORT.md, выводы — в evidence/.
Вывод из чистого clone c6ad34d на пустом volume, 2026-10-02:
make check
PASS: offline skeleton structure, local refs and Python syntax; application NOT
make validate PYTHON=.venv/bin/python
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
make test
PASS: lab2 public API scenario; infrastructure and grading evidence remain sepa
make test-persistence ACTION_SCRIPT=scripts/restart.sh
PASS: persistence preserved confirmed data and existing session. Hook scope nee
(у api, postgres и valkey новый StartedAt)
make test_isolated
103 passed, 12 deselected — results: {'test': 0, 'student_test': 0}
make failure_checks
12 passed, 103 deselected in 35.98s — results: {'fault': 0}
make bench_restore_quick
size 10k: restored 13623 of 14501 messages (878 lost after the snapshot), RTO 3.32s;
stale chat GET 200 POST 500, after FLUSHALL 404
Ограничения / известные ошибки: открытых дефектов нет (KNOWN_ISSUES.md). Ограничения:
backup только логический, на том же хосте, без архивации WAL и PITR: RPO — время с начала последнего backup;
один Docker-host и один процесс API: пропускную способность ограничивает CPU API
кэш снимает с Postgres чтения карточки чата, но ускорения ответа на этом стенде не показано;
частота входа не ограничена (429 нет), истёкшие сессии не вычищаются;
из Swagger UI войти можно только с паролем из ASCII.
Полный список — REPORT.md, «Ограничения и следующие шаги». Согласования с преподавателем: FastAPI с его расхождениями (2026-09-26) и config.toml, монтируемый при запуске (2026-09-29).
Источники и использование ИИ: документация PostgreSQL 18, SQLAlchemy 2.1, alembic, asyncpg, redis-py, Valkey, argon2-cffi, RFC 7617 и RFC 9106, k6. Claude (Claude Code) помогал проектировать changes OpenSpec, писать код, тесты и отчёт и проверял поведение на стенде; все решавтором, поведение подтверждено выводами в evidence/. Подробно — REPORT.md,последний раздел.
Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; приложен реальный вывод.
Сценарии отказов/безопасности своего уровня воспроизведены.
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2
Автор / группа: Сафронов Роман Николаевич, БВТ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: трек 2 — план запроса и восстановление
**Что реализовано и что перенесено:**
- Перенесён минимум лабы 1 (FastAPI, Python 3.12) с объявленным переходом 1 → 2: `MemoryStore` заменён PostgreSQL 18, `X-User-Id` — Bearer-сессией, при регистрации нужен пароль.
- PostgreSQL — источник истины: users, chats, chat_members, messages, sessions; PK/FK, UNIQUE `username`, CHECK по контракту; миграции alembic отдельным сервисом `migrate` до старта API, повторный запуск ничего не меняет. Чат с участниками создаётся в одной транзакции.
- Пароли — Argon2id (RFC 9106 low-memory), считаются в потоке со своим лимитом. Basic — только на `POST /auth/sessions`, остальное — opaque Bearer (256 бит, в БД только SHA-256), срок `[auth] session_ttl_seconds`, мгновенный отзыв. `X-User-Id` игнорируется.
- Уровень 4: Valkey 9.1 — кэш карточек чатов (cache-aside, истина в PostgreSQL, TTL 3600 с, LRU в 64 МБ; инвалидация не нужна — по контракту чаты неизменяемы). Если Valkey отказал, запрос идёт в обход кэша: задержка не больше 0,2 с, ответ тот же. Пул 10 + 5, таймауты на подключение, ожидание соединения, `statement_timeout` и весь запрос; БД недоступна — 503 `unavailable`, а не 401 и не анонимный доступ. Индекс истории `(chat_id, created_at, id)` + keyset обоснованы `EXPLAIN (ANALYZE, BUFFERS)` на 10k / 100k / 500k.
- Трек 2, часть 1: 110k / 200k / 600k сообщений в 1 111 чатах от 10 до 500 000; сравнены 6 вариантов индекса и запроса и стоимость записи по 4 вариантам. Индекс приложения: 5–55 буферов на любой странице любого чата. `OR`-курсор: 252 338 буферов на середине чата 500k. `covering`: 5 буферов, но сообщение из 4000 символов не вставляется. Индекс оставлен по правилу выбора, записанному до замера.
- Трек 2, часть 2: `pg_dump` под нагрузкой записи → `pg_restore -j 4` в новый контейнер на новом volume → построчная сверка (md5 полей каждого сообщения) и сверка через HTTP. Всё, что было до backup, восстановлено; потеряны только записи после снимка. RTO 2,9–4,8 с; после восстановления обязателен `FLUSHALL` (измерено).
- Свои тесты: `student-tests/` (black-box по HTTP, pytest) и отдельный стенд для проверок отказов.
**Команды запуска из чистого clone:**
git clone -b solution/bvt2301-safronov <fork> && cd <каталог>
make run_docker # .env и config.toml со случайными паролями → build → postpi
curl -s localhost:8080/health/ready
make check && make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test_isolated # образ на временной базе: smoke + student-tests (нужен uv
make failure_checks # проверки отказов уровня 4 на отдельном стенде, ~45 с
make bench_quick && make bench_restore_quick # трек 2 на малых размерах, ~3 и
Подробно, включая `make run_dev`, — `REPORT.md`, раздел «Запуск из чистого clone».
**Результаты проверок и ссылка на REPORT.md:** [REPORT.md](https://gitea.privcloud.2-safronov/src/branch/solution/bvt2301-safronov/REPORT.md), выводы — в `evidence/`.
Вывод из чистого clone `c6ad34d` на пустом volume, 2026-10-02:
make check
PASS: offline skeleton structure, local refs and Python syntax; application NOT
make validate PYTHON=.venv/bin/python
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
make test
PASS: lab2 public API scenario; infrastructure and grading evidence remain sepa
make test-persistence ACTION_SCRIPT=scripts/restart.sh
PASS: persistence preserved confirmed data and existing session. Hook scope nee
(у api, postgres и valkey новый StartedAt)
make test_isolated
103 passed, 12 deselected — results: {'test': 0, 'student_test': 0}
make failure_checks
12 passed, 103 deselected in 35.98s — results: {'fault': 0}
make bench_restore_quick
size 10k: restored 13623 of 14501 messages (878 lost after the snapshot), RTO 3.32s;
stale chat GET 200 POST 500, after FLUSHALL 404
**Ограничения / известные ошибки:** открытых дефектов нет (`KNOWN_ISSUES.md`). Ограничения:
- backup только логический, на том же хосте, без архивации WAL и PITR: RPO — время с начала последнего backup;
- один Docker-host и один процесс API: пропускную способность ограничивает CPU API
- кэш снимает с Postgres чтения карточки чата, но ускорения ответа на этом стенде не показано;
- частота входа не ограничена (429 нет), истёкшие сессии не вычищаются;
- из Swagger UI войти можно только с паролем из ASCII.
Полный список — `REPORT.md`, «Ограничения и следующие шаги». Согласования с преподавателем: FastAPI с его расхождениями (2026-09-26) и `config.toml`, монтируемый при запуске (2026-09-29).
**Источники и использование ИИ:** документация PostgreSQL 18, SQLAlchemy 2.1, alembic, asyncpg, redis-py, Valkey, argon2-cffi, RFC 7617 и RFC 9106, k6. Claude (Claude Code) помогал проектировать changes OpenSpec, писать код, тесты и отчёт и проверял поведение на стенде; все решавтором, поведение подтверждено выводами в `evidence/`. Подробно — `REPORT.md`,последний раздел.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Copy the committed lab 1 sources as-is: src/, student-tests/, bench/,
Dockerfile, docker-compose.yml, pyproject.toml, uv.lock,
.python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/,
openspec/, .graphifyignore and KNOWN_ISSUES.md. Lab 1 evidence stays
in the lab 1 repository.
Merge the new skeleton files with own sections: Makefile (lab 2
targets plus own run, docker, bench and common targets), .gitignore,
.dockerignore and .env.example. Rename the image to
mtusi-messenger:lab2 and point AGENTS.md at lab 2.
The application is still the in-memory lab 1 implementation.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Describe the lab 2 target in AGENTS.md and the layer rules: PostgreSQL
as the source of truth, Basic login and Bearer sessions, Redis or
Valkey on grade 4, compose stand with pinned images, named volumes and
the restart hook, migrations before the API, level 4 checks.
Add .claude/rules/auth.md for password hashing, Basic parsing, session
tokens, expiry and revocation. Record that FastAPI HTTPBasic decodes
credentials as ASCII and cannot parse UTF-8 passwords.
Add a transitional section to AGENTS.md: the code is still the lab 1
in-memory implementation until the OpenSpec changes land.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replace the in-memory store with PostgreSQL 18.6: SQLAlchemy 2.1 async
engine on asyncpg, alembic migrations with an async env.py, repos on
AsyncSession and services that own the transaction. Username
uniqueness is enforced by the database (ON CONFLICT), a chat and its
members are created in one transaction, member order is kept in
chat_members.position, and a composite foreign key makes the sender a
member of the chat. History and chat lists use keyset pagination on
(chat_id, created_at, id) and (user_id, created_at, chat_id).
The compose stand runs postgres, a one-shot migrate service on the
API image and the API. All Postgres addresses come from .env without
literals; only the 127.0.0.1 publish address stays literal. make
run_dev starts Postgres and applies migrations before the server, and
make env_setup generates a random Postgres password.
Unavailable PostgreSQL yields 503: get_db_session bounds the request
with asyncio and classifies driver errors. BoundedCloseConnection
limits asyncpg's graceful close, which otherwise waited without limit
on a frozen server and held the request until it was resumed.
Add scripts/restart.sh for make test-persistence and make
test_isolated, which runs the image on a throwaway test database.
Remove make run_no_compose. X-User-Id identification is unchanged
until the session-auth change.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
uv run forwards SIGINT to the child that already got it from the
process group, so the second KeyboardInterrupt aborted the cleanup and
left the test container and database behind. Run the script with
$(PYTHON) like the skeleton checks and ignore SIGINT during cleanup.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- keep engine and session factory in src/infra/db/session.py
- sync delta specs into openspec/specs, add db-migrations spec
- update rules, AGENTS.md and run skill for lab 2 storage
- fill REPORT.md for the storage part
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- migrations from zero, schema and rerun on 2d0a7c8
- restart hook, database outage, pool timeout, postgres port
- make test_isolated mechanics: failure, stop, Ctrl+C, kill -9, keep db
- align REPORT.md numbers with the new evidence
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- hide_parameters=True in the engine, rule in infra.md
- design: 79 of 80 tests, $(PYTHON) for test_isolated
- AGENTS.md: hand off deferred scenarios
- REPORT.md: unknown outcome of a timed-out commit
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- statement timeout: 503 and no SQL parameters in logs, before and after
- failed migration keeps the API from starting
- fresh clone: console from zero, then docker and make down
- restart evidence with docker compose ps
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Argon2id password hashes, KDF in a thread with its own limit
- POST /auth/sessions with Basic, DELETE /auth/sessions/current
- Bearer sessions in PostgreSQL, X-User-Id ignored
- migration drops lab 1 data without passwords
- student-tests on tokens, sessions spec and synced specs
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- passwords and tokens: Argon2id hashes, no secrets in db and logs
- session expiry and database outage with a valid token
- make test-persistence and make test_isolated on ae4154e
- migration drops lab 1 data without passwords
- REPORT.md: sessions, defense scenario, evidence rows
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- lifespan computes the dummy Argon2id hash: first unknown-user login
takes as long as a wrong password
- evidence for session TTL from config.toml, default and environment
- REPORT.md: manual /docs check, TTL configuration row
- tasks.md: why checks ran on a separate dev database
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Valkey 9.1 in compose caches the immutable chat card (title, members,
created_at) used by GET /chats/{id} and by the membership check of the
message endpoints. Cache-aside with a write after commit, keys per
database, TTL plus allkeys-lru, persistence off. redis-py runs without
retries; on failure the cache is skipped for a few seconds and requests
go to PostgreSQL. Readiness does not depend on Valkey.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Evidence from cae4b09: cache hits against chats table reads, Valkey
stop/pause/restart and FLUSHALL, restart hook with Valkey, Valkey ports
and password from .env, and a fresh make test_isolated run (103 tests).
REPORT.md describes the role of Valkey, the service table and the new
level 4 rows. The cache-read check now counts seq_scan + idx_scan: the
small chats table is read by sequential scan.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The client passed the sync redis.retry.Retry to async connections, so no
retry could ever run. Use redis.asyncio.retry.Retry with one immediate
retry on ConnectionError only: after a Valkey restart the stale pooled
connection is reopened instead of switching the cache off for 5 s.
Timeouts are not retried, and asyncio.timeout bounds each cache command
(pool wait, connect, retry, reply) by [cache] timeout_seconds.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Evidence from d7c9a59: Valkey stop adds 97 ms (one reconnect), pause
207 ms, 30 concurrent commands stay within 201 ms, and restarting Valkey
alone no longer switches the cache off. REPORT.md and the skill describe
the retry on a dropped connection.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
make failure_checks brings up a throwaway compose project with its own
PostgreSQL and Valkey, a default and a tight API (2 s sessions, pool of
one), and runs the pytest tests marked fault through an explicit hook:
session expiry, database stop and return, pool exhaustion, chat creation
rollback, readiness, Valkey stop, hang, return and flush. The stand and
its volume are removed on any outcome; the working stand is untouched.
Regular runs deselect the fault tests, and 13 coverage exclusions go away.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Evidence from 5b65051: make failure_checks passes 12 checks in 45 s and
leaves the working stand untouched (same StartedAt and row counts);
make test_isolated reports 98 of 108 scenarios tested, 13 of them by the
failure checks. REPORT.md gets the level 4 rows for automatic expiry,
database and Valkey checks and the chat creation rollback. The spec and
rule note that two failure check runs must not overlap.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
cleanup() now also requires that no container of the failure project is
left, not only volumes. REPORT.md says where uv is needed (run_dev and
the own test commands), the hook notes that CACHE_KEY_PREFIX is a copy,
and the student-tests spec names the sessions capability consistently.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- bench stand is a separate compose project mtusi-bench (API, Postgres,
Valkey) with fixed limits, fresh volume per size and migrations
- k6 registers with a password, logs in with Basic and sends Bearer
- VACUUM (ANALYZE) and CHECKPOINT after prefill
- EXPLAIN (ANALYZE, BUFFERS) of the app's history query via auto_explain,
plus the same query without the index in a rolled back transaction
- Postgres CPU, table and index size in results; storages in passport
- bench_compare checks storage limits, images and settings
- remove inproc.py and make bench_inproc
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 2
Автор / группа: Сафронов Роман Николаевич, БВТ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: трек 2 — план запроса и восстановление
Что реализовано и что перенесено:
MemoryStoreзаменён PostgreSQL 18,X-User-Id— Bearer-сессией, при регистрации нужен пароль.username, CHECK по контракту; миграции alembic отдельным сервисомmigrateдо старта API, повторный запуск ничего не меняет. Чат с участниками создаётся в одной транзакции.POST /auth/sessions, остальное — opaque Bearer (256 бит, в БД только SHA-256), срок[auth] session_ttl_seconds, мгновенный отзыв.X-User-Idигнорируется.statement_timeoutи весь запрос; БД недоступна — 503unavailable, а не 401 и не анонимный доступ. Индекс истории(chat_id, created_at, id)+ keyset обоснованыEXPLAIN (ANALYZE, BUFFERS)на 10k / 100k / 500k.OR-курсор: 252 338 буферов на середине чата 500k.covering: 5 буферов, но сообщение из 4000 символов не вставляется. Индекс оставлен по правилу выбора, записанному до замера.pg_dumpпод нагрузкой записи →pg_restore -j 4в новый контейнер на новом volume → построчная сверка (md5 полей каждого сообщения) и сверка через HTTP. Всё, что было до backup, восстановлено; потеряны только записи после снимка. RTO 2,9–4,8 с; после восстановления обязателенFLUSHALL(измерено).student-tests/(black-box по HTTP, pytest) и отдельный стенд для проверок отказов.Команды запуска из чистого clone:
Подробно, включая
make run_dev, —REPORT.md, раздел «Запуск из чистого clone».Результаты проверок и ссылка на REPORT.md: REPORT.md, выводы — в
evidence/.Вывод из чистого clone
c6ad34dна пустом volume, 2026-10-02:Ограничения / известные ошибки: открытых дефектов нет (
KNOWN_ISSUES.md). Ограничения:Полный список —
REPORT.md, «Ограничения и следующие шаги». Согласования с преподавателем: FastAPI с его расхождениями (2026-09-26) иconfig.toml, монтируемый при запуске (2026-09-29).Источники и использование ИИ: документация PostgreSQL 18, SQLAlchemy 2.1, alembic, asyncpg, redis-py, Valkey, argon2-cffi, RFC 7617 и RFC 9106, k6. Claude (Claude Code) помогал проектировать changes OpenSpec, писать код, тесты и отчёт и проверял поведение на стенде; все решавтором, поведение подтверждено выводами в
evidence/. Подробно —REPORT.md,последний раздел.Valkey 9.1 in compose caches the immutable chat card (title, members, created_at) used by GET /chats/{id} and by the membership check of the message endpoints. Cache-aside with a write after commit, keys per database, TTL plus allkeys-lru, persistence off. redis-py runs without retries; on failure the cache is skipped for a few seconds and requests go to PostgreSQL. Readiness does not depend on Valkey. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>Принято
Закрываю
Pull request closed