PostgreSQL runtime schema v1

Дата фиксации: 2026-07-24

Назначение

Это целевая серверная runtime-схема PostgreSQL для SHiNE без опоры на SQLite.

Схема v1 нужна как стартовая точка большого механического переноса DAO и runtime-запросов с существующей SQLite-логики на PostgreSQL.

Ключевые решения

Источник истины по пользователям: solana_user_pda_current.
Legacy-таблицы старого runtime для пользователей и личных сообщений в новой схеме не создаются.
Основная таблица серверных личных сообщений: signed_messages.
Таблица blockchain_state сохраняется как runtime-state таблица сервера: она не является identity-слоем и не мигрируется как legacy SQLite data.
Триггеры по blocks сохраняются и переписываются под PostgreSQL.

Таблицы sync-модуля Solana users

solana_sync_state
solana_sync_tx_history
solana_user_pda_current
solana_user_pda_history

Таблицы server runtime

db_schema_version
active_sessions
esp_pairing_settings
esp_pairing_requests
users_params
ip_geo_cache
test_free_avatar_uploads
sync_servers
blockchain_state
blocks
connections_state
message_stats
reactions_state
channel_names_state
chat200_state
chat200_members_state
user_push_tokens
signed_direct_message_replay
signed_direct_messages_history
signed_messages
signed_message_session_delivery

Триггеры

Схема v1 уже включает PostgreSQL-версии триггеров:

trg_blocks_line_integrity_bi
trg_blocks_connection_state_ai
trg_blocks_message_stats_like_ai
trg_blocks_message_stats_reply_ai
trg_blocks_edit_apply_ai

Что не входит в v1

полная зачистка legacy-документации, старых названий и TODO-хвостов;
переименование Java DAO/классов *V2 в runtime-коде;
перенос прямых SQL-запросов из хэндлеров в DAO/service;
переключение всего runtime-кода на новый DbProvider.

Это отдельные механические шаги поверх уже утверждённой схемы.

Совместимость со старыми блоками каналов

В runtime-сервере сознательно нет жёсткой серверной проверки channelName must not contain only digits.

Причина: в уже существующей истории блокчейна есть каналы с числовыми именами, и при холодном восстановлении сервера с пустой БД и без .bch такие блоки должны успешно переигрываться от других sync-серверов.

Сейчас правило "новый публичный канал не должен состоять только из цифр" остаётся на уровне UI/продуктовых требований и должно быть позже возвращено на сервере отдельным совместимым способом, который не ломает replay исторических блоков.

Инициализация пустой БД

Если сервер подключается к PostgreSQL через db.url=jdbc:postgresql:... и в выбранной БД ещё нет таблицы db_schema_version, он сам автоматически накатывает schema_v1.sql из classpath-ресурса:

ресурс: shine-server-db/src/main/resources/postgres/schema_v1.sql
признак пустой схемы: отсутствует db_schema_version
стартовая версия схемы: 1

4.1 KiB Raw Blame History