ЛР 2 — БВТ2303 — Васюкова — на 5 #6

Closed
Vasyukova-Nat wants to merge 53 commits from Vasyukova-Nat/mtusi2026lab2:solution/BVT2303-Vasyukova into master
First-time contributor

Лабораторная 2

Автор / группа: Васюкова Наталья, БВТ2303
Целевая оценка: 5
Трек 5: Трек 2 — План запроса и восстановление

Что реализовано и что перенесено: Перенесён минимум lab1 (FastAPI, Pydantic-схемы, middleware X-Request-Id, структурные логи, SIGTERM, Dockerfile multi-stage non-root, .dockerignore, негативные и конкурентные тесты). Добавлено для lab2 уровня 3: PostgreSQL как источник истины (users/chats/chat_members/messages), идемпотентные миграции init_schema(), регистрация с password KDF (scrypt), Basic → opaque Bearer-сессия с TTL и logout, атомарное создание чата, keyset-пагинация истории в SQL. Уровень 4: Redis для серверных сессий с AOF-persistence, ограниченный пул psycopg_pool со statement_timeout, EXPLAIN на ≥10 000 сообщениях, конкурентная регистрация без дублей, обработка недоступности Redis/PostgreSQL через 503, тесты уровня 4. Уровень 5 (Трек 2): сидирование ≥100 000 сообщений с неравномерными чатами, сравнение трёх вариантов индексов через EXPLAIN (ANALYZE, BUFFERS), замер стоимости записи, pg_dump → pg_restore в отдельный контейнер со сверкой COUNT и 100 случайных сообщений, проверка границ RPO.

Команды запуска из чистого clone:

git clone https://gitflic.ru/project/vasyukova-nat/mtusi2026lab2.git && cd mtusi2026lab2
git checkout solution/BVT2303-Vasyukova
copy .env.example .env
docker compose --env-file .env up -d --build
curl.exe -s http://localhost:8080/health/ready    # {"status":"ok"}

Проверки: python scripts/check_contract.py, python scripts/validate_openapi.py, python tests/smoke.py --base-url http://localhost:8080, python student-tests/run_all.py --base-url http://localhost:8080, python tests/resilience.py --mode persistence --action-script scripts/restart.bat --base-url http://localhost:8080, python student-tests/test_track2.py --base-url http://localhost:8080.

Результаты проверок и ссылка на REPORT.md: Все обязательные проверки lab2 и трек 2 пройдены — PASS. Подробности, таблица критериев, эксперименты и отказы — в REPORT.md. Доказательства: evidence/lab2_track2_explain.md, evidence/lab2_track2_write_cost.json.

Ограничения / известные ошибки: storage/memory.py оставлен как референс lab1 и не используется. SESSION_STORE=postgres — fallback для сравнения; рабочий режим — redis. Один Docker-host: HA БД/LB и потеря хоста не проверяются. Трек 2: абсолютные числа EXPLAIN/RTO зависят от железа; pg_dump даёт snapshot на момент старта, поэтому RPO > 0 без потоковой репликации/WAL-архива (вне рамок трека).

Источники и использование ИИ: Контракт — contracts/openapi.json, contracts/README.md. Инструкции — README.md, COURSE.md, CONTRIBUTING.md. Библиотеки: fastapi==0.115.0, uvicorn[standard]==0.32.0, psycopg[binary]==3.2.3, psycopg_pool==3.2.3, redis==5.2.0. ИИ: DeepSeek — помощь в структурировании кода и отчёта; весь код проверен, отредактирован и запущен автором.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Васюкова Наталья, БВТ2303 Целевая оценка: 5 Трек 5: Трек 2 — План запроса и восстановление Что реализовано и что перенесено: Перенесён минимум lab1 (FastAPI, Pydantic-схемы, middleware X-Request-Id, структурные логи, SIGTERM, Dockerfile multi-stage non-root, .dockerignore, негативные и конкурентные тесты). Добавлено для lab2 уровня 3: PostgreSQL как источник истины (users/chats/chat_members/messages), идемпотентные миграции init_schema(), регистрация с password KDF (scrypt), Basic → opaque Bearer-сессия с TTL и logout, атомарное создание чата, keyset-пагинация истории в SQL. Уровень 4: Redis для серверных сессий с AOF-persistence, ограниченный пул psycopg_pool со statement_timeout, EXPLAIN на ≥10 000 сообщениях, конкурентная регистрация без дублей, обработка недоступности Redis/PostgreSQL через 503, тесты уровня 4. Уровень 5 (Трек 2): сидирование ≥100 000 сообщений с неравномерными чатами, сравнение трёх вариантов индексов через EXPLAIN (ANALYZE, BUFFERS), замер стоимости записи, pg_dump → pg_restore в отдельный контейнер со сверкой COUNT и 100 случайных сообщений, проверка границ RPO. Команды запуска из чистого clone: ``` git clone https://gitflic.ru/project/vasyukova-nat/mtusi2026lab2.git && cd mtusi2026lab2 git checkout solution/BVT2303-Vasyukova copy .env.example .env docker compose --env-file .env up -d --build curl.exe -s http://localhost:8080/health/ready # {"status":"ok"} ``` Проверки: `python scripts/check_contract.py`, `python scripts/validate_openapi.py`, `python tests/smoke.py --base-url http://localhost:8080`, `python student-tests/run_all.py --base-url http://localhost:8080`, `python tests/resilience.py --mode persistence --action-script scripts/restart.bat --base-url http://localhost:8080`, `python student-tests/test_track2.py --base-url http://localhost:8080`. Результаты проверок и ссылка на REPORT.md: Все обязательные проверки lab2 и трек 2 пройдены — PASS. Подробности, таблица критериев, эксперименты и отказы — в [REPORT.md](REPORT.md). Доказательства: `evidence/lab2_track2_explain.md`, `evidence/lab2_track2_write_cost.json`. Ограничения / известные ошибки: `storage/memory.py` оставлен как референс lab1 и не используется. `SESSION_STORE=postgres` — fallback для сравнения; рабочий режим — `redis`. Один Docker-host: HA БД/LB и потеря хоста не проверяются. Трек 2: абсолютные числа EXPLAIN/RTO зависят от железа; `pg_dump` даёт snapshot на момент старта, поэтому RPO > 0 без потоковой репликации/WAL-архива (вне рамок трека). Источники и использование ИИ: Контракт — `contracts/openapi.json`, `contracts/README.md`. Инструкции — `README.md`, `COURSE.md`, `CONTRIBUTING.md`. Библиотеки: fastapi==0.115.0, uvicorn[standard]==0.32.0, psycopg[binary]==3.2.3, psycopg_pool==3.2.3, redis==5.2.0. ИИ: DeepSeek — помощь в структурировании кода и отчёта; весь код проверен, отредактирован и запущен автором. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Vasyukova-Nat added 31 commits 2026-10-02 15:57:43 +03:00
* обновила гитигнор
Skeleton contracts / contracts (pull_request) Canceled after 0s
3a6e19b08e
Vasyukova-Nat added 2 commits 2026-10-02 16:57:42 +03:00
Vasyukova-Nat added 1 commit 2026-10-02 17:01:13 +03:00
* обновила вызови compose-сети
Skeleton contracts / contracts (pull_request) Canceled after 0s
9d2fb91bdf
Vasyukova-Nat added 1 commit 2026-10-02 17:07:50 +03:00
* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s
8513657d39
Vasyukova-Nat added 1 commit 2026-10-02 17:11:24 +03:00
* обновила имена томов
Skeleton contracts / contracts (pull_request) Canceled after 0s
a134cd3f9c
Vasyukova-Nat added 2 commits 2026-10-02 17:33:17 +03:00
Vasyukova-Nat added 1 commit 2026-10-02 17:35:23 +03:00
* обновила test_track2.py
Skeleton contracts / contracts (pull_request) Canceled after 0s
2e66c68cff
Vasyukova-Nat added 1 commit 2026-10-02 17:40:44 +03:00
* обновила test_track2.py
Skeleton contracts / contracts (pull_request) Canceled after 0s
f9782daa2f
Vasyukova-Nat added 3 commits 2026-10-02 20:33:28 +03:00
Vasyukova-Nat added 1 commit 2026-10-02 20:44:15 +03:00
* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s
9aed0047d4
Vasyukova-Nat added 1 commit 2026-10-02 20:56:49 +03:00
* обновила начальное условие для seed
Skeleton contracts / contracts (pull_request) Canceled after 0s
ed3bb755cf
Vasyukova-Nat added 1 commit 2026-10-02 20:59:16 +03:00
* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s
6c282f2b09
Vasyukova-Nat added 1 commit 2026-10-02 21:11:47 +03:00
* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s
05d4a91561
Vasyukova-Nat added 1 commit 2026-10-03 00:18:16 +03:00
* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s
67d9c9af20
Vasyukova-Nat added 1 commit 2026-10-03 00:52:52 +03:00
* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s
a4e0828f36
Owner

Дополните автоматические проверки уровня 4:

  1. Проверка гонки регистрации.
    В student-tests/test_lab2_level4.py, начиная со строки 47, любое исключение Failure записывается как результат 409. Поэтому timeout, ответ 500 или ошибка формата ответа могут ошибочно засчитаться как ожидаемый конфликт.
    Нужно проверять фактические HTTP-коды: при восьми одновременных регистрациях одного username — ровно одна 201 и семь 409. Дополнительно проверить, что в БД создана одна строка пользователя. Остальные ошибки должны проваливать тест.

  2. Проверка недоступности PostgreSQL.
    Есть тест остановки Redis, но нет аналогичного теста БД.
    Нужно остановить PostgreSQL и проверить:

    • /health/ready возвращает 503;
    • запрос с действующим токеном возвращает 503 в пределах настроенного таймаута;
    • анонимный запрос не получает доступ;
    • после запуска БД прежний токен работает, ранее записанные данные сохранились.

    Восстановление БД следует выполнять в finally, чтобы не оставлять стенд остановленным при падении теста.

  3. Проверка Redis с действующим токеном.
    Сейчас тест использует заведомо неправильный Bearer-токен. Такой запрос мог бы вернуть 401 даже без обращения к Redis.
    Нужно заранее получить рабочую сессию, остановить Redis и проверить запрос с этим токеном. После восстановления Redis проверить, что прежняя сессия снова работает.

  4. Проверка rollback составной операции.
    Нужно вызвать ошибку вставки участников после успешной вставки строки чата и проверить, что ни чат, ни частично добавленное членство не сохранились.
    Отклонение неизвестного участника до первого INSERT не доказывает rollback: транзакция ещё не успела частично изменить данные.

При независимой проверке гонка регистрации, rollback и обработка отказов работали корректно. Замечания относятся к полноте и достоверности собственных автотестов. Expiry, logout и неверный пароль уже покрыты собственными и публичными проверками.

Дополните автоматические проверки уровня 4: 1. **Проверка гонки регистрации.** В `student-tests/test_lab2_level4.py`, начиная со строки 47, любое исключение `Failure` записывается как результат 409. Поэтому timeout, ответ 500 или ошибка формата ответа могут ошибочно засчитаться как ожидаемый конфликт. Нужно проверять фактические HTTP-коды: при восьми одновременных регистрациях одного username — ровно одна 201 и семь 409. Дополнительно проверить, что в БД создана одна строка пользователя. Остальные ошибки должны проваливать тест. 2. **Проверка недоступности PostgreSQL.** Есть тест остановки Redis, но нет аналогичного теста БД. Нужно остановить PostgreSQL и проверить: - `/health/ready` возвращает 503; - запрос с действующим токеном возвращает 503 в пределах настроенного таймаута; - анонимный запрос не получает доступ; - после запуска БД прежний токен работает, ранее записанные данные сохранились. Восстановление БД следует выполнять в `finally`, чтобы не оставлять стенд остановленным при падении теста. 3. **Проверка Redis с действующим токеном.** Сейчас тест использует заведомо неправильный Bearer-токен. Такой запрос мог бы вернуть 401 даже без обращения к Redis. Нужно заранее получить рабочую сессию, остановить Redis и проверить запрос с этим токеном. После восстановления Redis проверить, что прежняя сессия снова работает. 4. **Проверка rollback составной операции.** Нужно вызвать ошибку вставки участников после успешной вставки строки чата и проверить, что ни чат, ни частично добавленное членство не сохранились. Отклонение неизвестного участника до первого INSERT не доказывает rollback: транзакция ещё не успела частично изменить данные. При независимой проверке гонка регистрации, rollback и обработка отказов работали корректно. Замечания относятся к полноте и достоверности собственных автотестов. Expiry, logout и неверный пароль уже покрыты собственными и публичными проверками.
Author
First-time contributor

Исправила

Исправила
Vasyukova-Nat added 1 commit 2026-10-03 01:52:05 +03:00
* обновила тесты
Skeleton contracts / contracts (pull_request) Canceled after 0s
2da4def0ca
Vasyukova-Nat added 1 commit 2026-10-03 01:58:32 +03:00
* обновила отчет
Skeleton contracts / contracts (pull_request) Canceled after 0s
54cefb6952
Vasyukova-Nat added 2 commits 2026-10-03 02:05:56 +03:00
Owner

Принято.
Закрываю.

Принято. Закрываю.
veprickiy closed this pull request 2026-10-03 13:12:21 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#6