From 5146ca8419aef9d2fa41207836394acb46545d6f Mon Sep 17 00:00:00 2001 From: aegor Date: Thu, 22 Oct 2026 12:41:28 +0300 Subject: [PATCH] fix: fixes after review --- .github/pull_request_template.md | 6 +++--- REPORT.md | 8 +++++--- src/auth/auth.controller.ts | 5 +++++ src/cache/cache.service.ts | 32 ++++++++++++++++++++++++++++---- src/chats/dto/create-chat.dto.ts | 9 ++++++++- test/api.e2e-spec.ts | 25 +++++++++++++++++++++++++ test/auth.e2e-spec.ts | 12 ++++++++++++ test/failures.e2e-spec.ts | 26 ++++++++++++++++++++++++++ 8 files changed, 112 insertions(+), 11 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 8eeae14..d91894d 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -4,10 +4,10 @@ Целевая оценка (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` по контракту с примерами. +Что реализовано и что перенесено: из 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. Собственные тесты: 68 (в т. ч. expiry, отказ Redis/БД, отзыв токена при разрыве с 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. +Результаты проверок и ссылка на REPORT.md: `make check`, `make test`, `make test-persistence`, 68 собственных тестов — PASS; EXPLAIN на 50 000 сообщений; вывод в `evidence/`, таблица критериев в [REPORT.md](../REPORT.md). +Ограничения / известные ошибки: нет репликации и backup PostgreSQL; порядок `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] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. diff --git a/REPORT.md b/REPORT.md index a6099ca..d332d50 100644 --- a/REPORT.md +++ b/REPORT.md @@ -79,7 +79,7 @@ CHECK-ограничения дописаны в SQL миграции вручн - Создание чата — явный `prisma.$transaction`: `INSERT chats` + `INSERT chat_members`. Неизвестный участник нарушает FK (P2003) → откат всей транзакции → `400`. - Регистрация — один `INSERT`; гонка одинакового username решается `UNIQUE` (P2002 → `409`), а не проверкой «select, затем insert». Хеш пароля считается до транзакции. - Сообщение — один `INSERT`; проверка членства — отдельным чтением перед ним (удаления участников в API нет, поэтому окно гонки не влияет на результат). -- Logout — `DELETE` из `sessions`, затем tombstone в Redis (две системы, не атомарно — см. ограничения). +- Logout — `DELETE` из `sessions` (источник истины), затем tombstone в Redis; если записать tombstone нельзя, кэш перестаёт считаться достоверным до очистки (см. «Отказ Redis»). **Время и порядок.** `created_at` назначает PostgreSQL (`DEFAULT CURRENT_TIMESTAMP`, `timestamptz(3)`) — один источник часов для всех реплик API. Миллисекундная точность выбрана, чтобы значение в JS `Date` совпадало с хранимым и keyset-сравнение не теряло строки. Пагинация: `WHERE chat_id = $1 AND (created_at, id) > ($2, $3) ORDER BY created_at, id LIMIT limit+1`; курсор — base64url `{chatId, id}`, сервер находит `created_at` якоря по PK; курсор другого чата или несуществующей записи → `400`. Список чатов использует тот же приём. Keyset в Prisma написан через `$queryRaw` с параметрами (tagged template), потому что штатный `cursor` Prisma строит `OR`-условие, которое не превращается в Index Cond. @@ -92,6 +92,7 @@ CHECK-ограничения дописаны в SQL миграции вручн - **Инвалидация** — logout удаляет строку и пишет tombstone `revoked` на 60 с; заполнение кэша идёт с `NX`, поэтому конкурентный запрос, прочитавший сессию до logout, не перезапишет tombstone. - **Persistence Redis выключена** (`--save '' --appendonly no`), `maxmemory 64mb allkeys-lru`: после flush/restart кэш пуст и прогревается из PostgreSQL. - **Отказ Redis** — любая ошибка = промах, запрос идёт в PostgreSQL (`enableOfflineQueue: false`, `commandTimeout 200 ms`, `connectTimeout 1 s`). Redis не входит в `/health/ready`. +- **Восстановление после разрыва** — после обрыва соединения или ошибки любой команды кэш помечается недостоверным: чтения и записи в него не выполняются, соединение переустанавливается, и при каждом подключении сначала выполняется `FLUSHDB`, только затем кэш снова используется (`src/cache/cache.service.ts`). Поэтому запись, пережившая разрыв (logout во время разрыва не смог записать tombstone), не может вернуть доступ отозванному токену. Очистка безопасна, так как Redis — только кэш. - **Отказ PostgreSQL** — ошибки подключения Prisma (`PrismaClientInitializationError`, P1001/P1002/P1008/P1017/P2024) → `503 unavailable` без деталей. Аноним и `X-User-Id` получают `401`; неизвестный токен — `503` (его нельзя проверить, значит нельзя и доверять); токен из кэша проходит аутентификацию, но бизнес-запрос получает `503`. **Пул и таймауты** (параметры строки подключения Prisma в `secrets/database_url`): `connection_limit=10`, `pool_timeout=5` с, `connect_timeout=5` с, `socket_timeout=10` с, `statement_timeout=5000` мс (через `options=-c statement_timeout=5000`), `application_name=api`. Все запросы параметризованы (Prisma Client и `$queryRaw` tagged template). @@ -132,9 +133,10 @@ CHECK-ограничения дописаны в SQL миграции вручн | **4**: индекс истории + `EXPLAIN (ANALYZE, BUFFERS)` на ≥10 000 сообщений | `scripts/explain.sql` (50 000 сообщений, 10 000 в целевом чате) | keyset: Index Scan, 4–5 buffers, < 0,1 мс на первой и 9000-й странице; без индекса/`OFFSET` — Seq Scan, 667 buffers | [evidence/explain.txt](evidence/explain.txt) | | **4**: автотест expiry при коротком TTL | `failures.e2e-spec.ts`, `SESSION_TTL_SECONDS=2` | `200`, через 2,5 с `401` (в т. ч. после попадания в кэш) | [evidence/tests.txt](evidence/tests.txt) | | **4**: автотесты logout и неверного пароля | `auth.e2e-spec.ts` | `204` → `401`; неверный пароль и неизвестный пользователь — одинаковый `401` с `WWW-Authenticate: Basic` | [evidence/tests.txt](evidence/tests.txt) | +| **4**: отзыв токена при разрыве связи с Redis | тест «logout при обрыве связи с Redis…»: прогретый кэш → разрыв → logout → восстановление | старый токен → `401`; запись удалена `FLUSHDB` при переподключении | [evidence/tests.txt](evidence/tests.txt) | | **4**: недоступность Redis | автотест с `redis://127.0.0.1:1`; стенд: `docker compose stop redis` + smoke | вход, Bearer, logout работают через PostgreSQL; smoke `PASS` | [evidence/tests.txt](evidence/tests.txt), [evidence/failures.txt](evidence/failures.txt) §1 | | **4**: недоступность БД | автотест с недостижимым `DATABASE_URL`; стенд: `docker compose stop postgres` | `/health/ready` и `/chats` с токеном → `503 unavailable` без деталей; аноним → `401` | [evidence/tests.txt](evidence/tests.txt), [evidence/failures.txt](evidence/failures.txt) §2 | -| Собственные тесты | `docker compose -f compose.test.yaml run --rm --build tests` | `Tests: 65 passed, 65 total` | [evidence/tests.txt](evidence/tests.txt) | +| Собственные тесты | `docker compose -f compose.test.yaml run --rm --build tests` | `Tests: 68 passed, 68 total` | [evidence/tests.txt](evidence/tests.txt) | ## Эксперименты и отказы @@ -164,7 +166,7 @@ CHECK-ограничения дописаны в SQL миграции вручн ## Ограничения и следующие шаги - **Durability**: `COMMIT` подтверждается после записи WAL на диск (настройки PostgreSQL по умолчанию, `synchronous_commit=on`, `fsync=on`); при отказе диска/хоста без реплики данные теряются — репликации и backup в этой работе нет. -- **Logout и кэш не атомарны**: если Redis недоступен в момент logout, а затем вернётся со старыми данными (сетевой разрыв без рестарта), отозванный токен может приниматься до 60 с. При рестарте Redis этого нет — он пуст. +- **Разрыв связи только у одной реплики API** (актуально с lab3): очистка кэша выполняет та реплика, что потеряла связь; реплика с непрерывным соединением может отдавать запись из кэша до её TTL (≤ 60 с). В lab2 реплика одна. - **Порядок при конкурентной записи**: `created_at` = время начала транзакции, поэтому сообщение может стать видимым позже сообщения с бо́льшим `created_at`; читатель, уже прошедший эту позицию курсором, его пропустит. Для однострочных INSERT окно — миллисекунды; snapshot-изоляция между HTTP-запросами контрактом не требуется. Строгий порядок дал бы последовательный номер в чате (lab3+). - Строки истёкших сессий не удаляются (нет фоновой очистки); на корректность не влияет, таблица растёт. - Нет rate limiting на `POST /auth/sessions` — перебор паролей ограничен только стоимостью Argon2id. diff --git a/src/auth/auth.controller.ts b/src/auth/auth.controller.ts index 22cc528..ebd38d7 100644 --- a/src/auth/auth.controller.ts +++ b/src/auth/auth.controller.ts @@ -8,6 +8,7 @@ import { UseGuards, } from '@nestjs/common'; import { FastifyRequest } from 'fastify'; +import { ApiError } from '../common/filters/api-error'; import { toUserResponse, UserResponse } from '../users/dto/user.response'; import { AuthGuard } from './auth.guard'; import { AuthService } from './auth.service'; @@ -27,7 +28,11 @@ export class AuthController { @HttpCode(201) async create( @Headers('authorization') authorization: string | undefined, + @Req() request: FastifyRequest, ): Promise { + if (request.body !== undefined) { + throw new ApiError('invalid_request', 'request body is not allowed'); + } const session = await this.auth.login(authorization); return { token: session.token, diff --git a/src/cache/cache.service.ts b/src/cache/cache.service.ts index 190be6b..b429706 100644 --- a/src/cache/cache.service.ts +++ b/src/cache/cache.service.ts @@ -6,6 +6,7 @@ import Redis from 'ioredis'; export class CacheService implements OnModuleDestroy { private readonly logger = new Logger('CacheService'); private readonly client: Redis | null; + private trusted = false; constructor() { const url = readCacheUrl(); @@ -20,12 +21,27 @@ export class CacheService implements OnModuleDestroy { this.client?.on('error', (error) => this.logger.warn(`redis unavailable: ${error.message}`), ); + this.client?.on('close', () => { + this.trusted = false; + }); + this.client?.on('ready', () => { + this.client!.flushdb().then( + () => { + this.trusted = true; + }, + () => this.distrust(), + ); + }); } async get(key: string): Promise { + if (!this.client || !this.trusted) { + return null; + } try { - return (await this.client?.get(key)) ?? null; + return await this.client.get(key); } catch { + this.distrust(); return null; } } @@ -36,20 +52,28 @@ export class CacheService implements OnModuleDestroy { ttlMs: number, onlyIfAbsent = false, ): Promise { + if (!this.client || !this.trusted) { + return; + } try { if (onlyIfAbsent) { - await this.client?.set(key, value, 'PX', ttlMs, 'NX'); + await this.client.set(key, value, 'PX', ttlMs, 'NX'); } else { - await this.client?.set(key, value, 'PX', ttlMs); + await this.client.set(key, value, 'PX', ttlMs); } } catch { - return; + this.distrust(); } } onModuleDestroy(): void { this.client?.disconnect(); } + + private distrust(): void { + this.trusted = false; + this.client?.disconnect(true); + } } function readCacheUrl(): string | undefined { diff --git a/src/chats/dto/create-chat.dto.ts b/src/chats/dto/create-chat.dto.ts index 581c90b..d42750a 100644 --- a/src/chats/dto/create-chat.dto.ts +++ b/src/chats/dto/create-chat.dto.ts @@ -1,4 +1,10 @@ -import { ArrayMinSize, ArrayUnique, IsArray, IsString } from 'class-validator'; +import { + ArrayMaxSize, + ArrayMinSize, + ArrayUnique, + IsArray, + IsString, +} from 'class-validator'; import { CodePointLength } from '../../common/dto/code-point-length.validator'; import { NotBlank } from '../../common/dto/not-blank.validator'; @@ -9,6 +15,7 @@ export class CreateChatDto { @IsArray() @ArrayMinSize(1) + @ArrayMaxSize(100) @ArrayUnique() @IsString({ each: true }) member_ids!: string[]; diff --git a/test/api.e2e-spec.ts b/test/api.e2e-spec.ts index 01763ff..3cc6387 100644 --- a/test/api.e2e-spec.ts +++ b/test/api.e2e-spec.ts @@ -1,6 +1,7 @@ import { INestApplication } from '@nestjs/common'; import request from 'supertest'; import { randomUUID } from 'crypto'; +import { PrismaService } from '../src/db/prisma.service'; import { bearer, createTestApp, @@ -208,6 +209,30 @@ describe('API мессенджера (e2e) — граничные случаи .expect(400); }); + it('принимает ровно 100 участников и отклоняет 101', async () => { + const alice = await createUser('max'); + const ids = Array.from({ length: 100 }, () => randomUUID()); + await app.get(PrismaService).user.createMany({ + data: ids.map((id) => ({ + id, + username: `m_${id.replace(/-/g, '').slice(0, 30)}`, + displayName: 'Member', + passwordHash: 'not-a-real-hash', + })), + }); + const ok = await request(server) + .post('/api/v1/chats') + .set('Authorization', bearer(alice)) + .send({ title: 'Max', member_ids: [alice.id, ...ids.slice(0, 99)] }) + .expect(201); + expect(ok.body.member_ids).toHaveLength(100); + await request(server) + .post('/api/v1/chats') + .set('Authorization', bearer(alice)) + .send({ title: 'Too many', member_ids: [alice.id, ...ids] }) + .expect(400); + }); + it('отклоняет создание чата с неизвестным участником', async () => { const alice = await createUser('alice4'); await request(server) diff --git a/test/auth.e2e-spec.ts b/test/auth.e2e-spec.ts index 67f8b58..59c59a7 100644 --- a/test/auth.e2e-spec.ts +++ b/test/auth.e2e-spec.ts @@ -97,6 +97,18 @@ describe('Аутентификация и сессии (e2e)', () => { expect(wrong.body.error.message).toBe(unknown.body.error.message); }); + it('отклоняет JSON body при входе даже с верным Basic', async () => { + const user = await registerUser(server, 'body'); + for (const body of [{ extra: 'forbidden' }, {}]) { + const res = await request(server) + .post('/api/v1/auth/sessions') + .set('Authorization', basic(user.username, PASSWORD)) + .send(body) + .expect(400); + expect(res.body.error.code).toBe('invalid_request'); + } + }); + it('отвечает 401 без заголовка Authorization', async () => { const res = await request(server) .post('/api/v1/auth/sessions') diff --git a/test/failures.e2e-spec.ts b/test/failures.e2e-spec.ts index 6fdf894..7118f57 100644 --- a/test/failures.e2e-spec.ts +++ b/test/failures.e2e-spec.ts @@ -1,6 +1,8 @@ import { INestApplication } from '@nestjs/common'; import request from 'supertest'; import { randomUUID } from 'crypto'; +import Redis from 'ioredis'; +import { CacheService } from '../src/cache/cache.service'; import { PrismaService } from '../src/db/prisma.service'; import { bearer, createTestApp, registerUser } from './helpers'; @@ -57,6 +59,30 @@ describe('Уровень 4: expiry, отказы зависимостей, rollb await request(server).get('/api/v1/users/me').expect(401); }); + it('logout при обрыве связи с Redis не оставляет рабочий токен после её восстановления', async () => { + const { app, server } = await start(); + const user = await registerUser(server, 'partition'); + await request(server) + .get('/api/v1/users/me') + .set('Authorization', bearer(user)) + .expect(200); + const cache = app.get(CacheService) as any; + const redis = cache.client as Redis; + expect((await redis.keys('session:v1:*')).length).toBeGreaterThan(0); + redis.disconnect(); + await request(server) + .delete('/api/v1/auth/sessions/current') + .set('Authorization', bearer(user)) + .expect(204); + await redis.connect(); + await sleep(200); + await request(server) + .get('/api/v1/users/me') + .set('Authorization', bearer(user)) + .expect(401); + expect(cache.trusted).toBe(true); + }); + it('без PostgreSQL отвечает ограниченным 503 и не пускает анонима', async () => { const healthy = await start(); const user = await registerUser(healthy.server, 'nodb');