6.0 KiB
Модель данных PostgreSQL
PostgreSQL является первоисточником данных о пользователях, чатах, участниках чатов и сообщениях.
При запуске API инструмент Flyway применяет схему базы данных, описанную в файлах из директории src/main/resources/db/migration. Инициализация новой пустой базы данных выполняется с помощью скрипта V1__create_messenger_schema.sql.
Таблицы и ограничения
users: первичный ключ типа UUID, уникальное имя пользователя (username), проверка формата имени пользователя и длины отображаемого имени (display name), Argon2id-хеш пароля. Пароли в открытом виде не сохраняются.chats: первичный ключ типа UUID, проверка длины названия чата.chat_members: составной первичный ключ(chat_id, user_id), внешние ключи, ссылающиеся на таблицыchatsиusers. Первичный ключ предотвращает дублирование записей об участии пользователя в чате.messages: первичный ключ типа UUID. Составной внешний ключ(chat_id, sender_id) -> chat_members(chat_id, user_id)гарантирует, что сообщение может быть сохранено только от имени пользователя, который является участником данного чата.sessions: первичный ключ типа UUID, внешний ключ пользователя, уникальный SHA-256-хеш токена, время создания и истечения, а также необязательное время отзыва. Сам Bearer-токен в базе не хранится.
Проверка строковых данных осуществляется как на уровне HTTP-валидации, так и с помощью базовых ограничений SQL. Проверка символов Unicode (включая пробельные символы) выполняется на уровне приложения, поскольку механизмы регулярных выражений в PostgreSQL и классификация символов Unicode в Java не полностью идентичны.
Индексы и структура запросов
chat_members(user_id, chat_id)— индекс для поиска чатов, в которых состоит пользователь.chats(created_at, id)— индекс для обеспечения детерминированного порядка сортировки чатов.messages(chat_id, created_at, id)— индекс, поддерживающий пагинацию на основе курсоров (keyset pagination) без использования смещения (offset) или полной сортировки данных в оперативной памяти.messages(sender_id, created_at)— индекс для диагностики действий конкретного пользователя и выполнения аудиторских запросов в будущем.sessions(expires_at) WHERE revoked_at IS NULL— частичный индекс для поиска и очистки истёкших активных сессий.
Курсоры для сообщений и чатов используют тот же кортеж (created_at, id), что и соответствующее предложение ORDER BY в запросах.
Границы транзакций
Создание чата выполняется в рамках одной транзакции базы данных. Сначала вставляется запись в таблицу chats, затем — записи для каждого участника в таблицу chat_members. Если возникает дубликат или отсутствует запись об участнике, вся операция откатывается (rollback); таким образом, чат никогда не будет зафиксирован в базе данных (commit) без полного набора участников.
Создание пользователя или сообщения выполняется как атомарная транзакция, состоящая из одного SQL-оператора. Уникальность имени пользователя (username) обеспечивается на уровне базы данных с помощью ограничения users_username_uk; в случае одновременной попытки создания дубликата API возвращает ответ 409 Conflict.
Создание сессии сохраняет хеш токена и срок действия одним SQL-оператором. Bearer-аутентификация выбирает только неотозванную сессию, у которой expires_at > CURRENT_TIMESTAMP. Logout атомарно устанавливает revoked_at. Сессии находятся в PostgreSQL и переживают рестарт API и PostgreSQL при сохранении именованного volume.
Операции получения списка и поиска выполняются в режиме изоляции READ COMMITTED. Контракт API не предусматривает использование единого снимка данных (snapshot) для нескольких HTTP-запросов в рамках постраничного вывода (пагинации).