Files
mtusi2026lab3/SCHEMA.md
T

3.8 KiB

Lab3: общая идемпотентность и транзакции

Основа — собственная lab2. PostgreSQL остаётся источником истины пользователей, чатов, членства, сообщений и сессий. Valkey — восстанавливаемый кэш User, а не доказательство действительности Bearer. У API нет обязательного локального состояния. Каждому процессу при старте назначается случайный X-Instance-Id.

Новая миграция добавляет message_requests. Область ключа: user_id + HTTP method POST + chat_id (путь коллекции сообщений) + ASCII key. PK обеспечивает точную уникальность области; payload_hash содержит SHA-256 канонического валидированного тела. response_message_id ссылается на неизменяемое Message. Срок хранения результата не менее 86400 секунд, часы — PostgreSQL.

Отправка под READ COMMITTED:

  1. Аутентификация и проверка членства выполняются заново, включая повтор.
  2. Transaction-level advisory lock сериализует одну область между процессами. 64-битный hash используется только как lock: коллизия вызывает лишнее ожидание, но не подменяет точный PK и сравнение payload_hash.
  3. Неистёкший результат с тем же body возвращает прежнее Message/201; другой body даёт 409. Истёкшую запись ключа можно заменить, старое Message остаётся.
  4. INSERT Message и INSERT результата идут в одной транзакции. HTTP 201 выдаётся после COMMIT. Ошибка между вставками откатывает обе; 5xx не запоминаются.

Канонизация сохраняет точный text, сортирует JSON-ключи и учитывает пустой список вложений для последующего расширения. Внешняя схема lab3 по OpenAPI пока принимает только text; поля будущих лабораторных не включаются в обязательный контракт.

Миграции исполняет отдельный migrate service под advisory lock; API не запускают DDL. Миграция 002 только добавляет таблицу и индексы: она совместима с lab2, но старый API не умеет обязательную идемпотентность, поэтому его нельзя смешивать с lab3 за одним LB. Внутри lab3 поочерёдная замена процесса не меняет схему.

Исследуемая оптимизация: одиночные SELECT выполняются в autocommit, без отдельных сетевых команд BEGIN/COMMIT. PostgreSQL по-прежнему исполняет каждый SELECT в транзакции. Вставки, отзыв сессии, многокомандное создание чата и идемпотентная отправка всегда используют явную транзакцию и COMMIT до ответа. DATABASE_READ_AUTOCOMMIT=0 включает базовый вариант с явными транзакциями и для чтения; =1 — оптимизацию. Уровень изоляции, SQL, пул и обработчики одинаковы.