- X-Instance-Id в каждом ответе; обязательный Idempotency-Key, таблица idempotency_keys (миграция 0002, одна транзакция, конкурентные повторы через уникальный индекс) - graceful shutdown: SIGTERM -> ready=503 -> drain 3 с -> закрытие порта - compose: lb (HAProxy) + api x2 без портов + разовый migrate + postgres, лимиты CPU/RAM - хуки stop-one/restart/restore-replicas, scripts/experiments.py (failover, idempotency, rolling) - свои тесты: 44 (13 новых); evidence: smoke, pytest, persistence, failover, эксперименты
30 lines
1.6 KiB
Python
30 lines
1.6 KiB
Python
import uuid
|
|
from datetime import datetime
|
|
|
|
from sqlalchemy import CheckConstraint, DateTime, ForeignKey, Index, LargeBinary, Text, Uuid, text
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
|
|
from models.base import Base
|
|
|
|
|
|
class IdempotencyKey(Base):
|
|
"""Результат отправки сообщения по Idempotency-Key.
|
|
|
|
Область уникальности по контракту: пользователь + метод + путь чата + ключ.
|
|
Метод у маршрута один (POST), путь однозначно задаётся chat_id, поэтому ключ таблицы — (user_id, chat_id, key).
|
|
"""
|
|
__tablename__ = "idempotency_keys"
|
|
__table_args__ = (
|
|
CheckConstraint(r"key ~ '^[A-Za-z0-9._:-]{1,128}$'", name="key_format"),
|
|
Index("idempotency_keys_created_at_idx", "created_at"),
|
|
)
|
|
|
|
user_id: Mapped[uuid.UUID] = mapped_column(Uuid, ForeignKey("users.id"), primary_key=True)
|
|
chat_id: Mapped[uuid.UUID] = mapped_column(Uuid, ForeignKey("chats.id"), primary_key=True)
|
|
key: Mapped[str] = mapped_column(Text, primary_key=True)
|
|
# SHA-256 канонического тела запроса: тот же ключ с другим телом -> 409.
|
|
request_hash: Mapped[bytes] = mapped_column(LargeBinary)
|
|
# Заполняется в той же транзакции, что и вставка сообщения; видимой строки с NULL не бывает.
|
|
message_id: Mapped[uuid.UUID | None] = mapped_column(Uuid, ForeignKey("messages.id"))
|
|
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=text("clock_timestamp()"))
|