ЛР 3 — БВТ2302 — Ким — на 3 #121

Closed
ddientee wants to merge 1 commits from ddientee/mtusi2026lab3:solution/bvt2302-kim into main
First-time contributor

FastAPI + PostgreSQL как единый источник истины: пользователи, Basic/Bearer-сессии, чаты, сообщения. Сессии и идемпотентные ключи хранятся в БД, поэтому реплики взаимозаменяемы. Общая идемпотентность POST сообщения по Idempotency-Key, включая конкурентный повтор через разные реплики. compose.yaml: postgres, one-shot migrate, api1, api2 и nginx как единственная публичная точка входа. Добавлены scripts/stop-one.sh и scripts/restart.sh, student-tests, evidence и заполненный REPORT.md.

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

Автор / группа: Ким Владимир, БВТ2302
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: -

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

REST API на FastAPI: пользователи, Basic → Bearer-сессии (scrypt-пароли, SHA-256 токена в БД), чаты, сообщения, health. Keyset-пагинация, единый формат ошибок, X-Request-Id/X-Instance-Id. PostgreSQL — единственное состояние; локальных сессий и идемпотентных ключей в API нет. Идемпотентность через PK (user_id, method, path, key) и одну транзакцию «сообщение + ответ», TTL 24 ч, 409 при другом body. Инфраструктура: postgres, one-shot migrate с advisory lock, api1, api2, nginx — единственный публичный порт :8080; healthchecks, лимиты CPU/RAM, graceful shutdown. Отдельного кода lab2 в репозитории нет, его минимум реализован здесь же.

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

cp .env.example .env
docker compose --env-file .env up -d --build
curl -fsS http://localhost:8080/health/ready
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh

Результаты проверок и ссылка на REPORT.md:

make check — PASS, smoke — PASS. Одна сессия обслуживается api-1 и api-2 без повторного входа. Отказ каждой реплики: 85–90 записей, 0 ошибок, восстановление ~0.55 с, подтверждённые сообщения на месте, дублей нет. Persistence — PASS. 40 конкурентных POST с одним ключом дали ровно одно сообщение. Нагрузка 15 с / 4 потока: 3722 запроса, 0 ошибок, 247.6 RPS, p95 32 мс. Сырые выводы — в evidence/.

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

Один Docker-host: PostgreSQL и nginx — SPOF, отказ узла не выдерживается. После восстановления реплика может отсутствовать в пуле до fail_timeout=5s (лечится restart lb). Просроченные ключи чистятся лениво. Redis/Valkey, TLS, rate limiting, вложения, телеметрия не реализованы. На Windows-хосте нет make, поэтому цели выполнены эквивалентными командами (resilience — в Linux-контейнере); на Linux/macOS Makefile работает как есть.

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

contracts/,
README.md
, tests/; FastAPI 0.115.0, uvicorn 0.30.6, psycopg 3.2.3, PostgreSQL 16.4, Nginx 1.26.2. все проверки воспроизведены локально.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
FastAPI + PostgreSQL как единый источник истины: пользователи, Basic/Bearer-сессии, чаты, сообщения. Сессии и идемпотентные ключи хранятся в БД, поэтому реплики взаимозаменяемы. Общая идемпотентность POST сообщения по Idempotency-Key, включая конкурентный повтор через разные реплики. compose.yaml: postgres, one-shot migrate, api1, api2 и nginx как единственная публичная точка входа. Добавлены scripts/stop-one.sh и scripts/restart.sh, student-tests, evidence и заполненный REPORT.md. ## Лабораторная 3 Автор / группа: Ким Владимир, БВТ2302 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: - Что реализовано и что перенесено: REST API на FastAPI: пользователи, Basic → Bearer-сессии (scrypt-пароли, SHA-256 токена в БД), чаты, сообщения, health. Keyset-пагинация, единый формат ошибок, X-Request-Id/X-Instance-Id. PostgreSQL — единственное состояние; локальных сессий и идемпотентных ключей в API нет. Идемпотентность через PK (user_id, method, path, key) и одну транзакцию «сообщение + ответ», TTL 24 ч, 409 при другом body. Инфраструктура: postgres, one-shot migrate с advisory lock, api1, api2, nginx — единственный публичный порт :8080; healthchecks, лимиты CPU/RAM, graceful shutdown. Отдельного кода lab2 в репозитории нет, его минимум реализован здесь же. Команды запуска из чистого clone: cp .env.example .env docker compose --env-file .env up -d --build curl -fsS http://localhost:8080/health/ready make check make test make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh Результаты проверок и ссылка на REPORT.md: make check — PASS, smoke — PASS. Одна сессия обслуживается api-1 и api-2 без повторного входа. Отказ каждой реплики: 85–90 записей, 0 ошибок, восстановление ~0.55 с, подтверждённые сообщения на месте, дублей нет. Persistence — PASS. 40 конкурентных POST с одним ключом дали ровно одно сообщение. Нагрузка 15 с / 4 потока: 3722 запроса, 0 ошибок, 247.6 RPS, p95 32 мс. Сырые выводы — в evidence/. Ограничения / известные ошибки: Один Docker-host: PostgreSQL и nginx — SPOF, отказ узла не выдерживается. После восстановления реплика может отсутствовать в пуле до fail_timeout=5s (лечится restart lb). Просроченные ключи чистятся лениво. Redis/Valkey, TLS, rate limiting, вложения, телеметрия не реализованы. На Windows-хосте нет make, поэтому цели выполнены эквивалентными командами (resilience — в Linux-контейнере); на Linux/macOS Makefile работает как есть. Источники и использование ИИ: contracts/, README.md , tests/; FastAPI 0.115.0, uvicorn 0.30.6, psycopg 3.2.3, PostgreSQL 16.4, Nginx 1.26.2. все проверки воспроизведены локально. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
ddientee added 1 commit 2026-11-07 16:14:25 +03:00
FastAPI + PostgreSQL как единый источник истины: пользователи, Basic/Bearer-сессии, чаты, сообщения. Сессии и идемпотентные ключи хранятся в БД, поэтому реплики взаимозаменяемы. Общая идемпотентность POST сообщения по Idempotency-Key, включая конкурентный повтор через разные реплики. compose.yaml: postgres, one-shot migrate, api1, api2 и nginx как единственная публичная точка входа. Добавлены scripts/stop-one.sh и scripts/restart.sh, student-tests, evidence и заполненный REPORT.md.
ddientee changed title from Реализовать стенд лабораторной 3: две API-реплики и балансировка to ЛР 3 — БВТ2302 — Ким — на 3 2026-11-07 16:14:56 +03:00
andrey.derbenev closed this pull request 2026-11-12 16:01:18 +03:00

Pull request closed

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

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#121