ЛР 2 - БПИ2301 - Авзалов - на 4 #99

Closed
Ferraronp wants to merge 2 commits from Ferraronp/mtusi2026lab2:master into master
First-time contributor

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

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

Что реализовано и что перенесено

Сохранён REST API мессенджера из лабораторной 1 с переходом от in-memory хранения и X-User-Id к постоянному хранилищу и полноценной аутентификации.

Реализовано:

  • PostgreSQL для пользователей, чатов, участников и сообщений. Добавлены ограничения PK/FK/UNIQUE, индексы и версионируемые миграции.
  • Атомарное создание чатов и участников с откатом транзакции при ошибке.
  • Хеширование паролей через Argon2id.
  • Авторизация через HTTP Basic при создании сессии, дальнейшие запросы через Bearer-токен. Реализованы logout и TTL.
  • Redis для хранения действующих сессий с TTL и AOF persistence. Действующие сессии переживают перезапуск сервисов.
  • Ограниченный PostgreSQL connection pool, таймауты и контролируемые ошибки 503 при недоступности зависимостей.
  • Keyset-пагинация истории сообщений с индексом (chat_id, created_at, id).
  • Поддержка допустимых Unicode-строк, включая U+0000, через хранение пользовательских строк в UTF-8 bytea.
  • Docker Compose для API, PostgreSQL, Redis и отдельного сервиса миграций.
  • Собственные тесты валидации, конкурентных запросов, истечения и повреждения сессий, отказов зависимостей и rollback.

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

cp .env.example .env
# Установить локальный POSTGRES_PASSWORD в .env

docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
docker compose --env-file .env ps

make check
make test
make test-own

Проверка persistence в Linux:

make test-persistence ACTION_SCRIPT=scripts/restart.sh

На Windows использовались PowerShell, Docker Desktop и scripts/restart.cmd. Подробные команды запуска и проведения экспериментов приведены в REPORT.md.

Результаты проверок и ссылка на REPORT.md

Локальные проверки на Windows, 23.10.2026:

  • python scripts/check_contract.py — PASS.
  • python tests/smoke.py — PASS, публичный API-сценарий.
  • python tests/extra.py — PASS, негативные сценарии, Unicode U+0000, лимиты входных данных и конкурентная регистрация.
  • python tests/redis_corruption.py — PASS, повреждённая Redis-сессия отклоняется с 401.
  • python tests/resilience.py --mode persistence --action-script scripts/restart.cmd — PASS, после перезапуска API, PostgreSQL и Redis сохраняются данные и действующий Bearer-токен.
  • python tests/expiry.py с SESSION_TTL_SECONDS=2 — PASS, истёкший токен получает 401.
  • python tests/dependency.py — PASS, при отказе Redis/PostgreSQL возвращается 503, после восстановления сессия продолжает работать.
  • scripts/rollback_check.py — PASS, составная операция полностью откатывается после ошибки внешнего ключа.
  • scripts/explain_history.py — выполнен EXPLAIN (ANALYZE, BUFFERS) на истории из 10 000 сообщений. PostgreSQL использовал idx_messages_chat_history, Execution Time: 0.377 ms, Buffers: shared hit=5.
  • Повторный запуск миграций — Migrations up to date.
  • Контейнер API запущен от непривилегированного пользователя app (UID 999).
  • Финальный повторный публичный smoke — PASS.

Подробные результаты, архитектура, SQL-план, сценарии отказов и ограничения: (REPORT.md).

Ограничения / известные ошибки

  • Стенд рассчитан на один экземпляр API; горизонтальное масштабирование и балансировка предусмотрены следующей лабораторной.
  • PostgreSQL и Redis остаются single points of failure, высокая доступность хранилищ не заявляется.
  • При недоступности Redis защищённые запросы и logout возвращают 503: приложение не разрешает доступ без проверки действующей сессии.
  • Стенд предназначен для локального запуска через localhost; TLS для внешнего доступа не настроен.
  • Linux-версия persistence-скрипта подготовлена, но отдельный интеграционный прогон на Linux пока не выполнялся.

Источники и использование ИИ

Документация PostgreSQL, Redis, Docker Compose, FastAPI, Pydantic, psycopg и Argon2id.

ChatGPT использовался для помощи с проектированием архитектуры, реализацией приложения, миграций, Docker-конфигурации, тестов и документации. Проверки приложения, сценарии перезапуска и отказов, а также SQL EXPLAIN выполнялись локально на Docker Desktop.

Чек-лист

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Локальный .env не отслеживается Git; тестовые данные и результаты описаны без публикации токенов.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 **Автор / группа:** Авзалов Артур Марсович / БПИ2301 **Целевая оценка (3/4/5):** 4 **Трек 5, если заявлен:** не заявлен ### Что реализовано и что перенесено Сохранён REST API мессенджера из лабораторной 1 с переходом от in-memory хранения и `X-User-Id` к постоянному хранилищу и полноценной аутентификации. Реализовано: - PostgreSQL для пользователей, чатов, участников и сообщений. Добавлены ограничения PK/FK/UNIQUE, индексы и версионируемые миграции. - Атомарное создание чатов и участников с откатом транзакции при ошибке. - Хеширование паролей через Argon2id. - Авторизация через HTTP Basic при создании сессии, дальнейшие запросы через Bearer-токен. Реализованы logout и TTL. - Redis для хранения действующих сессий с TTL и AOF persistence. Действующие сессии переживают перезапуск сервисов. - Ограниченный PostgreSQL connection pool, таймауты и контролируемые ошибки `503` при недоступности зависимостей. - Keyset-пагинация истории сообщений с индексом `(chat_id, created_at, id)`. - Поддержка допустимых Unicode-строк, включая U+0000, через хранение пользовательских строк в UTF-8 `bytea`. - Docker Compose для API, PostgreSQL, Redis и отдельного сервиса миграций. - Собственные тесты валидации, конкурентных запросов, истечения и повреждения сессий, отказов зависимостей и rollback. ### Команды запуска из чистого clone ```sh cp .env.example .env # Установить локальный POSTGRES_PASSWORD в .env docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build docker compose --env-file .env ps make check make test make test-own ``` Проверка persistence в Linux: ```sh make test-persistence ACTION_SCRIPT=scripts/restart.sh ``` На Windows использовались PowerShell, Docker Desktop и `scripts/restart.cmd`. Подробные команды запуска и проведения экспериментов приведены в `REPORT.md`. ### Результаты проверок и ссылка на REPORT.md **Локальные проверки на Windows, 23.10.2026:** - `python scripts/check_contract.py` — PASS. - `python tests/smoke.py` — PASS, публичный API-сценарий. - `python tests/extra.py` — PASS, негативные сценарии, Unicode U+0000, лимиты входных данных и конкурентная регистрация. - `python tests/redis_corruption.py` — PASS, повреждённая Redis-сессия отклоняется с `401`. - `python tests/resilience.py --mode persistence --action-script scripts/restart.cmd` — PASS, после перезапуска API, PostgreSQL и Redis сохраняются данные и действующий Bearer-токен. - `python tests/expiry.py` с `SESSION_TTL_SECONDS=2` — PASS, истёкший токен получает `401`. - `python tests/dependency.py` — PASS, при отказе Redis/PostgreSQL возвращается `503`, после восстановления сессия продолжает работать. - `scripts/rollback_check.py` — PASS, составная операция полностью откатывается после ошибки внешнего ключа. - `scripts/explain_history.py` — выполнен `EXPLAIN (ANALYZE, BUFFERS)` на истории из 10 000 сообщений. PostgreSQL использовал `idx_messages_chat_history`, `Execution Time: 0.377 ms`, `Buffers: shared hit=5`. - Повторный запуск миграций — `Migrations up to date`. - Контейнер API запущен от непривилегированного пользователя `app` (UID 999). - Финальный повторный публичный smoke — PASS. Подробные результаты, архитектура, SQL-план, сценарии отказов и ограничения: **(REPORT.md)**. ### Ограничения / известные ошибки - Стенд рассчитан на один экземпляр API; горизонтальное масштабирование и балансировка предусмотрены следующей лабораторной. - PostgreSQL и Redis остаются single points of failure, высокая доступность хранилищ не заявляется. - При недоступности Redis защищённые запросы и logout возвращают `503`: приложение не разрешает доступ без проверки действующей сессии. - Стенд предназначен для локального запуска через `localhost`; TLS для внешнего доступа не настроен. - Linux-версия persistence-скрипта подготовлена, но отдельный интеграционный прогон на Linux пока не выполнялся. ### Источники и использование ИИ Документация PostgreSQL, Redis, Docker Compose, FastAPI, Pydantic, psycopg и Argon2id. ChatGPT использовался для помощи с проектированием архитектуры, реализацией приложения, миграций, Docker-конфигурации, тестов и документации. Проверки приложения, сценарии перезапуска и отказов, а также SQL EXPLAIN выполнялись локально на Docker Desktop. ### Чек-лист - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Локальный `.env` не отслеживается Git; тестовые данные и результаты описаны без публикации токенов. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Ferraronp added 2 commits 2026-10-23 18:49:33 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-24 16:16:05 +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/mtusi2026lab2#99