fix: fixes after review

This commit is contained in:
2026-10-22 12:41:28 +03:00
parent 07661cfe82
commit 5146ca8419
8 changed files with 112 additions and 11 deletions
+3 -3
View File
@@ -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] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
+5 -3
View File
@@ -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.
+5
View File
@@ -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<SessionResponse> {
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,
+28 -4
View File
@@ -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<string | null> {
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<void> {
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 {
+8 -1
View File
@@ -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[];
+25
View File
@@ -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)
+12
View File
@@ -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')
+26
View File
@@ -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');