ЛР 2 - БВТ2304 - Осипов Артём - на 4 #146

Open
Art wants to merge 2 commits from Art/mtusi2026lab2:master into master
First-time contributor

Целевая оценка: 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.

## Целевая оценка: 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`.
Art added 1 commit 2026-11-03 13:33:31 +03:00
feat: complete lab2 with postgres, auth, migrations, and persistence
Skeleton contracts / contracts (pull_request) Failing after 34s
8c3acc11a7
Owner
  • 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) фактического запроса истории и обосновать индекс.
Art added 1 commit 2026-11-07 00:03:35 +03:00
Fixing
Skeleton contracts / contracts (pull_request) Canceled after 0s
e3c78a5224
Some required checks failed
1 workflow awaiting approval

The workflow will only run after approval from the repository maintainer.

Skeleton contracts / contracts (pull_request) Canceled after 0s
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/Art/mtusi2026lab2 master:Art-master
git checkout Art-master
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#146