Автор / группа: Авзалов Артур Марсович / БПИ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.
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 содержит инструкцию именно моего решения.
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.
Лабораторная 2
Автор / группа: Авзалов Артур Марсович / БПИ2301
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено
Сохранён REST API мессенджера из лабораторной 1 с переходом от in-memory хранения и
X-User-Idк постоянному хранилищу и полноценной аутентификации.Реализовано:
503при недоступности зависимостей.(chat_id, created_at, id).bytea.Команды запуска из чистого clone
Проверка persistence в Linux:
На 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.app(UID 999).Подробные результаты, архитектура, SQL-план, сценарии отказов и ограничения: (REPORT.md).
Ограничения / известные ошибки
503: приложение не разрешает доступ без проверки действующей сессии.localhost; TLS для внешнего доступа не настроен.Источники и использование ИИ
Документация PostgreSQL, Redis, Docker Compose, FastAPI, Pydantic, psycopg и Argon2id.
ChatGPT использовался для помощи с проектированием архитектуры, реализацией приложения, миграций, Docker-конфигурации, тестов и документации. Проверки приложения, сценарии перезапуска и отказов, а также SQL EXPLAIN выполнялись локально на Docker Desktop.
Чек-лист
make checkиmake testвыполнены; приложен реальный вывод..envне отслеживается Git; тестовые данные и результаты описаны без публикации токенов.Принято. Закрываю МР.
Pull request closed