forked from mtusi2026/mtusi2026lab2
реализован уровень 4
This commit is contained in:
+75
-7
@@ -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`.
|
||||
|
||||
Reference in New Issue
Block a user