2.2 KiB
Схема и транзакции (проект до реализации запросов)
PostgreSQL — единственный источник истины. users: UUID PK, уникальный
username, display_name, hash scrypt с индивидуальной солью, UTC created_at.
chats: UUID PK, title, created_at. memberships: составной PK
(chat_id, user_id), FK на чаты и пользователей, ordinal для порядка участников.
messages: UUID PK, FK chat_id, составной FK (chat_id, sender_id) на членство,
text, created_at; B-tree (chat_id, created_at, id) для keyset-пагинации.
sessions: SHA-256 случайного токена как PK, FK user_id, expires_at; индекс
expiry. Сам bearer не сохраняется. settings: постоянный ключ подписи cursor.
schema_migrations: версия и checksum применённого файла.
Регистрация: уникальность обеспечивает БД, конфликт INSERT превращается в 409. Создание чата: INSERT чата, проверка пользователей и INSERT всех участников в одной транзакции; любая ошибка откатывает и чат, и участников. Отправка: блокировка строки чата FOR UPDATE, проверка членства, назначение времени после последнего сообщения, INSERT и COMMIT до ответа 201. Чтение: доступ и страница в одной транзакции; участники неизменяемы. Вход: KDF вне транзакции, затем INSERT сессии и COMMIT. Logout: DELETE сессии и COMMIT до 204. Expiry проверяется по часам PostgreSQL на каждом запросе и не продлевается при рестарте. Миграции: advisory transaction lock, DDL и запись версии одним COMMIT; повторный запуск не создаёт данные повторно; изменение применённой миграции — ошибка.