ЛР3 - БПИ2301 - Антонова - на 4 #89

Closed
k00kza wants to merge 2 commits from k00kza/mtusi2026lab3-fork:solution/BPI2301-Antonova into main
First-time contributor

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

Автор / группа: Антонова Ирина Андреевна, БПИ2301
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: Не заявлен

Что реализовано и что перенесено:
Из lab2 перенесены базовая бизнес-логика мессенджера, логика отзывов сессий и фильтрация по временным курсорам. В рамках lab3 реализованы: две реплики API (api-a, api-b) с балансировкой через Nginx (Round Robin), собственная проверка readiness/health в Nginx через сигнал HUP, общая идемпотентность эндпоинта отправки сообщений (POST /api/v1/chats/{chat_id}/messages) с использованием заголовка Idempotency-Key и транзакционных advisory locks в PostgreSQL, а также автоматические сценарии отказоустойчивости (failover и rolling update под нагрузкой).

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

cp env.lab3.template .env
docker compose --env-file .env up -d --build
python3 scripts/replicas.py restore
python3 tests/smoke.py --base-url "http://localhost:8080"
docker compose --env-file .env --profile test run --rm --build tests
python3 scripts/lab3_evidence.py --base-url "http://localhost:8080"

Результаты проверок и ссылка на REPORT.md:
Все автоматические проверки и нагрузочные сценарии успешно пройдены с нулевым уровнем ошибок (error_ratio: 0.0): выполнены публичный smoke-тест, проверка параллельной идемпотентности (12 запросов, 1 уникальное сообщение, код конфликта 409 при дублировании), последовательный отказ реплик api-a и api-b с замером времени восстановления, rolling update обеих реплик под нагрузкой без потери сессий, а также проверка сохранения данных (persistence) с прежним токеном. Артефакты сохранены в директории evidence/lab3/. Подробное описание приведено в REPORT.md.

Ограничения / известные ошибки:
Отказ всей машины-хоста или падение общей базы данных PostgreSQL приводит к недоступности сервиса (PostgreSQL выступает единой точкой отказа в текущей конфигурации). Смешанный rolling update со старой версией lab2 не поддерживается из-за изменения контракта API. Метрики latency и RPS отражают производительность локального Docker Desktop окружения.

Источники и использование ИИ:
Использованные технологии: FastAPI, SQLAlchemy async, asyncpg, Pydantic, Uvicorn, redis-py, Nginx, PostgreSQL, Docker Compose. Первоначальная реализация lab2 подготовлена с помощью Claude, адаптация, перенос и проверки для lab3 выполнены с помощью Codex. Официальная документация Nginx и PostgreSQL.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Антонова Ирина Андреевна, БПИ2301 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: Не заявлен Что реализовано и что перенесено: Из lab2 перенесены базовая бизнес-логика мессенджера, логика отзывов сессий и фильтрация по временным курсорам. В рамках lab3 реализованы: две реплики API (`api-a`, `api-b`) с балансировкой через Nginx (Round Robin), собственная проверка readiness/health в Nginx через сигнал HUP, общая идемпотентность эндпоинта отправки сообщений (`POST /api/v1/chats/{chat_id}/messages`) с использованием заголовка `Idempotency-Key` и транзакционных advisory locks в PostgreSQL, а также автоматические сценарии отказоустойчивости (failover и rolling update под нагрузкой). Команды запуска из чистого clone: ```sh cp env.lab3.template .env docker compose --env-file .env up -d --build python3 scripts/replicas.py restore python3 tests/smoke.py --base-url "http://localhost:8080" docker compose --env-file .env --profile test run --rm --build tests python3 scripts/lab3_evidence.py --base-url "http://localhost:8080" ``` Результаты проверок и ссылка на REPORT.md: Все автоматические проверки и нагрузочные сценарии успешно пройдены с нулевым уровнем ошибок (`error_ratio: 0.0`): выполнены публичный smoke-тест, проверка параллельной идемпотентности (12 запросов, 1 уникальное сообщение, код конфликта 409 при дублировании), последовательный отказ реплик `api-a` и `api-b` с замером времени восстановления, rolling update обеих реплик под нагрузкой без потери сессий, а также проверка сохранения данных (persistence) с прежним токеном. Артефакты сохранены в директории `evidence/lab3/`. Подробное описание приведено в `REPORT.md`. Ограничения / известные ошибки: Отказ всей машины-хоста или падение общей базы данных PostgreSQL приводит к недоступности сервиса (PostgreSQL выступает единой точкой отказа в текущей конфигурации). Смешанный rolling update со старой версией lab2 не поддерживается из-за изменения контракта API. Метрики latency и RPS отражают производительность локального Docker Desktop окружения. Источники и использование ИИ: Использованные технологии: FastAPI, SQLAlchemy async, asyncpg, Pydantic, Uvicorn, redis-py, Nginx, PostgreSQL, Docker Compose. Первоначальная реализация lab2 подготовлена с помощью Claude, адаптация, перенос и проверки для lab3 выполнены с помощью Codex. Официальная документация Nginx и PostgreSQL. * [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. * [x] Контракт и публичные тесты не ослаблены. * [x] make check и make test выполнены; приложен реальный вывод. * [x] Сценарии отказов/безопасности своего уровня воспроизведены. * [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. * [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
k00kza added 2 commits 2026-11-02 20:31:31 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-07 17:46:19 +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#89