forked from mtusi2026/mtusi2026lab3
Этот коммит впервые фиксирует порт lab2 (приложение NestJS+Fastify, Dockerfile, одноservice-стенд compose, restart hook) и добавляет уровень 3/4 по lab3: - X-Instance-Id = INSTANCE_ID либо hostname контейнера (стабилен для процесса), добавляется и в ответах об ошибках, которые формируются до интерсептора. - /internal/lb-check: проба LB, намеренно не зависящая от PostgreSQL и Redis (отказ общей БД нельзя лечить выводом реплик из ротации); /health/ready остаётся операторским сигналом. /internal/metrics отдаёт instance_id и build_id. - Общая идемпотентность POST сообщения: таблица idempotency_keys, область (user, method, path, key), канонический отпечаток тела, заявка+результат в одной транзакции, повтор возвращает сохранённый ответ, другое тело — 409, отсутствие/неверный ключ — 400, просрочка по IDEMPOTENCY_TTL_SECONDS. - Транзиентные коды PostgreSQL (57014/40001/40P01) отображаются в 503, чтобы прерывание не фиксировалось идемпотентной записью как окончательный результат. - Миграции 003 (идемпотентность) и 004 (pg_stat_statements для трека 1), операторский прогон GC: npm run idempotency:gc.
21 lines
842 B
SQL
21 lines
842 B
SQL
-- Shared idempotency ledger for POST /api/v1/chats/{id}/messages.
|
|
-- The key scope is (user, method, path, key): the same key from another user or
|
|
-- another chat is independent, as the contract requires.
|
|
-- claim + response are committed in one transaction, so a committed row always
|
|
-- carries status_code and response_body (there is no "poisoned" intermediate state).
|
|
CREATE TABLE IF NOT EXISTS idempotency_keys (
|
|
user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
|
method text NOT NULL,
|
|
path text NOT NULL,
|
|
key text NOT NULL,
|
|
request_fingerprint text NOT NULL,
|
|
status_code integer,
|
|
response_body jsonb,
|
|
message_id uuid,
|
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
PRIMARY KEY (user_id, method, path, key)
|
|
);
|
|
|
|
CREATE INDEX IF NOT EXISTS idempotency_keys_created_at_idx
|
|
ON idempotency_keys (created_at);
|