ЛР2 - БПИ2301 - Антонов - на 4 #75

Closed
aegor wants to merge 10 commits from aegor/mtusi2026lab2:solution/БПИ2301-Antonov into master
First-time contributor

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

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

Что реализовано и что перенесено: из lab1 перенесены NestJS + Fastify API, валидация, формат ошибок, курсоры, Dockerfile и e2e-тесты. Хранилище заменено на PostgreSQL 17 через Prisma 6.1 (2 версионируемые миграции, PK/FK/UNIQUE/CHECK, индекс истории (chat_id, created_at, id), keyset-пагинация через $queryRaw, атомарное создание чата в $transaction). Аутентификация: Argon2id-пароли, вход по Basic, opaque Bearer-токен (256 бит, в БД — sha256), TTL SESSION_TTL_SECONDS, logout. Redis 7.4 — read-through кэш сессий (TTL ≤ 60 с, tombstone при logout, обход при отказе), источник истины — PostgreSQL. Compose со secrets-init, migrate, именованными volumes, restart-hook и сервисом tools для проверок только через Docker. Собственные тесты: 65 (в т. ч. expiry, отказ Redis/БД, гонка регистрации, rollback, валидность примеров Swagger). Swagger UI на /docs по контракту с примерами.
Команды запуска из чистого clone: docker compose up -d --build --wait, затем docker compose run --rm tools make test, docker compose run --rm tools make test-persistence ACTION_SCRIPT=scripts/restart.sh, docker compose -f compose.test.yaml run --rm --build tests. Подробности в REPORT.md.
Результаты проверок и ссылка на REPORT.md: make check, make test, make test-persistence, 65 собственных тестов — PASS; EXPLAIN на 50 000 сообщений; вывод в evidence/, таблица критериев в REPORT.md.
Ограничения / известные ошибки: нет репликации и backup PostgreSQL; logout и tombstone в Redis не атомарны (окно до 60 с только при сетевом разрыве с Redis); порядок created_at при конкурентной записи описан в REPORT.md; нет rate limiting входа; HTTP без TLS.
Источники и использование ИИ: документация NestJS, Fastify, Prisma, PostgreSQL, Redis, OWASP Password Storage, RFC 7617; библиотеки @prisma/client, argon2, ioredis, class-validator, jest/supertest. ИИ-ассистент использовался как парный программист: генерация кода, тестов и отчёта по моим архитектурным решениям с последующим ревью и переработкой; выбор стека, модель данных, роль Redis и границы транзакций определены мной; все проверки воспроизведены мной на своём стенде.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Антонов Егор / БПИ2301 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: из lab1 перенесены NestJS + Fastify API, валидация, формат ошибок, курсоры, Dockerfile и e2e-тесты. Хранилище заменено на PostgreSQL 17 через Prisma 6.1 (2 версионируемые миграции, PK/FK/UNIQUE/CHECK, индекс истории `(chat_id, created_at, id)`, keyset-пагинация через `$queryRaw`, атомарное создание чата в `$transaction`). Аутентификация: Argon2id-пароли, вход по Basic, opaque Bearer-токен (256 бит, в БД — sha256), TTL `SESSION_TTL_SECONDS`, logout. Redis 7.4 — read-through кэш сессий (TTL ≤ 60 с, tombstone при logout, обход при отказе), источник истины — PostgreSQL. Compose со secrets-init, migrate, именованными volumes, restart-hook и сервисом tools для проверок только через Docker. Собственные тесты: 65 (в т. ч. expiry, отказ Redis/БД, гонка регистрации, rollback, валидность примеров Swagger). Swagger UI на `/docs` по контракту с примерами. Команды запуска из чистого clone: `docker compose up -d --build --wait`, затем `docker compose run --rm tools make test`, `docker compose run --rm tools make test-persistence ACTION_SCRIPT=scripts/restart.sh`, `docker compose -f compose.test.yaml run --rm --build tests`. Подробности в REPORT.md. Результаты проверок и ссылка на REPORT.md: `make check`, `make test`, `make test-persistence`, 65 собственных тестов — PASS; EXPLAIN на 50 000 сообщений; вывод в `evidence/`, таблица критериев в [REPORT.md](../REPORT.md). Ограничения / известные ошибки: нет репликации и backup PostgreSQL; logout и tombstone в Redis не атомарны (окно до 60 с только при сетевом разрыве с Redis); порядок `created_at` при конкурентной записи описан в REPORT.md; нет rate limiting входа; HTTP без TLS. Источники и использование ИИ: документация NestJS, Fastify, Prisma, PostgreSQL, Redis, OWASP Password Storage, RFC 7617; библиотеки `@prisma/client`, `argon2`, `ioredis`, `class-validator`, `jest`/`supertest`. ИИ-ассистент использовался как парный программист: генерация кода, тестов и отчёта по моим архитектурным решениям с последующим ревью и переработкой; выбор стека, модель данных, роль Redis и границы транзакций определены мной; все проверки воспроизведены мной на своём стенде. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
aegor added 9 commits 2026-10-21 15:31:26 +03:00
Owner

Существенные замечания:

  1. Отозванный токен восстанавливает доступ после возвращения Redis. Прогреть сессию в кэше → отключить сеть Redis и закрыть существующее TCP-соединение, сохранив процесс и данные Redis → выполнить logout → восстановить сеть. Logout вернул 204, в PostgreSQL сессий по токену стало 0. После восстановления старый токен получил 200 на /users/me и 201 при отправке сообщения вместо ожидаемых 401. Остаток TTL кэша — 57,4 с; после естественного expiry снова 401. Доверие активной записи кэша обходит проверку отзыва в PostgreSQL: src/auth/auth.service.ts:71, последовательность отзыва — строка 101.
  2. Вход принимает запрещённый JSON body. POST /api/v1/auth/sessions с корректным Basic и телом {"extra":"forbidden"} возвращает 201, ожидается отклонение 400: контракт предусматривает вход без JSON body. Контроллер читает только заголовок: src/auth/auth.controller.ts:28.
  3. Не соблюдается максимум 100 участников. Создание чата со 101 уникальным существующим участником, включая вызывающего, возвращает 201 и 101 ID вместо ожидаемого 400. В DTO отсутствует верхняя граница массива: src/chats/dto/create-chat.dto.ts:10.
Существенные замечания: 1. Отозванный токен восстанавливает доступ после возвращения Redis. Прогреть сессию в кэше → отключить сеть Redis и закрыть существующее TCP-соединение, сохранив процесс и данные Redis → выполнить logout → восстановить сеть. Logout вернул 204, в PostgreSQL сессий по токену стало 0. После восстановления старый токен получил 200 на /users/me и 201 при отправке сообщения вместо ожидаемых 401. Остаток TTL кэша — 57,4 с; после естественного expiry снова 401. Доверие активной записи кэша обходит проверку отзыва в PostgreSQL: [src/auth/auth.service.ts:71](https://gitea.privcloud.tech/aegor/mtusi2026lab2/src/commit/07661cfe8242b0f9fabc7ecf846dfa5b5cc52962/src/auth/auth.service.ts#L71), последовательность отзыва — [строка 101](https://gitea.privcloud.tech/aegor/mtusi2026lab2/src/commit/07661cfe8242b0f9fabc7ecf846dfa5b5cc52962/src/auth/auth.service.ts#L101). 2. Вход принимает запрещённый JSON body. POST /api/v1/auth/sessions с корректным Basic и телом {"extra":"forbidden"} возвращает 201, ожидается отклонение 400: контракт предусматривает вход без JSON body. Контроллер читает только заголовок: [src/auth/auth.controller.ts:28](https://gitea.privcloud.tech/aegor/mtusi2026lab2/src/commit/07661cfe8242b0f9fabc7ecf846dfa5b5cc52962/src/auth/auth.controller.ts#L28). 3. Не соблюдается максимум 100 участников. Создание чата со 101 уникальным существующим участником, включая вызывающего, возвращает 201 и 101 ID вместо ожидаемого 400. В DTO отсутствует верхняя граница массива: [src/chats/dto/create-chat.dto.ts:10](https://gitea.privcloud.tech/aegor/mtusi2026lab2/src/commit/07661cfe8242b0f9fabc7ecf846dfa5b5cc52962/src/chats/dto/create-chat.dto.ts#L10).
aegor added 1 commit 2026-10-22 12:41:43 +03:00
fix: fixes after review
Skeleton contracts / contracts (pull_request) Canceled after 0s
5146ca8419
Owner

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

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