2.3 KiB
Схема и транзакционные границы
PostgreSQL — источник истины пользователей, чатов, участников и сообщений. Redis — источник истины сессий: SHA-256 токена → user_id, expires_at; TTL до абсолютного expires_at, без продления при чтении. Logout удаляет ключ. Redis использует AOF с appendfsync always и отдельный именованный volume.
- users: UUID PK, UNIQUE(username), password_hash (Argon2id), display_name, created_at.
- chats: UUID PK, title, created_at; индекс (created_at, id).
- chat_members: PK(chat_id, user_id), FK к chats/users; ordinal сохраняет порядок участников; UNIQUE(chat_id, ordinal); индекс (user_id, chat_id).
- messages: UUID PK, FK chat_id/sender_id через членство; text, created_at. Индекс (chat_id, created_at, id) отвечает равенству по чату и keyset-предикату (created_at, id) > ($timestamp, $id), ORDER BY created_at, id LIMIT $limit.
- goose_db_version: журнал goose CLI; SQL-миграция и запись её версии коммитятся в одной транзакции. Сервис migrations завершается до старта API.
Регистрация — один INSERT, гонка разрешается UNIQUE, проигравшие получают 409. Создание чата — одна транзакция: INSERT чата, затем участников; любой неверный FK откатывает всю операцию, включая уже вставленных участников. Отправка сообщения — один INSERT с FK на членство. Чтения идут в PostgreSQL, кэша истории нет, подтверждённый COMMIT виден следующему запросу. При конкурентной записи keyset не даёт snapshot: поздний COMMIT с ключом до уже прочитанного cursor может быть пропущен. created_at задаёт PostgreSQL, UUID разрешает совпадения времени; часы не используются как уникальный ID.