ЛР 3 — БПИ2303 — Щербаков — на 3 #148

Closed
Exodia wants to merge 2 commits from Exodia/mtusi2026lab3:solution/BPI2303-Scherbakov into main
First-time contributor

ЛР 3 — БПИ2303 — Щербаков — на 3

Автор / группа: Щербаков Марк Игоревич / БПИ2303.
Целевая оценка (3/4/5): 3.
Трек 5, если заявлен: не заявляется.

Что реализовано и что перенесено: из собственной lab2 перенесены Python API,
PostgreSQL, постоянные сессии, миграции, пагинация и собственные тесты.
Добавлены две API-реплики за HAProxy, X-Instance-Id, общая идемпотентность
сообщений с TTL 24 часа, отдельный migration job и scripts остановки/перезапуска.
Сообщение и ключ сохраняются одной транзакцией, повтор через другую реплику
возвращает прежний результат без создания дубля.

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

python scripts/bootstrap.py
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait
python scripts/check_contract.py
python tests/smoke.py --base-url http://localhost:8080

На проверенном Windows-хосте порт 8080 недоступен: в .env установлен
APP_PORT=18083, адрес тестов — http://127.0.0.1:18083.
Для воспроизведения всех сценариев:

# Linux/macOS: предварительно chmod +x scripts/restart.sh scripts/stop-one.sh
python scripts/verify.py --base-url http://127.0.0.1:18083 --output evidence/grade3-checks.txt

Результаты проверок: публичный smoke, 14 собственных тестов, persistence,
повтор миграций и failover каждой из двух API-реплик прошли. Конкурентные
12 повторов одного ключа через две реплики создали одно сообщение.
При остановке api1/api2 первое успешное POST после завершения hook наблюдалось
через 3,359/3,016 с от его запуска, подтверждённые данные и сессии сохранены.
Переходные ошибки учтены в протоколе; после проверки обе реплики восстановлены.
Полная валидация OpenAPI также прошла.

Инструкция и разбор: REPORT.md.
Протокол: grade3-checks.txt.
Валидация контракта: contracts.txt.
На Windows Make отсутствует: выполнены эквивалентные Python-команды его целей.
Linux hooks и Make включены в CI; удалённый CI не запускался.

Ограничения / известные ошибки: один Docker-host, один LB и PostgreSQL —
точки единого отказа. Проверен отказ одной API при доступной БД, полный
рестарт проверен на сохранность данных. Нет HA БД, backup, защиты от потери
volume/host, автоматического масштабирования и rolling update. Требуется
очистка старых сессий/ключей. HTTP предназначен для локальных учебных данных.
Уровни 4/5 не заявляются.

Источники и использование ИИ: собственные lab1/lab2, контракт текущей работы,
официальная документация HAProxy, Docker Compose, PostgreSQL и psycopg
(ссылки в REPORT.md). OpenAI Codex использован для изучения материалов,
реализации, тестов и отчёта.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • Эквивалентные Python-команды make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## ЛР 3 — БПИ2303 — Щербаков — на 3 Автор / группа: Щербаков Марк Игоревич / БПИ2303. Целевая оценка (3/4/5): **3**. Трек 5, если заявлен: не заявляется. Что реализовано и что перенесено: из собственной lab2 перенесены Python API, PostgreSQL, постоянные сессии, миграции, пагинация и собственные тесты. Добавлены две API-реплики за HAProxy, X-Instance-Id, общая идемпотентность сообщений с TTL 24 часа, отдельный migration job и scripts остановки/перезапуска. Сообщение и ключ сохраняются одной транзакцией, повтор через другую реплику возвращает прежний результат без создания дубля. Команды запуска из чистого clone, из корня репозитория: ```sh python scripts/bootstrap.py docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --wait python scripts/check_contract.py python tests/smoke.py --base-url http://localhost:8080 ``` На проверенном Windows-хосте порт 8080 недоступен: в `.env` установлен `APP_PORT=18083`, адрес тестов — `http://127.0.0.1:18083`. Для воспроизведения всех сценариев: ```sh # Linux/macOS: предварительно chmod +x scripts/restart.sh scripts/stop-one.sh python scripts/verify.py --base-url http://127.0.0.1:18083 --output evidence/grade3-checks.txt ``` Результаты проверок: публичный smoke, 14 собственных тестов, persistence, повтор миграций и failover каждой из двух API-реплик прошли. Конкурентные 12 повторов одного ключа через две реплики создали одно сообщение. При остановке api1/api2 первое успешное POST после завершения hook наблюдалось через 3,359/3,016 с от его запуска, подтверждённые данные и сессии сохранены. Переходные ошибки учтены в протоколе; после проверки обе реплики восстановлены. Полная валидация OpenAPI также прошла. Инструкция и разбор: [REPORT.md](../REPORT.md). Протокол: [grade3-checks.txt](../evidence/grade3-checks.txt). Валидация контракта: [contracts.txt](../evidence/contracts.txt). На Windows Make отсутствует: выполнены эквивалентные Python-команды его целей. Linux hooks и Make включены в CI; удалённый CI не запускался. Ограничения / известные ошибки: один Docker-host, один LB и PostgreSQL — точки единого отказа. Проверен отказ одной API при доступной БД, полный рестарт проверен на сохранность данных. Нет HA БД, backup, защиты от потери volume/host, автоматического масштабирования и rolling update. Требуется очистка старых сессий/ключей. HTTP предназначен для локальных учебных данных. Уровни 4/5 не заявляются. Источники и использование ИИ: собственные lab1/lab2, контракт текущей работы, официальная документация HAProxy, Docker Compose, PostgreSQL и psycopg (ссылки в REPORT.md). OpenAI Codex использован для изучения материалов, реализации, тестов и отчёта. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] Эквивалентные Python-команды make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Exodia added 2 commits 2026-11-13 13:34:34 +03:00
Exodia changed title from Solution/bpi2303 scherbakov to ЛР 3 — БПИ2303 — Щербаков — на 3 2026-11-13 13:35:18 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-13 13:52:54 +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#148