From c6ddd1853b3c0293c96f5d18b78a33b29fd22eeb Mon Sep 17 00:00:00 2001 From: Markizzik Date: Fri, 13 Nov 2026 13:30:19 +0300 Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D0=BF=D0=BE=D0=BB=D0=BD=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D1=88=D0=B0=D0=B1=D0=BB=D0=BE=D0=BD=20PR=20?= =?UTF-8?q?=D0=B4=D0=BB=D1=8F=20=D0=BB=D0=B0=D0=B1=D0=BE=D1=80=D0=B0=D1=82?= =?UTF-8?q?=D0=BE=D1=80=D0=BD=D0=BE=D0=B9=203?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/pull_request_template.md | 76 +++++++++++++++++++++++++------- 1 file changed, 61 insertions(+), 15 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index e6e63eb2..fda8705c 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,64 @@ -## Лабораторная 3 +## ЛР 3 — БПИ2303 — Щербаков — на 3 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Автор / группа: Щербаков Марк Игоревич / БПИ2303. +Целевая оценка (3/4/5): **3**. +Трек 5, если заявлен: не заявляется. -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Что реализовано и что перенесено: из собственной lab2 перенесены Python API, +PostgreSQL, постоянные сессии, миграции, пагинация и собственные тесты. +Добавлены две API-реплики за HAProxy, X-Instance-Id, общая идемпотентность +сообщений с TTL 24 часа, отдельный migration job и scripts остановки/перезапуска. +Сообщение и ключ сохраняются одной транзакцией, повтор через другую реплику +возвращает прежний результат без создания дубля. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +Команды запуска из чистого 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 содержит инструкцию именно моего решения.