Реализованы две реплики FastAPI за балансировщиком HAProxy с единой публичной точкой входа. PostgreSQL используется как общее хранилище пользователей, сессий, истории сообщений и ключей идемпотентности. Миграции выполняет отдельный сервис.
Из ЛР2 перенесены Argon2id, авторизация Basic → Bearer, TTL и отзыв сессий, контроль доступа к чатам и cursor pagination.
Добавлены X-Instance-Id, общая идемпотентность POST сообщений через Idempotency-Key и проверяемое переключение между репликами при отказе.
Команды запуска из чистого clone
На Windows требуется Docker Desktop с Linux containers и PowerShell. Из корня репозитория:
Подробная инструкция, включая подготовку секретов, порядок остановки и очистку учебных данных, приведена в [REPORT.md](REPORT.md).
Результаты проверок и доказательства
make check, make validate, make test — PASS. [Журнал проверок](evidence/grade3/checks.txt).
Балансировка — PASS. Один Bearer-токен работает на обеих репликах, что подтверждено разными X-Instance-Id.
Идемпотентность — PASS. Конкурентные запросы с одним ключом возвращают одно сообщение без дубликатов. Разные тела с одинаковым ключом дают 201/409. Повтор после временного 503 не создаёт дубль. [Журнал](evidence/grade3/core.txt).
Persistence — PASS. После перезапуска PostgreSQL и API сохраняются сессия и сообщения. [Журнал](evidence/grade3/persistence.txt).
Failover — PASS. Обе реплики остановлены поочерёдно. Чтение и запись восстановились менее чем за 10 секунд, дубликаты не обнаружены. [Журнал](evidence/grade3/failover.txt).
Ограничения / известные ошибки
Стенд обеспечивает отказоустойчивость одной API-реплики. HAProxy, PostgreSQL и Docker host остаются единичными точками отказа. HTTP используется только в локальном учебном окружении. Удалённый CI не запускался.
Скрипты scripts/restart.sh и scripts/stop-one.sh опубликованы с Git mode 100755.
Источники и использование ИИ
Контракт и skeleton ЛР3, собственная реализация ЛР2, документация HAProxy, Docker Compose и PostgreSQL.
Codex использовался для переноса реализации, разработки, тестирования и сбора доказательств. Результаты дополнительно проверены по исходникам и сохранённым журналам.
Контрольный список
Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; приложен реальный вывод.
Сценарии отказов/безопасности своего уровня воспроизведены.
Все секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3
**Автор / группа:** Гамаюнов Артём, БВТ2301
**Целевая оценка:** 3
**Трек 5:** не заявлен.
### Что реализовано и что перенесено
Реализованы две реплики FastAPI за балансировщиком HAProxy с единой публичной точкой входа. PostgreSQL используется как общее хранилище пользователей, сессий, истории сообщений и ключей идемпотентности. Миграции выполняет отдельный сервис.
Из ЛР2 перенесены Argon2id, авторизация Basic → Bearer, TTL и отзыв сессий, контроль доступа к чатам и cursor pagination.
Добавлены `X-Instance-Id`, общая идемпотентность POST сообщений через `Idempotency-Key` и проверяемое переключение между репликами при отказе.
### Команды запуска из чистого clone
На Windows требуется Docker Desktop с Linux containers и PowerShell. Из корня репозитория:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/init-env.ps1
docker compose config --quiet
docker compose up -d --build
docker compose build tools
docker compose run --rm -T tools python student-tests/grade3.py ready
docker compose run --rm -T tools make check validate test
```
Дополнительные проверки:
```powershell
docker compose run --rm -T tools python student-tests/grade3.py core
docker compose run --rm -T tools python student-tests/grade3.py persistence
docker compose run --rm -T tools python student-tests/grade3.py failover
```
Подробная инструкция, включая подготовку секретов, порядок остановки и очистку учебных данных, приведена в [[REPORT.md](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/REPORT.md)](REPORT.md).
### Результаты проверок и доказательства
- **`make check`, `make validate`, `make test` — PASS.** [[Журнал проверок](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/checks.txt)](evidence/grade3/checks.txt).
- **Балансировка — PASS.** Один Bearer-токен работает на обеих репликах, что подтверждено разными `X-Instance-Id`.
- **Идемпотентность — PASS.** Конкурентные запросы с одним ключом возвращают одно сообщение без дубликатов. Разные тела с одинаковым ключом дают `201/409`. Повтор после временного `503` не создаёт дубль. [[Журнал](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/core.txt)](evidence/grade3/core.txt).
- **Persistence — PASS.** После перезапуска PostgreSQL и API сохраняются сессия и сообщения. [[Журнал](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/persistence.txt)](evidence/grade3/persistence.txt).
- **Failover — PASS.** Обе реплики остановлены поочерёдно. Чтение и запись восстановились менее чем за 10 секунд, дубликаты не обнаружены. [[Журнал](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/evidence/grade3/failover.txt)](evidence/grade3/failover.txt).
### Ограничения / известные ошибки
Стенд обеспечивает отказоустойчивость одной API-реплики. HAProxy, PostgreSQL и Docker host остаются единичными точками отказа. HTTP используется только в локальном учебном окружении. Удалённый CI не запускался.
Скрипты `scripts/restart.sh` и `scripts/stop-one.sh` опубликованы с Git mode `100755`.
### Источники и использование ИИ
Контракт и skeleton ЛР3, собственная реализация ЛР2, документация HAProxy, Docker Compose и PostgreSQL.
Codex использовался для переноса реализации, разработки, тестирования и сбора доказательств. Результаты дополнительно проверены по исходникам и сохранённым журналам.
### Контрольный список
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] `make check` и `make test` выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит токенов.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 3
Автор / группа: Гамаюнов Артём, БВТ2301
Целевая оценка: 3
Трек 5: не заявлен.
Что реализовано и что перенесено
Реализованы две реплики FastAPI за балансировщиком HAProxy с единой публичной точкой входа. PostgreSQL используется как общее хранилище пользователей, сессий, истории сообщений и ключей идемпотентности. Миграции выполняет отдельный сервис.
Из ЛР2 перенесены Argon2id, авторизация Basic → Bearer, TTL и отзыв сессий, контроль доступа к чатам и cursor pagination.
Добавлены
X-Instance-Id, общая идемпотентность POST сообщений черезIdempotency-Keyи проверяемое переключение между репликами при отказе.Команды запуска из чистого clone
На Windows требуется Docker Desktop с Linux containers и PowerShell. Из корня репозитория:
Дополнительные проверки:
Подробная инструкция, включая подготовку секретов, порядок остановки и очистку учебных данных, приведена в [REPORT.md](REPORT.md).
Результаты проверок и доказательства
make check,make validate,make test— PASS. [Журнал проверок](evidence/grade3/checks.txt).X-Instance-Id.201/409. Повтор после временного503не создаёт дубль. [Журнал](evidence/grade3/core.txt).Ограничения / известные ошибки
Стенд обеспечивает отказоустойчивость одной API-реплики. HAProxy, PostgreSQL и Docker host остаются единичными точками отказа. HTTP используется только в локальном учебном окружении. Удалённый CI не запускался.
Скрипты
scripts/restart.shиscripts/stop-one.shопубликованы с Git mode100755.Источники и использование ИИ
Контракт и skeleton ЛР3, собственная реализация ЛР2, документация HAProxy, Docker Compose и PostgreSQL.
Codex использовался для переноса реализации, разработки, тестирования и сбора доказательств. Результаты дополнительно проверены по исходникам и сохранённым журналам.
Контрольный список
make checkиmake testвыполнены; приложен реальный вывод.Принято. Закрываю МР.
Pull request closed