forked from mtusi2026/mtusi2026lab2
35 lines
6.0 KiB
Markdown
35 lines
6.0 KiB
Markdown
# Модель данных 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-запросов в рамках постраничного вывода (пагинации).
|