-- 003 (lab3): общая идемпотентность POST /chats/{chat_id}/messages. -- -- Область уникальности по контракту: пользователь + HTTP-метод + путь чата + ключ. -- Путь однозначно задаётся chat_id, метод сейчас всегда POST (колонка оставлена, -- чтобы область ключа была записана явно и расширялась без смены PK). -- -- Атомарность: строка ключа и сообщение пишутся ОДНОЙ транзакцией. -- 1. INSERT ключа (ON CONFLICT ...) — конкурентный повтор с тем же ключом -- ждёт на уникальном индексе, пока первая транзакция не завершится; -- 2. INSERT сообщения с заранее выбранным id; -- 3. COMMIT. FK message_id -> messages проверяется в момент COMMIT -- (DEFERRABLE INITIALLY DEFERRED), поэтому message_id NOT NULL с первого шага. -- Ошибка/откат на любом шаге не оставляет ни сообщения, ни ключа: -- транзиентный 5xx не фиксируется как окончательный результат. -- -- Совместимость с работающей версией (rolling update): миграция только -- добавляет новую таблицу, старые таблицы и запросы не меняются. CREATE TABLE idempotency_keys ( user_id uuid NOT NULL REFERENCES users (id) ON DELETE CASCADE, method text NOT NULL DEFAULT 'POST', chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, idem_key text NOT NULL, request_hash bytea NOT NULL, message_id uuid NOT NULL REFERENCES messages (id) ON DELETE CASCADE DEFERRABLE INITIALLY DEFERRED, created_at timestamptz NOT NULL DEFAULT clock_timestamp(), expires_at timestamptz NOT NULL, PRIMARY KEY (user_id, method, chat_id, idem_key), CONSTRAINT idempotency_keys_key_format CHECK (idem_key ~ '^[A-Za-z0-9._:-]{1,128}$'), CONSTRAINT idempotency_keys_method CHECK (method IN ('POST')), CONSTRAINT idempotency_keys_hash_len CHECK (octet_length(request_hash) = 32), CONSTRAINT idempotency_keys_expiry_after_create CHECK (expires_at > created_at) ); -- Периодическая очистка истёкших ключей (src/idempotency.py). CREATE INDEX idempotency_keys_expires_at_idx ON idempotency_keys (expires_at); -- ON DELETE CASCADE от messages без полного скана. CREATE INDEX idempotency_keys_message_id_idx ON idempotency_keys (message_id);