реализован уровень 4

This commit is contained in:
2026-10-15 20:12:22 +03:00
parent 158fed100c
commit 09b4b1d49d
25 changed files with 1794 additions and 91 deletions
+75 -7
View File
@@ -5,8 +5,38 @@
PostgreSQL является источником истины для пользователей, чатов, участников,
сообщений и сессий.
Redis будет использоваться как cache-aside кэш чатов, но не как источник
истины. Потеря Redis не должна приводить к потере данных.
Redis используется как cache-aside кэш неизменяемых карточек чатов, но не как
источник истины. Потеря Redis не приводит к потере данных или сессий.
## Redis cache-aside
Ключ:
```text
chat:v1:<chat_uuid>
```
Значение — JSON-представление `domain.Chat`: идентификатор, заголовок,
упорядоченный список участников и время создания. TTL по умолчанию — 5 минут.
Префикс `v1` версионирует внутренний формат независимо от HTTP API.
Алгоритм чтения:
1. Прочитать и проверить значение Redis.
2. При hit проверить, что вызывающий пользователь есть в `member_ids`.
3. При miss прочитать PostgreSQL и best-effort заполнить Redis.
4. При timeout/ошибке Redis прочитать PostgreSQL и не повторять cache write в
том же запросе.
Создание чата сначала полностью фиксируется транзакцией PostgreSQL, после чего
выполняется best-effort запись в Redis. Контракт не содержит изменения
заголовка или состава участников и удаления чата, поэтому write-инвалидация
сейчас не требуется. TTL удаляет забытые копии, а повреждённое значение
удаляется при чтении.
Redis работает без RDB/AOF и volume, с лимитом 64 MiB и `allkeys-lru`.
Это намеренная политика для производного кэша. Readiness зависит только от
PostgreSQL; при очистке или restart Redis данные лениво восстанавливаются.
## Общие решения
@@ -149,12 +179,17 @@ CHECK (expires_at > created_at)
Одна транзакция:
1. Проверить существование всех участников.
2. Вставить чат.
3. Вставить всех участников с позициями.
1. Вставить чат.
2. Для каждого участника выполнить параметризованный
`INSERT ... SELECT FROM users WHERE id = $2`.
3. Проверить, что каждая команда вставила ровно одну строку.
4. Выполнить COMMIT.
Любая ошибка приводит к ROLLBACK всей операции.
Если пользователя нет, `RowsAffected() == 0`: функция возвращает
`ErrNotFound`, а deferred `ROLLBACK` удаляет уже вставленный чат и предыдущие
membership-строки. Автотест отправляет существующего вызывающего и
несуществующий UUID, проверяет отсутствие частичного чата, затем успешно
создаёт другой чат через то же приложение.
### Отправка сообщения
@@ -210,6 +245,39 @@ LIMIT $4
В обоих запросах передаётся `limit + 1`. Дополнительная строка определяет,
нужно ли возвращать `next_cursor`, без отдельного `COUNT(*)`.
## План истории на 10 000 сообщений
Команда `make explain-history` открывает транзакцию, добавляет отдельные
синтетические user/chat и ровно 10 000 сообщений, выполняет `ANALYZE`, печатает
два `EXPLAIN (ANALYZE, BUFFERS)` и завершает всё `ROLLBACK`. Поэтому измерение
повторяемо и не оставляет нагрузочные строки в постоянной БД.
Для первой страницы наблюдался план:
```text
Limit (actual rows=101)
-> Index Scan using messages_chat_created_at_id_idx
Index Cond: (chat_id = ...)
Buffers: shared hit=5
Execution Time: 0.068 ms
```
Для страницы после 5000-го сообщения:
```text
Limit (actual rows=101)
-> Index Scan using messages_chat_created_at_id_idx
Index Cond: chat_id = ... AND ROW(created_at, id) > ROW(...)
Buffers: shared hit=6
Execution Time: 0.111 ms
```
Составной индекс `(chat_id, created_at, id)` одновременно соответствует
фильтру одного чата, tuple-границе keyset cursor и порядку выдачи. Поэтому
PostgreSQL не делает `Seq Scan` и не сортирует всю историю для каждой страницы.
Времена относятся только к указанному WSL2-стенду и не являются универсальным
production-бенчмарком.
## Миграции
Первая миграция создаёт таблицы в порядке:
@@ -230,4 +298,4 @@ Compose-сервис. Миграции не запускаются автома
Инструмент хранит текущую версию и состояние применения в служебной таблице
`schema_migrations`. Неуспешная миграция останавливает запуск API и требует
явного разбора причины, а не автоматического `force`.
явного разбора причины, а не автоматического `force`.