PostgreSQL: Полный перенос состояния из in-memory в PostgreSQL с использованием SQLAlchemy 2.0 + asyncpg.
Миграции: Настроены версионированные миграции через Alembic (alembic/versions/).
Аутентификация: Реализована регистрация с хешированием паролей (bcrypt), вход через HTTP Basic Auth с выдачей opaque Bearer-токенов с TTL, и отзыв сессий (logout).
Безопасность: Все защищённые эндпоинты требуют валидный Bearer-токен. Реализован принцип Security by Obscurity (возврат 404 вместо 403 при отсутствии прав).
Оптимизация (уровень 4):
Параметризованные запросы и connection pool (через asyncpg).
Атомарные операции при создании чата (транзакции SQLAlchemy).
Индексы для ускорения поиска (ix_users_username, ix_messages_created_at).
Корректная курсорная пагинация (LIMIT + 1), исключающая Full Scan.
Инфраструктура: Единый запуск через docker compose up -d --build, именованные volumes для сохранения данных, healthcheck'и для обоих сервисов.
Тесты: Успешно проходят make test и make test-persistence ACTION_SCRIPT=scripts/restart.sh.
Подробное описание решений и сценарий демонстрации приведены в REPORT.md.
## Целевая оценка: 4
### Что реализовано:
- **PostgreSQL**: Полный перенос состояния из in-memory в PostgreSQL с использованием SQLAlchemy 2.0 + asyncpg.
- **Миграции**: Настроены версионированные миграции через Alembic (`alembic/versions/`).
- **Аутентификация**: Реализована регистрация с хешированием паролей (bcrypt), вход через HTTP Basic Auth с выдачей opaque Bearer-токенов с TTL, и отзыв сессий (logout).
- **Безопасность**: Все защищённые эндпоинты требуют валидный Bearer-токен. Реализован принцип Security by Obscurity (возврат 404 вместо 403 при отсутствии прав).
- **Оптимизация (уровень 4)**:
- Параметризованные запросы и connection pool (через asyncpg).
- Атомарные операции при создании чата (транзакции SQLAlchemy).
- Индексы для ускорения поиска (`ix_users_username`, `ix_messages_created_at`).
- Корректная курсорная пагинация (`LIMIT + 1`), исключающая Full Scan.
- **Инфраструктура**: Единый запуск через `docker compose up -d --build`, именованные volumes для сохранения данных, healthcheck'и для обоих сервисов.
- **Тесты**: Успешно проходят `make test` и `make test-persistence ACTION_SCRIPT=scripts/restart.sh`.
Подробное описание решений и сценарий демонстрации приведены в `REPORT.md`.
Dockerfile:16, alembic/env.py:23. Первый запуск не создаёт таблицы: готовность возвращает 200, регистрация — 500. В образе отсутствует конфигурация миграций, подключение мигратора привязано к localhost:5433. Нужно включить миграции в образ, использовать DATABASE_URL и безопасно применять их до готовности API.
src/auth.py:8. Разные длинные пароли принимаются как одинаковые. После регистрации с a×72 + X×12 вход с a×72 + Y×12 возвращает 201: bcrypt учитывает только первые 72 байта. Нужно обеспечить проверку полного пароля разрешённой контрактом длины.
src/main.py:130. Выход из одной сессии отзывает все сессии пользователя. После двух входов выход из первой делает второй токен недействительным. Нужно удалять конкретную предъявленную сессию.src/main.py:250. Некорректный cursor=garbage вызывает 500 вместо 400. Нужно проверять курсор и возвращать контрактную ошибку; аналогичную обработку исправить у списка чатов.
src/schemas.py:37. Повтор пользователя в member_ids доходит до ограничения БД и вызывает 500 вместо 400. Нужно проверять уникальность участников до записи, а также соблюдать контрактные ограничения списка.
src/main.py:251. Пагинация пропускает сообщения с одинаковым временем. Из трёх сообщений при limit=1 первая страница вернула одно, следующая — пустую. Курсор содержит только время, хотя сортировка использует ещё id. Нужно включить полный ключ сортировки в курсор и условие продолжения.
src/database.py:10. При приостановленной PostgreSQL /health/ready не отвечает за 8 секунд. Нужно ограничить ожидание БД на стороне приложения, возвращать 503 и восстанавливать работу после возобновления БД.
docker-compose.yaml:2. Для заявленной четвёрки отсутствует Redis/Valkey. Нужно реализовать его обязательную роль для сессий либо кэша, описать источник истины, TTL и инвалидацию, проверить отказ и перезапуск.
src/main.py:116. Время жизни сессии жёстко задано 24 часами, настройка SESSION_TTL_SECONDS не используется; обязательных собственных автотестов нет. Нужно реализовать настройку TTL и проверки истечения сессии, выхода, неверного пароля, гонок, отката и отказов зависимостей одной командой.
REPORT.md:34. Для четвёрки отсутствует обязательный EXPLAIN на ≥10 000 сообщений. Нужно подготовить воспроизводимые данные, получить EXPLAIN (ANALYZE, BUFFERS) фактического запроса истории и обосновать индекс.
- [Dockerfile:16](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/Dockerfile#L16), [alembic/env.py:23](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/alembic/env.py#L23). Первый запуск не создаёт таблицы: готовность возвращает 200, регистрация — 500. В образе отсутствует конфигурация миграций, подключение мигратора привязано к localhost:5433. Нужно включить миграции в образ, использовать DATABASE_URL и безопасно применять их до готовности API.
- [src/auth.py:8](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/src/auth.py#L8). Разные длинные пароли принимаются как одинаковые. После регистрации с a×72 + X×12 вход с a×72 + Y×12 возвращает 201: bcrypt учитывает только первые 72 байта. Нужно обеспечить проверку полного пароля разрешённой контрактом длины.
- [src/main.py:130](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/src/main.py#L130). Выход из одной сессии отзывает все сессии пользователя. После двух входов выход из первой делает второй токен недействительным. Нужно удалять конкретную предъявленную сессию.[src/main.py:250](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/src/main.py#L250). Некорректный cursor=garbage вызывает 500 вместо 400. Нужно проверять курсор и возвращать контрактную ошибку; аналогичную обработку исправить у списка чатов.
- [src/schemas.py:37](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/src/schemas.py#L37). Повтор пользователя в member_ids доходит до ограничения БД и вызывает 500 вместо 400. Нужно проверять уникальность участников до записи, а также соблюдать контрактные ограничения списка.
- [src/main.py:251](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/src/main.py#L251). Пагинация пропускает сообщения с одинаковым временем. Из трёх сообщений при limit=1 первая страница вернула одно, следующая — пустую. Курсор содержит только время, хотя сортировка использует ещё id. Нужно включить полный ключ сортировки в курсор и условие продолжения.
- [src/database.py:10](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/src/database.py#L10). При приостановленной PostgreSQL /health/ready не отвечает за 8 секунд. Нужно ограничить ожидание БД на стороне приложения, возвращать 503 и восстанавливать работу после возобновления БД.
- [docker-compose.yaml:2](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/docker-compose.yaml#L2). Для заявленной четвёрки отсутствует Redis/Valkey. Нужно реализовать его обязательную роль для сессий либо кэша, описать источник истины, TTL и инвалидацию, проверить отказ и перезапуск.
- [src/main.py:116](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/src/main.py#L116). Время жизни сессии жёстко задано 24 часами, настройка SESSION_TTL_SECONDS не используется; обязательных собственных автотестов нет. Нужно реализовать настройку TTL и проверки истечения сессии, выхода, неверного пароля, гонок, отката и отказов зависимостей одной командой.
- [REPORT.md:34](https://gitea.privcloud.tech/Art/mtusi2026lab2/src/commit/8c3acc11a7580cba62da46f6feae2e74a3ba29eb/REPORT.md#L34). Для четвёрки отсутствует обязательный EXPLAIN на ≥10 000 сообщений. Нужно подготовить воспроизводимые данные, получить EXPLAIN (ANALYZE, BUFFERS) фактического запроса истории и обосновать индекс.
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.
Целевая оценка: 4
Что реализовано:
alembic/versions/).ix_users_username,ix_messages_created_at).LIMIT + 1), исключающая Full Scan.docker compose up -d --build, именованные volumes для сохранения данных, healthcheck'и для обоих сервисов.make testиmake test-persistence ACTION_SCRIPT=scripts/restart.sh.Подробное описание решений и сценарий демонстрации приведены в
REPORT.md.The workflow will only run after approval from the repository maintainer.
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.