ЛР3 - БВТ2301 - Чурилин - на 5 #51

Closed
d1frend wants to merge 6 commits from d1frend/mtusi2026lab3:solution/bvt2301-churilin into main
First-time contributor

Автор / группа: Чурилин / БВТ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: 1, «Цена масштабирования»

Что реализовано и что перенесено: Из Lab2 сохранены Go-приложение, PostgreSQL как источник истины, общие серверные сессии, миграции, пагинация и Redis-кэш. Архитектура разделена на domain/application/adapters/transport DTO. Добавлены две API-реплики за HAProxy, X-Instance-Id, общая PostgreSQL-идемпотентность, подписанные HMAC-курсоры, health/readiness, graceful shutdown, failover и rolling update.

HAProxy выполняет активные проверки /health/ready и исключает неготовые реплики, включая процесс, который остаётся живым, но потерял доступ к PostgreSQL. Автоматические повторы разрешены только для идемпотентного POST сообщений с обязательным Idempotency-Key.

Дополнительно реализован React + TypeScript + Vite frontend. Аутентификация браузера использует host-only HttpOnly-cookie и отдельный /web-api adapter; контрактные /api/v1/* остаются Bearer-only.

Для уровня 5 реализован воспроизводимый benchmark трека «Цена масштабирования»: saturation sweep, сравнение 1/2/4 реплик при фиксированном и растущем бюджете, сбор CPU/RAM, raw JSON/CSV и пять SVG-графиков.

Команды запуска из чистого clone: По инструкции в REPORT.md создать локальные Docker secrets и .env, затем выполнить:

docker compose --env-file .env up -d --build --wait

Основные проверки:

make test
make test-readiness-routing
make test-failover ACTION_SCRIPT=./scripts/stop-one.sh
make test-persistence ACTION_SCRIPT=./scripts/restart.sh
make grade4-experiment
make grade5-experiment

Результаты проверок и ссылка на REPORT.md: Все обязательные статические, Go, OpenAPI, frontend и публичные smoke-проверки пройдены. Отчёт — REPORT.md; общая сводка — evidence/lab3-summary.md; результаты уровня 4 — evidence/grade4/; readiness fault injection — evidence/readiness-routing.json; raw-данные и графики уровня 5 — evidence/grade5/.

В grade-4 эксперименте оба последовательных отказа API и rolling update прошли без ошибочных запросов. Время восстановления составило 2,893 и 2,938 с. 32 параллельных запроса с одинаковым Idempotency-Key создали ровно одно сообщение.

При потере доступа одной живой API-реплики к PostgreSQL HAProxy исключил её за 2,861 с. После исключения 40 health-запросов получили HTTP 200, а 20 регистраций — HTTP 201. После устранения fault реплика вернулась в ротацию.

В исследовании уровня 5 обнаружено ограничение CPU PostgreSQL. Увеличение лимита PostgreSQL с 1 до 2 CPU при неизменном профиле четырёх API повысило RPS с 438,868 до 587,574 (+33,88%) и снизило p95 с 109,446 до 93,991 мс (-14,12%). Ошибок в обеих фазах не было.

Ограничения / известные ошибки: Известных ошибок корректности после финального прогона не обнаружено. Стенд остаётся однохостовым; PostgreSQL и HAProxy являются single points of failure. Redis используется только как восстанавливаемый кэш. Benchmark использует один измеряемый closed-loop прогон на профиль, поэтому для production capacity planning потребуются повторные измерения, доверительные интервалы и внешний генератор нагрузки. Backend пока не предоставляет поиск пользователей, аватары, изменение профиля и unread/last-message агрегаты, поэтому frontend эти возможности не имитирует.

Источники и использование ИИ: Использованные библиотеки и инструменты перечислены в REPORT.md. ИИ использовался для анализа требований, архитектурного рефакторинга, реализации, поиска граничных случаев, тестирования и оформления отчёта. Все заявленные результаты подтверждены воспроизводимыми тестами и сохранёнными evidence.

  • Весь обязательный минимум текущей и предыдущих работ сохранён.
  • Контракт и публичные преподавательские тесты не ослаблены.
  • make check, make go-check, OpenAPI validation и make test выполнены.
  • Сценарии persistence, failover, readiness loss и rolling update воспроизведены.
  • Некорректный non-ASCII Bearer возвращает 401, а не 500.
  • Невалидный UTF-8 JSON возвращает стандартный Error с согласованным request_id.
  • Неготовая API-реплика исключается активными healthchecks HAProxy.
  • Все секреты и приватные ключи находятся вне Git.
  • README задания сохранён, REPORT.md описывает именно реализованное решение.
Автор / группа: Чурилин / БВТ2301 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: 1, «Цена масштабирования» Что реализовано и что перенесено: Из Lab2 сохранены Go-приложение, PostgreSQL как источник истины, общие серверные сессии, миграции, пагинация и Redis-кэш. Архитектура разделена на domain/application/adapters/transport DTO. Добавлены две API-реплики за HAProxy, X-Instance-Id, общая PostgreSQL-идемпотентность, подписанные HMAC-курсоры, health/readiness, graceful shutdown, failover и rolling update. HAProxy выполняет активные проверки `/health/ready` и исключает неготовые реплики, включая процесс, который остаётся живым, но потерял доступ к PostgreSQL. Автоматические повторы разрешены только для идемпотентного POST сообщений с обязательным Idempotency-Key. Дополнительно реализован React + TypeScript + Vite frontend. Аутентификация браузера использует host-only HttpOnly-cookie и отдельный `/web-api` adapter; контрактные `/api/v1/*` остаются Bearer-only. Для уровня 5 реализован воспроизводимый benchmark трека «Цена масштабирования»: saturation sweep, сравнение 1/2/4 реплик при фиксированном и растущем бюджете, сбор CPU/RAM, raw JSON/CSV и пять SVG-графиков. Команды запуска из чистого clone: По инструкции в REPORT.md создать локальные Docker secrets и `.env`, затем выполнить: `docker compose --env-file .env up -d --build --wait` Основные проверки: `make test` `make test-readiness-routing` `make test-failover ACTION_SCRIPT=./scripts/stop-one.sh` `make test-persistence ACTION_SCRIPT=./scripts/restart.sh` `make grade4-experiment` `make grade5-experiment` Результаты проверок и ссылка на REPORT.md: Все обязательные статические, Go, OpenAPI, frontend и публичные smoke-проверки пройдены. Отчёт — `REPORT.md`; общая сводка — `evidence/lab3-summary.md`; результаты уровня 4 — `evidence/grade4/`; readiness fault injection — `evidence/readiness-routing.json`; raw-данные и графики уровня 5 — `evidence/grade5/`. В grade-4 эксперименте оба последовательных отказа API и rolling update прошли без ошибочных запросов. Время восстановления составило 2,893 и 2,938 с. 32 параллельных запроса с одинаковым Idempotency-Key создали ровно одно сообщение. При потере доступа одной живой API-реплики к PostgreSQL HAProxy исключил её за 2,861 с. После исключения 40 health-запросов получили HTTP 200, а 20 регистраций — HTTP 201. После устранения fault реплика вернулась в ротацию. В исследовании уровня 5 обнаружено ограничение CPU PostgreSQL. Увеличение лимита PostgreSQL с 1 до 2 CPU при неизменном профиле четырёх API повысило RPS с 438,868 до 587,574 (+33,88%) и снизило p95 с 109,446 до 93,991 мс (-14,12%). Ошибок в обеих фазах не было. Ограничения / известные ошибки: Известных ошибок корректности после финального прогона не обнаружено. Стенд остаётся однохостовым; PostgreSQL и HAProxy являются single points of failure. Redis используется только как восстанавливаемый кэш. Benchmark использует один измеряемый closed-loop прогон на профиль, поэтому для production capacity planning потребуются повторные измерения, доверительные интервалы и внешний генератор нагрузки. Backend пока не предоставляет поиск пользователей, аватары, изменение профиля и unread/last-message агрегаты, поэтому frontend эти возможности не имитирует. Источники и использование ИИ: Использованные библиотеки и инструменты перечислены в REPORT.md. ИИ использовался для анализа требований, архитектурного рефакторинга, реализации, поиска граничных случаев, тестирования и оформления отчёта. Все заявленные результаты подтверждены воспроизводимыми тестами и сохранёнными evidence. - Весь обязательный минимум текущей и предыдущих работ сохранён. - Контракт и публичные преподавательские тесты не ослаблены. - `make check`, `make go-check`, OpenAPI validation и `make test` выполнены. - Сценарии persistence, failover, readiness loss и rolling update воспроизведены. - Некорректный non-ASCII Bearer возвращает 401, а не 500. - Невалидный UTF-8 JSON возвращает стандартный Error с согласованным request_id. - Неготовая API-реплика исключается активными healthchecks HAProxy. - Все секреты и приватные ключи находятся вне Git. - README задания сохранён, REPORT.md описывает именно реализованное решение.
d1frend added 6 commits 2026-10-25 21:50:27 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 15:59: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#51