ЛР 3 — БВТ2301 — Гамаюнов — на 3 #169

Closed
gamayunov2004 wants to merge 2 commits from gamayunov2004/mtusi2026lab3:solution/bvt2301-gamayunov into main
First-time contributor

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

Автор / группа: Гамаюнов Артём, БВТ2301

Целевая оценка: 3

Трек 5: не заявлен.

Что реализовано и что перенесено

Реализованы две реплики FastAPI за балансировщиком HAProxy с единой публичной точкой входа. PostgreSQL используется как общее хранилище пользователей, сессий, истории сообщений и ключей идемпотентности. Миграции выполняет отдельный сервис.

Из ЛР2 перенесены Argon2id, авторизация Basic → Bearer, TTL и отзыв сессий, контроль доступа к чатам и cursor pagination.

Добавлены X-Instance-Id, общая идемпотентность POST сообщений через Idempotency-Key и проверяемое переключение между репликами при отказе.

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

На Windows требуется Docker Desktop с Linux containers и PowerShell. Из корня репозитория:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/init-env.ps1
docker compose config --quiet
docker compose up -d --build
docker compose build tools
docker compose run --rm -T tools python student-tests/grade3.py ready
docker compose run --rm -T tools make check validate test

Дополнительные проверки:

docker compose run --rm -T tools python student-tests/grade3.py core
docker compose run --rm -T tools python student-tests/grade3.py persistence
docker compose run --rm -T tools python student-tests/grade3.py failover

Подробная инструкция, включая подготовку секретов, порядок остановки и очистку учебных данных, приведена в [REPORT.md](REPORT.md).

Результаты проверок и доказательства

  • make check, make validate, make test — PASS. [Журнал проверок](evidence/grade3/checks.txt).
  • Балансировка — PASS. Один Bearer-токен работает на обеих репликах, что подтверждено разными X-Instance-Id.
  • Идемпотентность — PASS. Конкурентные запросы с одним ключом возвращают одно сообщение без дубликатов. Разные тела с одинаковым ключом дают 201/409. Повтор после временного 503 не создаёт дубль. [Журнал](evidence/grade3/core.txt).
  • Persistence — PASS. После перезапуска PostgreSQL и API сохраняются сессия и сообщения. [Журнал](evidence/grade3/persistence.txt).
  • Failover — PASS. Обе реплики остановлены поочерёдно. Чтение и запись восстановились менее чем за 10 секунд, дубликаты не обнаружены. [Журнал](evidence/grade3/failover.txt).

Ограничения / известные ошибки

Стенд обеспечивает отказоустойчивость одной API-реплики. HAProxy, PostgreSQL и Docker host остаются единичными точками отказа. HTTP используется только в локальном учебном окружении. Удалённый CI не запускался.

Скрипты scripts/restart.sh и scripts/stop-one.sh опубликованы с Git mode 100755.

Источники и использование ИИ

Контракт и skeleton ЛР3, собственная реализация ЛР2, документация HAProxy, Docker Compose и PostgreSQL.

Codex использовался для переноса реализации, разработки, тестирования и сбора доказательств. Результаты дополнительно проверены по исходникам и сохранённым журналам.

Контрольный список

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 **Автор / группа:** Гамаюнов Артём, БВТ2301 **Целевая оценка:** 3 **Трек 5:** не заявлен. ### Что реализовано и что перенесено Реализованы две реплики FastAPI за балансировщиком HAProxy с единой публичной точкой входа. PostgreSQL используется как общее хранилище пользователей, сессий, истории сообщений и ключей идемпотентности. Миграции выполняет отдельный сервис. Из ЛР2 перенесены Argon2id, авторизация Basic → Bearer, TTL и отзыв сессий, контроль доступа к чатам и cursor pagination. Добавлены `X-Instance-Id`, общая идемпотентность POST сообщений через `Idempotency-Key` и проверяемое переключение между репликами при отказе. ### Команды запуска из чистого clone На Windows требуется Docker Desktop с Linux containers и PowerShell. Из корня репозитория: ```powershell powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/init-env.ps1 docker compose config --quiet docker compose up -d --build docker compose build tools docker compose run --rm -T tools python student-tests/grade3.py ready docker compose run --rm -T tools make check validate test ``` Дополнительные проверки: ```powershell docker compose run --rm -T tools python student-tests/grade3.py core docker compose run --rm -T tools python student-tests/grade3.py persistence docker compose run --rm -T tools python student-tests/grade3.py failover ``` Подробная инструкция, включая подготовку секретов, порядок остановки и очистку учебных данных, приведена в [[REPORT.md](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/REPORT.md)](REPORT.md). ### Результаты проверок и доказательства - **`make check`, `make validate`, `make test` — PASS.** [[Журнал проверок](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/checks.txt)](evidence/grade3/checks.txt). - **Балансировка — PASS.** Один Bearer-токен работает на обеих репликах, что подтверждено разными `X-Instance-Id`. - **Идемпотентность — PASS.** Конкурентные запросы с одним ключом возвращают одно сообщение без дубликатов. Разные тела с одинаковым ключом дают `201/409`. Повтор после временного `503` не создаёт дубль. [[Журнал](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/core.txt)](evidence/grade3/core.txt). - **Persistence — PASS.** После перезапуска PostgreSQL и API сохраняются сессия и сообщения. [[Журнал](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/persistence.txt)](evidence/grade3/persistence.txt). - **Failover — PASS.** Обе реплики остановлены поочерёдно. Чтение и запись восстановились менее чем за 10 секунд, дубликаты не обнаружены. [[Журнал](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/failover.txt)](evidence/grade3/failover.txt). ### Ограничения / известные ошибки Стенд обеспечивает отказоустойчивость одной API-реплики. HAProxy, PostgreSQL и Docker host остаются единичными точками отказа. HTTP используется только в локальном учебном окружении. Удалённый CI не запускался. Скрипты `scripts/restart.sh` и `scripts/stop-one.sh` опубликованы с Git mode `100755`. ### Источники и использование ИИ Контракт и skeleton ЛР3, собственная реализация ЛР2, документация HAProxy, Docker Compose и PostgreSQL. Codex использовался для переноса реализации, разработки, тестирования и сбора доказательств. Результаты дополнительно проверены по исходникам и сохранённым журналам. ### Контрольный список - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит токенов. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
gamayunov2004 added 1 commit 2026-11-20 16:26:12 +03:00
gamayunov2004 added 1 commit 2026-11-20 16:42:12 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-20 22:10:25 +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/mtusi2026lab3#169