Сервер: начать перенос runtime БД на PostgreSQL

2026-07-24 21:20:36 +04:00
parent f9dd245481
commit 5326ad85d8
53 changed files with 1741 additions and 297 deletions
@@ -0,0 +1,79 @@
+# PostgreSQL runtime schema v1
+
+Дата фиксации: `2026-07-24`
+
+## Назначение
+
+Это целевая серверная runtime-схема PostgreSQL для SHiNE без опоры на SQLite.
+
+Схема `v1` нужна как стартовая точка большого механического переноса DAO и runtime-запросов
+с существующей SQLite-логики на PostgreSQL.
+
+## Ключевые решения
+
+- Источник истины по пользователям: `solana_user_pda_current`.
+- Legacy-таблица `solana_users` в новой схеме не создаётся.
+- Legacy-таблица `direct_messages` в новой схеме не создаётся.
+- Основная таблица серверных личных сообщений: `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 SQLite-классов;
+- переименование Java DAO/классов `*V2` в runtime-коде;
+- перенос прямых SQL-запросов из хэндлеров в DAO/service;
+- переключение всего runtime-кода на новый `DbProvider`.
+
+Это отдельные механические шаги поверх уже утверждённой схемы.
+
+## Инициализация пустой БД
+
+Если сервер подключается к 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`