From ab61787ee7c328abb2a03132a624847a93b8ea0596b3e929c4e382d78d727e2b Mon Sep 17 00:00:00 2001 From: AidarKC Date: Wed, 28 Oct 2026 12:51:43 +0300 Subject: [PATCH] =?UTF-8?q?=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D1=87=D0=B8=D1=81=D1=82=D1=8B=D0=B9=20=D1=81?= =?UTF-8?q?=D1=82=D0=B0=D1=80=D1=82=20PostgreSQL=20=D0=B8=20Solana=20sync?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../src/main/resources/postgres/migration_v36.sql | 4 +++- SHiNE-server/src/main/java/server/ws/WsServer.java | 10 +++++++++- VERSION.properties | 2 +- deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md | 4 ++-- docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md | 2 +- 5 files changed, 16 insertions(+), 6 deletions(-) diff --git a/SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql b/SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql index a0dc99af..f28cbe8e 100644 --- a/SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql +++ b/SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v36.sql @@ -42,7 +42,9 @@ BEGIN 'user_settings:login', 'channel_read_state:viewer_login', 'test_free_avatar_uploads:login', - 'blockchain_state:login', + -- blockchain_state — compatibility view; trigger может существовать + -- только на физической таблице хранения. + 'blockchain_state_store:login', 'user_stats_state:login', 'user_push_tokens:login', 'key_rotation_sessions:login' diff --git a/SHiNE-server/src/main/java/server/ws/WsServer.java b/SHiNE-server/src/main/java/server/ws/WsServer.java index 1c7abac7..2cb16c2d 100644 --- a/SHiNE-server/src/main/java/server/ws/WsServer.java +++ b/SHiNE-server/src/main/java/server/ws/WsServer.java @@ -19,6 +19,7 @@ import server.sync.PeriodicDmDeliveryService; import server.sync.SolanaUsersSyncStartupService; import server.sync.SyncServersBootstrapService; import server.sync.ServerConnectionPool; +import shine.db.DbController; import utils.config.AppConfig; import java.time.Duration; @@ -35,7 +36,14 @@ public final class WsServer { public static void main(String[] args) throws Exception { // ============================================================ - // 1.0) Синхронизация пользовательских Solana PDA + // 1.0) Сначала создаём полную runtime-схему SHiNE. + // Solana sync использует ту же БД и создаёт собственные таблицы; + // без этого порядка чистая БД ошибочно выглядит для runtime как legacy. + // ============================================================ + DbController.getInstance(); + + // ============================================================ + // 1.1) Синхронизация пользовательских Solana PDA // ============================================================ SolanaUsersSyncStartupService.startOrThrow(); diff --git a/VERSION.properties b/VERSION.properties index 8238bb43..b9386650 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ client.version=1.20.6 -server.version=1.16.4 +server.version=1.16.5 diff --git a/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md b/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md index 9c490a34..0dc57d3b 100644 --- a/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md +++ b/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md @@ -5,7 +5,7 @@ ## Что уже есть -- основной сервер запускает `SolanaUsersSyncStartupService` до продолжения startup; +- основной сервер сначала инициализирует полную PostgreSQL runtime-схему SHiNE, затем запускает `SolanaUsersSyncStartupService` до продолжения startup; - модуль синхронизации держит актуальными таблицы: - `solana_sync_state` - `solana_sync_tx_history` @@ -56,7 +56,7 @@ psql \ -f SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql ``` -Скрипт предназначен **только для полностью пустой PostgreSQL схемы**. На старой/непустой базе он завершится ошибкой и не выполняет in-place migration. +Скрипт предназначен **только для полностью пустой PostgreSQL схемы**. На старой/непустой базе он завершится ошибкой и не выполняет in-place migration. При обычном первом запуске вручную выполнять его не нужно: сервер сам первым создаёт полную runtime-схему, и только затем стартует Solana sync; это не даёт sync-таблицам ошибочно выглядеть как legacy-БД. Скрипт: diff --git a/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md b/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md index 875f8e41..66e90926 100644 --- a/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md +++ b/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md @@ -17,7 +17,7 @@ На дату `2026-07-24` в основном сервере SHiNE уже есть серверная интеграция startup-уровня: -- сервер запускает sync-модуль до продолжения собственного startup; +- сервер сначала инициализирует полную PostgreSQL runtime-схему, затем запускает sync-модуль до продолжения собственного startup; - server startup ждёт входа модуля в состояние `READY`; - актуальный источник истины по пользователям для нового PostgreSQL runtime-слоя: `solana_user_pda_current`. - для быстрого локального lookup единственного сервера доступа поддерживается