- 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, эксперименты
66 lines
3.3 KiB
Python
66 lines
3.3 KiB
Python
import uuid
|
|
from datetime import datetime, timedelta, timezone
|
|
|
|
from sqlalchemy import func, select, tuple_, update
|
|
from sqlalchemy.dialects.postgresql import insert
|
|
from sqlalchemy.orm import Session
|
|
|
|
from models import IdempotencyKey, Message
|
|
from utils.pagination import Position
|
|
|
|
|
|
class IdempotencyKeyReused(Exception):
|
|
"""Тот же Idempotency-Key уже использован с другим телом запроса."""
|
|
|
|
|
|
def create_message_once(db: Session, chat_id: uuid.UUID, sender_id: uuid.UUID, text: str,
|
|
key: str, request_hash: bytes, ttl_seconds: int) -> Message:
|
|
"""Создать сообщение ровно один раз для (пользователь, чат, ключ), в том числе при конкурентных повторах.
|
|
|
|
Всё в одной транзакции: «заявка» на ключ, сообщение и ссылка ключа на сообщение фиксируются вместе.
|
|
Если транзакция откатится (5xx, обрыв), ключ не сохранится и клиент безопасно повторит запрос.
|
|
Параллельный повтор через другую реплику блокируется на уникальном индексе до COMMIT первой
|
|
транзакции, затем видит её строку и возвращает то же сообщение.
|
|
"""
|
|
cutoff = datetime.now(timezone.utc) - timedelta(seconds=ttl_seconds)
|
|
claim = (
|
|
insert(IdempotencyKey)
|
|
.values(user_id=sender_id, chat_id=chat_id, key=key, request_hash=request_hash)
|
|
# Строка старше TTL считается свободной ключом: перехватываем её, остальные конфликты не меняем.
|
|
.on_conflict_do_update(
|
|
index_elements=[IdempotencyKey.user_id, IdempotencyKey.chat_id, IdempotencyKey.key],
|
|
set_={"request_hash": request_hash, "message_id": None, "created_at": func.clock_timestamp()},
|
|
where=IdempotencyKey.created_at < cutoff,
|
|
)
|
|
.returning(IdempotencyKey.key)
|
|
)
|
|
if db.execute(claim).first() is None:
|
|
existing = db.scalars(select(IdempotencyKey).where(
|
|
IdempotencyKey.user_id == sender_id, IdempotencyKey.chat_id == chat_id, IdempotencyKey.key == key,
|
|
)).one()
|
|
if existing.request_hash != request_hash:
|
|
raise IdempotencyKeyReused()
|
|
return db.get_one(Message, existing.message_id)
|
|
|
|
message = Message(chat_id=chat_id, sender_id=sender_id, text=text)
|
|
db.add(message)
|
|
db.flush()
|
|
db.execute(update(IdempotencyKey).where(
|
|
IdempotencyKey.user_id == sender_id, IdempotencyKey.chat_id == chat_id, IdempotencyKey.key == key,
|
|
).values(message_id=message.id))
|
|
db.commit()
|
|
return message
|
|
|
|
|
|
def list_messages(db: Session, chat_id: uuid.UUID, limit: int, after: Position | None) -> list[Message]:
|
|
# Keyset-пагинация по индексу messages_chat_history_idx (chat_id, created_at, id).
|
|
query = (
|
|
select(Message)
|
|
.where(Message.chat_id == chat_id)
|
|
.order_by(Message.created_at, Message.id)
|
|
.limit(limit + 1)
|
|
)
|
|
if after is not None:
|
|
query = query.where(tuple_(Message.created_at, Message.id) > tuple_(*after))
|
|
return list(db.scalars(query))
|