From 2a72842a7a6e33df9f3ff14b857cf0bf516dd8a8ef08345d3e4a66549c2d199a Mon Sep 17 00:00:00 2001 From: AidarKC Date: Thu, 12 Nov 2026 12:15:35 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B4=D0=B5=D0=BB=D0=B0=D1=82?= =?UTF-8?q?=D1=8C=20=D0=B4=D0=BE=D0=BD=D0=B0=D1=82=D1=8B=20=D0=B8=20=D1=81?= =?UTF-8?q?=D1=82=D0=B0=D1=82=D0=B8=D1=81=D1=82=D0=B8=D0=BA=D1=83=20=D0=BF?= =?UTF-8?q?=D0=BE=D0=B4=D0=B4=D0=B5=D1=80=D0=B6=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ws_protocol/JSON/JsonHandlerRegistry.java | 4 + .../channels/Net_GetSupportStats_Handler.java | 83 +++++++++++++ .../entyties/Net_GetSupportStats_Request.java | 10 ++ .../Net_GetSupportStats_Response.java | 26 +++++ .../sync/service/SupportHistoryIndexer.java | 110 +++++++++++++++++- .../service/SupportHistoryIndexerTest.java | 24 ++++ VERSION.properties | 4 +- deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md | 25 ++++ docs/API/06_Channels_Read_API.md | 42 +++++++ docs/API/09_Operations_Index.md | 1 + .../Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md | 35 +++++- shine-UI/js/components/support-stats.js | 31 ++++- shine-UI/js/pages/profile-view.js | 2 +- shine-UI/js/pages/user-profile-view.js | 2 +- shine-UI/js/services/auth-service.js | 6 + shine-UI/tests/support-phase2.test.mjs | 12 +- 16 files changed, 402 insertions(+), 15 deletions(-) create mode 100644 SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetSupportStats_Handler.java create mode 100644 SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Request.java create mode 100644 SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Response.java diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java index 4451589e..e0adcb9d 100644 --- a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java @@ -92,6 +92,7 @@ import server.logic.ws_protocol.JSON.handlers.channels.Net_GetChannelMessages_Ha import server.logic.ws_protocol.JSON.handlers.channels.Net_GetMessageThread_Handler; import server.logic.ws_protocol.JSON.handlers.channels.Net_GetMessageLikes_Handler; import server.logic.ws_protocol.JSON.handlers.channels.Net_GetSupportTotals_Handler; +import server.logic.ws_protocol.JSON.handlers.channels.Net_GetSupportStats_Handler; import server.logic.ws_protocol.JSON.handlers.channels.Net_GetPersonalDiary_Handler; import server.logic.ws_protocol.JSON.handlers.channels.Net_GetGroupDialog_Handler; import server.logic.ws_protocol.JSON.handlers.channels.Net_GetChannelsCounters_Handler; @@ -106,6 +107,7 @@ import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetGroupDial import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetMessageThread_Request; import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetMessageLikes_Request; import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportTotals_Request; +import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportStats_Request; import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetPersonalDiary_Request; import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_ListGroupChats200_Request; import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_ListSubscriptionsFeed_Request; @@ -257,6 +259,7 @@ public final class JsonHandlerRegistry { Map.entry("GetMessageThread", new Net_GetMessageThread_Handler()), Map.entry("GetMessageLikes", new Net_GetMessageLikes_Handler()), Map.entry("GetSupportTotals", new Net_GetSupportTotals_Handler()), + Map.entry("GetSupportStats", new Net_GetSupportStats_Handler()), Map.entry("GetGroupDialog", new Net_GetGroupDialog_Handler()), Map.entry("ListGroupChats200", new Net_ListGroupChats200_Handler()), Map.entry("GetChannelsCounters", new Net_GetChannelsCounters_Handler()), @@ -371,6 +374,7 @@ public final class JsonHandlerRegistry { Map.entry("GetMessageThread", Net_GetMessageThread_Request.class), Map.entry("GetMessageLikes", Net_GetMessageLikes_Request.class), Map.entry("GetSupportTotals", Net_GetSupportTotals_Request.class), + Map.entry("GetSupportStats", Net_GetSupportStats_Request.class), Map.entry("GetGroupDialog", Net_GetGroupDialog_Request.class), Map.entry("ListGroupChats200", Net_ListGroupChats200_Request.class), Map.entry("GetChannelsCounters", Net_GetChannelsCounters_Request.class), diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetSupportStats_Handler.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetSupportStats_Handler.java new file mode 100644 index 00000000..bdee6b95 --- /dev/null +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/Net_GetSupportStats_Handler.java @@ -0,0 +1,83 @@ +package server.logic.ws_protocol.JSON.handlers.channels; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import server.logic.ws_protocol.JSON.ConnectionContext; +import server.logic.ws_protocol.JSON.entyties.Net_Request; +import server.logic.ws_protocol.JSON.entyties.Net_Response; +import server.logic.ws_protocol.JSON.handlers.JsonMessageHandler; +import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportStats_Request; +import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportStats_Response; +import server.logic.ws_protocol.JSON.utils.NetExceptionResponseFactory; +import server.logic.ws_protocol.WireCodes; +import shine.db.DbController; + +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.util.Locale; + +/** + * Публичные три суммы из локальной PostgreSQL без RPC на каждый профиль. + * Индексатор формирует кеш только из финализированных on-chain донатов. + */ +public final class Net_GetSupportStats_Handler implements JsonMessageHandler { + private static final Logger log = LoggerFactory.getLogger(Net_GetSupportStats_Handler.class); + + @Override + public Net_Response handle(Net_Request baseRequest, ConnectionContext ctx) { + var req = (Net_GetSupportStats_Request) baseRequest; + String login = req.getLogin() == null ? "" : req.getLogin().trim(); + if (login.isEmpty() || login.length() > 255 || login.chars().anyMatch(c -> Character.isISOControl(c))) { + return NetExceptionResponseFactory.error(req, WireCodes.Status.BAD_REQUEST, + "bad_login", "Некорректный логин"); + } + var result = new Net_GetSupportStats_Response(); + result.setOp(req.getOp()); + result.setRequestId(req.getRequestId()); + result.setStatus(WireCodes.Status.OK); + result.setLogin(login); + result.setAvailable(false); + result.setReady(false); + result.setSupportSentLamports("0"); + result.setSupportReceivedLamports("0"); + result.setDaoDirectLamports("0"); + try (Connection c = DbController.getInstance().getConnection()) { + try (PreparedStatement ps = c.prepareStatement( + "SELECT history_complete FROM solana_support_sync_state WHERE id=1")) { + try (ResultSet rs = ps.executeQuery()) { + if (!rs.next() || !rs.getBoolean(1)) return result; + } + } + result.setReady(true); + try (PreparedStatement ps = c.prepareStatement( + "SELECT 1 FROM solana_user_pda_current WHERE normalized_login=? LIMIT 1")) { + ps.setString(1, login.toLowerCase(Locale.ROOT)); + try (ResultSet rs = ps.executeQuery()) { + if (!rs.next()) return result; // Free-пользователю не придумываем статистику + } + } + result.setAvailable(true); + try (PreparedStatement ps = c.prepareStatement(""" + SELECT support_sent, support_received, dao_direct + FROM solana_support_user_stats WHERE normalized_login=? + """)) { + ps.setString(1, login.toLowerCase(Locale.ROOT)); + try (ResultSet rs = ps.executeQuery()) { + if (rs.next()) { + result.setSupportSentLamports(rs.getBigDecimal(1).toBigIntegerExact().toString()); + result.setSupportReceivedLamports(rs.getBigDecimal(2).toBigIntegerExact().toString()); + result.setDaoDirectLamports(rs.getBigDecimal(3).toBigIntegerExact().toString()); + } + } + } + result.setReady(true); + return result; + } catch (SQLException failure) { + log.error("GetSupportStats failed for {}", login, failure); + return NetExceptionResponseFactory.error(req, WireCodes.Status.INTERNAL_ERROR, + "support_stats_unavailable", "Статистика поддержки недоступна"); + } + } +} diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Request.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Request.java new file mode 100644 index 00000000..4fa3a45a --- /dev/null +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Request.java @@ -0,0 +1,10 @@ +package server.logic.ws_protocol.JSON.handlers.channels.entyties; + +import server.logic.ws_protocol.JSON.entyties.Net_Request; + +/** Публичная статистика поддержки Paid-пользователя, логин SHiNE. */ +public final class Net_GetSupportStats_Request extends Net_Request { + private String login; + public String getLogin() { return login; } + public void setLogin(String value) { login = value; } +} diff --git a/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Response.java b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Response.java new file mode 100644 index 00000000..fb67619b --- /dev/null +++ b/SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/channels/entyties/Net_GetSupportStats_Response.java @@ -0,0 +1,26 @@ +package server.logic.ws_protocol.JSON.handlers.channels.entyties; + +import server.logic.ws_protocol.JSON.entyties.Net_Response; + +/** Суммы передаются строками в lamports: JS Number теряет точность u64. */ +public final class Net_GetSupportStats_Response extends Net_Response { + private String login; + private boolean available; + private boolean ready; + private String supportSentLamports; + private String supportReceivedLamports; + private String daoDirectLamports; + + public String getLogin() { return login; } + public void setLogin(String value) { login = value; } + public boolean isAvailable() { return available; } + public void setAvailable(boolean value) { available = value; } + public boolean isReady() { return ready; } + public void setReady(boolean value) { ready = value; } + public String getSupportSentLamports() { return supportSentLamports; } + public void setSupportSentLamports(String value) { supportSentLamports = value; } + public String getSupportReceivedLamports() { return supportReceivedLamports; } + public void setSupportReceivedLamports(String value) { supportReceivedLamports = value; } + public String getDaoDirectLamports() { return daoDirectLamports; } + public void setDaoDirectLamports(String value) { daoDirectLamports = value; } +} diff --git a/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SupportHistoryIndexer.java b/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SupportHistoryIndexer.java index 9650a7a5..55836e94 100644 --- a/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SupportHistoryIndexer.java +++ b/SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SupportHistoryIndexer.java @@ -57,8 +57,12 @@ public final class SupportHistoryIndexer { connection.setAutoCommit(false); try { for (SupportEvent event : events) { - insert(connection, signature, event); - indexed++; + // Счётчики изменяются только при действительно новой записи журнала. + // Повторная обработка одной инструкции не может удвоить суммы. + if (insert(connection, signature, event)) { + incrementUserStats(connection, event); + indexed++; + } } try (PreparedStatement stmt = connection.prepareStatement( "UPDATE solana_support_sync_state SET last_signature=?, last_slot=?, updated_at=now() WHERE id=1")) { @@ -74,6 +78,12 @@ public final class SupportHistoryIndexer { connection.setAutoCommit(true); } } + // Признак готовности устанавливается только после полного успешного прохода. + // После аварии на середине истории публичные нули не показываем. + try (PreparedStatement ready = connection.prepareStatement( + "UPDATE solana_support_sync_state SET history_complete=TRUE WHERE id=1")) { + ready.executeUpdate(); + } log.info("Support history synchronized: scanned={} newEvents={} checkpoint={}", signatures.size(), indexed, signatures.isEmpty() ? checkpoint : signatures.get(signatures.size()-1).signature()); } @@ -92,6 +102,13 @@ public final class SupportHistoryIndexer { s.executeUpdate("CREATE TABLE IF NOT EXISTS solana_support_sync_state (" + "id INT PRIMARY KEY CHECK(id=1), last_signature TEXT, last_slot BIGINT, updated_at TIMESTAMPTZ NOT NULL DEFAULT now())"); s.executeUpdate("INSERT INTO solana_support_sync_state(id) VALUES(1) ON CONFLICT DO NOTHING"); + s.executeUpdate("ALTER TABLE solana_support_sync_state ADD COLUMN IF NOT EXISTS stats_cache_ready BOOLEAN NOT NULL DEFAULT FALSE"); + s.executeUpdate("ALTER TABLE solana_support_sync_state ADD COLUMN IF NOT EXISTS history_complete BOOLEAN NOT NULL DEFAULT FALSE"); + s.executeUpdate("CREATE TABLE IF NOT EXISTS solana_support_user_stats (" + + "normalized_login TEXT PRIMARY KEY, " + + "support_sent NUMERIC(20,0) NOT NULL DEFAULT 0, " + + "support_received NUMERIC(20,0) NOT NULL DEFAULT 0, " + + "dao_direct NUMERIC(20,0) NOT NULL DEFAULT 0)"); s.executeUpdate("CREATE TABLE IF NOT EXISTS solana_support_transfers (" + "signature TEXT NOT NULL, instruction_index INT NOT NULL, slot BIGINT NOT NULL, " + "block_time BIGINT, kind TEXT NOT NULL, sender_login TEXT NOT NULL, recipient_login TEXT, " + @@ -112,9 +129,94 @@ public final class SupportHistoryIndexer { "FROM solana_support_transfers WHERE kind='USER' AND target_type=2 " + "GROUP BY channel_block_number, channel_block_hash, message_block_number, message_block_hash"); } + backfillUserStats(c); } - private static void insert(Connection c, SolanaRpcClient.SignatureRecord signature, SupportEvent event) throws SQLException { + /** Однократная миграция прежнего журнала. Исторические записи уже могли быть + * синхронизированы до появления кеша; перестраиваем его транзакционно. */ + private static void backfillUserStats(Connection c) throws SQLException { + boolean previousAutocommit = c.getAutoCommit(); + c.setAutoCommit(false); + try { + boolean ready; + try (Statement s = c.createStatement(); ResultSet r = s.executeQuery( + "SELECT stats_cache_ready FROM solana_support_sync_state WHERE id=1 FOR UPDATE")) { + if (!r.next()) throw new SQLException("Support sync state missing"); + ready = r.getBoolean(1); + } + if (!ready) { + try (Statement s = c.createStatement()) { + s.executeUpdate("DELETE FROM solana_support_user_stats"); + s.executeUpdate(""" + INSERT INTO solana_support_user_stats(normalized_login, support_sent, support_received, dao_direct) + SELECT lower(btrim(login)), SUM(sent), SUM(received), SUM(direct) + FROM ( + SELECT sender_login AS login, + CASE WHEN kind='USER' THEN amount_lamports ELSE 0 END AS sent, + 0::NUMERIC AS received, + CASE WHEN kind='DAO' THEN amount_lamports ELSE 0 END AS direct + FROM solana_support_transfers + UNION ALL + SELECT recipient_login AS login, 0::NUMERIC AS sent, + recipient_lamports AS received, 0::NUMERIC AS direct + FROM solana_support_transfers WHERE kind='USER' + ) history + GROUP BY lower(btrim(login)) + """); + s.executeUpdate("UPDATE solana_support_sync_state SET stats_cache_ready=TRUE WHERE id=1"); + } + log.info("Support user statistics cache initialized from transaction history"); + } + c.commit(); + } catch (SQLException failure) { + c.rollback(); + throw failure; + } finally { + c.setAutoCommit(previousAutocommit); + } + } + + /** Чистая функция: одинаковая раскладка используется в SQL-агрегаторе и тестах. */ + public static List userStatsIncrements(SupportEvent event) { + if ("USER".equals(event.kind())) { + return List.of( + new UserStatsIncrement(event.sender(), event.amount(), BigInteger.ZERO, BigInteger.ZERO), + new UserStatsIncrement(event.recipient(), BigInteger.ZERO, event.recipientAmount(), BigInteger.ZERO)); + } + if ("DAO".equals(event.kind())) { + return List.of(new UserStatsIncrement(event.sender(), BigInteger.ZERO, BigInteger.ZERO, event.amount())); + } + throw new IllegalArgumentException("Unknown support event kind"); + } + + public record UserStatsIncrement(String login, BigInteger sent, BigInteger received, BigInteger direct) {} + + /** Atomically update both participants after inserting the unique event. */ + private static void incrementUserStats(Connection c, SupportEvent event) throws SQLException { + for (UserStatsIncrement delta : userStatsIncrements(event)) { + addUserStats(c, delta.login(), delta.sent(), delta.received(), delta.direct()); + } + } + + private static void addUserStats(Connection c, String login, BigInteger sent, BigInteger received, BigInteger direct) + throws SQLException { + try (PreparedStatement s = c.prepareStatement(""" + INSERT INTO solana_support_user_stats(normalized_login, support_sent, support_received, dao_direct) + VALUES (lower(btrim(?)), ?, ?, ?) + ON CONFLICT (normalized_login) DO UPDATE SET + support_sent=solana_support_user_stats.support_sent+EXCLUDED.support_sent, + support_received=solana_support_user_stats.support_received+EXCLUDED.support_received, + dao_direct=solana_support_user_stats.dao_direct+EXCLUDED.dao_direct + """)) { + s.setString(1, login); + s.setBigDecimal(2, new java.math.BigDecimal(sent)); + s.setBigDecimal(3, new java.math.BigDecimal(received)); + s.setBigDecimal(4, new java.math.BigDecimal(direct)); + s.executeUpdate(); + } + } + + private static boolean insert(Connection c, SolanaRpcClient.SignatureRecord signature, SupportEvent event) throws SQLException { try (PreparedStatement s = c.prepareStatement("INSERT INTO solana_support_transfers (" + "signature,instruction_index,slot,block_time,kind,sender_login,recipient_login,amount_lamports," + "recipient_lamports,inflow_lamports,target_type,channel_block_number,channel_block_hash," + @@ -134,7 +236,7 @@ public final class SupportHistoryIndexer { s.setString(13, event.channelHash()); if (event.messageNumber() == null) s.setNull(14, Types.NUMERIC); else s.setBigDecimal(14, new java.math.BigDecimal(event.messageNumber())); s.setString(15, event.messageHash()); - s.executeUpdate(); + return s.executeUpdate() == 1; } } diff --git a/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/service/SupportHistoryIndexerTest.java b/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/service/SupportHistoryIndexerTest.java index 5fc8e548..2728d89a 100644 --- a/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/service/SupportHistoryIndexerTest.java +++ b/SHiNE-server/shine-server-solana-users-sync/src/test/java/sync/service/SupportHistoryIndexerTest.java @@ -45,4 +45,28 @@ class SupportHistoryIndexerTest { var out = new ByteArrayOutputStream();out.write(10);str(out,"alice@ns");u64(out,-1L); assertEquals("18446744073709551615", SupportHistoryIndexer.decodeInstruction(out.toByteArray(),0).amount().toString()); } + + @Test void userStatsIncrementsUseFullSentAndNetReceived() { + var out = new ByteArrayOutputStream(); + out.write(9); str(out, "Alice@NS"); str(out, "Bob@NS"); u64(out, 1000); out.write(0); + var event = SupportHistoryIndexer.decodeInstruction(out.toByteArray(), 1); + var deltas = SupportHistoryIndexer.userStatsIncrements(event); + assertEquals(2, deltas.size()); + assertEquals("Alice@NS", deltas.get(0).login()); + assertEquals(BigInteger.valueOf(1000), deltas.get(0).sent()); + assertEquals(BigInteger.ZERO, deltas.get(0).received()); + assertEquals("Bob@NS", deltas.get(1).login()); + assertEquals(BigInteger.valueOf(900), deltas.get(1).received()); + assertEquals(BigInteger.ZERO, deltas.get(1).direct()); + } + @Test void daoIncrementsOnlyDirectCounter() { + var out = new ByteArrayOutputStream(); + out.write(10); str(out, "Alice@NS"); u64(out, 500); + var deltas = SupportHistoryIndexer.userStatsIncrements( + SupportHistoryIndexer.decodeInstruction(out.toByteArray(), 0)); + assertEquals(1, deltas.size()); + assertEquals(BigInteger.ZERO, deltas.get(0).sent()); + assertEquals(BigInteger.ZERO, deltas.get(0).received()); + assertEquals(BigInteger.valueOf(500), deltas.get(0).direct()); + } } diff --git a/VERSION.properties b/VERSION.properties index eba31d07..002ce549 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ -client.version=1.20.35 -server.version=1.16.20 +client.version=1.20.36 +server.version=1.16.21 diff --git a/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md b/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md index 78276229..79abae9b 100644 --- a/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md +++ b/deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md @@ -170,3 +170,28 @@ SELECT schema_version FROM db_schema_version WHERE id=1; ### Обновление namespace registration_fee / currency_code Серверная БД мигрирует v39→v40 (колонка `shine_namespace_current.currency_code`). Перед активацией нового контракта следует установить совместимый сервер-sync: новый opcode 8 индексируется через историю economy PDA, namespace 1.0/1.1 читаются совместимо, `UPSERT` обновляет цену вместо прежней ошибочной проверки `raw_data_base64 = EXCLUDED.raw_data_base64`. Проверить `GetNamespaces` и `CheckRegistrationLogin` после подтверждения транзакции; при задержке history polling информация может обновиться не мгновенно. + + +## Кеш статистики поддержки профилей (12.11.2026) + +Новых настроек и отдельных сервисов нет. При `solana.users.sync.enabled=true` +существующий `SupportHistoryIndexer` использует прежнее Solana RPC/Helius и +PostgreSQL подключение. При первом запуске обновлённой версии автоматически +создаёт таблицу `solana_support_user_stats` и пересчитывает прошлые донаты из +`solana_support_transfers`. После этого новые финализированные переводы +увеличивают готовые счётчики инкрементально. При первом восстановлении +с нуля `GetSupportStats` возвращает `ready=false` до конца сканирования. + +Для диагностики (вручную выполнять при установке **не требуется**): + +```sql +SELECT history_complete, stats_cache_ready, last_signature, updated_at +FROM solana_support_sync_state WHERE id=1; + +SELECT normalized_login, support_sent, support_received, dao_direct +FROM solana_support_user_stats ORDER BY support_received DESC LIMIT 20; +``` + +В случае подозрения на рассогласование кеша остановить синхронизатор, +выполнить `UPDATE solana_support_sync_state SET stats_cache_ready=FALSE WHERE id=1` +и вновь запустить. Журнал финансовых операций при этом сохраняется. diff --git a/docs/API/06_Channels_Read_API.md b/docs/API/06_Channels_Read_API.md index 5d409b35..10ff4b75 100644 --- a/docs/API/06_Channels_Read_API.md +++ b/docs/API/06_Channels_Read_API.md @@ -659,3 +659,45 @@ Changing `account_role` or `shine` does not alter the raw reaction. The two qual API считает только `support_user` из таблицы `solana_support_transfers`. Для CHANNEL проверяет, что адресат равен владельцу существующего канала. Для MESSAGE проверяет наличие блока с точным номером/хешем, авторство получателя и принадлежность блока цепочке владельца канала. Не соответствующие этим условиям донаты остаются в истории, но не включаются в публичные суммы. Поддержка ответов в других пользовательских цепочках не попадает в агрегат до добавления полной проверки принадлежности обсуждению. Таблицы истории автоматически создаются финансовым индексатором. Пока он не синхронизирован, операция может возвращать `support_totals_unavailable` — клиент не должен подменять отсутствие данных нулями. + + +## GetSupportStats — публичные счётчики поддержки Paid-пользователя + +Счётчики загружаются из PostgreSQL, а не через отдельный RPC Solana при каждом +открытии профиля. Серверный `SupportHistoryIndexer` собирает кеш из успешных +финализированных транзакций `shine_users` (opcodes 9 и 10). Исходная проверяемая +финансовая статистика хранится в Solana PDA; кеш может отставать до следующего sync. + +**Запрос:** + +```json +{"op":"GetSupportStats","requestId":"support-1","payload":{"login":"Alice@namespace"}} +``` + +**Ответ:** + +```json +{ + "op":"GetSupportStats", "requestId":"support-1", "status":200, "ok":true, + "payload":{ + "login":"Alice@namespace", "available":true, "ready":true, + "supportSentLamports":"1000000000", + "supportReceivedLamports":"900000000", + "daoDirectLamports":"100000000" + } +} +``` + +- `available=false` — локальный Solana sync не содержит Paid PDA (например, + Free-аккаунт). Поля сумм в этом случае не показывать. +- `ready=false` — сервер ещё не закончил первичную индексацию всей доступной истории; + суммы **нельзя** показывать как окончательные (даже если возвращены нули). +- `available=true, ready=true`, а строки сумм равны `"0"` — корректная нулевая + статистика зарегистрированного Paid-пользователя без донатов. +- Все значения lamports передаются **строками** (без преобразования в JS Number). + Показатель «Поддержал SHiNE» вычисляется как `supportSentLamports / 10 + + daoDirectLamports`. Регистрация и изменение PDA сюда не входят. + +При отсутствии таблиц/соединения БД сервер возвращает ошибку, а не фиктивные нули. +API не запускает RPC-вызовы; для свежих значений сразу после оплаты необходимо +дождаться следующего прохода `SupportHistoryIndexer`. diff --git a/docs/API/09_Operations_Index.md b/docs/API/09_Operations_Index.md index cd0e7d33..48f5751a 100644 --- a/docs/API/09_Operations_Index.md +++ b/docs/API/09_Operations_Index.md @@ -69,6 +69,7 @@ | `GetMessageThread` | `06_Channels_Read_API.md` | тред сообщения | | `GetMessageLikes` | `06_Channels_Read_API.md` | списки пользователей, поставивших лайк сообщению | | `GetSupportTotals` | `06_Channels_Read_API.md` | подтверждённые суммы поддержки канала и публикаций | +| `GetSupportStats` | `06_Channels_Read_API.md` | три кешированных счётчика поддержки Paid-пользователя | | `GetPersonalDiary` | `06_Channels_Read_API.md` | виртуальный канал `Личный дневник` из STATUS_ACTION | | `ListUserProfileChannels` | `06_Channels_Read_API.md` | публичные каналы профиля | | `ListUserProfileRelations` | `11_Connections_API.md` | связи пользователя в профиле | diff --git a/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md b/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md index 9fcd5c34..4e6be7dd 100644 --- a/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md +++ b/docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md @@ -643,7 +643,7 @@ Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт e Синхронизатор распознаёт инструкции `shine_users` 9 (`SUPPORT_USER`) и 10 (`SUPPORT_DAO`) в истории подтверждённых транзакций. Их параметры остаются бинарными данными инструкции; окончательные пользовательские счётчики всегда -считываются из PDA Solana, а не пересчитываются из PostgreSQL. +достоверны в PDA Solana; сервер хранит отдельный индекс для быстрого отображения. ## Финансовый журнал поддержки (12.11.2026) @@ -651,8 +651,39 @@ Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт e Индексатор опрашивает `getSignaturesForAddress(shine_users_economy_config)` на **finalized** RPC (рекомендуется архивный Helius endpoint), при первом запуске читает все доступные подписи до начала истории, затем обрабатывает от старых к новым. Для успешных транзакций считывает `getTransaction(jsonParsed)` и все инструкции `shine_users.support_user` (tag 9) и `shine_users.support_dao` (tag 10). Учитывает несколько инструкций в одной транзакции. Суммы сохраняются в PostgreSQL `NUMERIC(20,0)`, поскольку Solana `u64` может превышать Java `long`. -Таблицы: `solana_support_sync_state`, `solana_support_transfers`; представления: `solana_support_channel_totals`, `solana_support_message_totals`. В SQL-представлениях суммы **без проверки авторства**: нельзя публично показывать их напрямую! Для API `GetSupportTotals` добавлена проверка через таблицы `channel_names_state` и `blocks`. Пользовательский профиль продолжает читать ончейн-счётчики из PDA. +Таблицы: `solana_support_sync_state`, `solana_support_transfers`, `solana_support_user_stats`; представления: `solana_support_channel_totals`, `solana_support_message_totals`. В SQL-представлениях суммы **без проверки авторства**: нельзя публично показывать их напрямую! Для API `GetSupportTotals` добавлена проверка через таблицы `channel_names_state` и `blocks`. Профили получают три кешированных счётчика через `GetSupportStats` (PostgreSQL), +не делая Solana RPC при каждом просмотре. Checkpoint обновляется в той же PostgreSQL-транзакции, что и запись всех донатов из Solana-транзакции. Повторный запуск продолжает с последней успешно обработанной подписи. При недоступной исторической транзакции или исчезнувшей checkpoint-подписи синхронизация **останавливается с ошибкой**, а не перескакивает вперёд; требуется RPC с полной историей. Наличие `getSignaturesForAddress` само по себе НЕ гарантирует архивную полноту Helius/RPC. Начальные транзакции должны быть доступны провайдеру. Индексатор включается вместе с `solana.users.sync.enabled=true`, использует те же PostgreSQL credentials и RPC URL. Реальный прогон полной архивной истории, тестирование с живым Helius и публичный API проверенных агрегатов требуют отдельной интеграционной проверки перед production. + + +### Кеш пользовательских счётчиков поддержки (12.11.2026) + +`solana_support_user_stats` хранит `normalized_login` и три поля +`NUMERIC(20,0)`: `support_sent`, `support_received`, `dao_direct`. +При первом запуске обновлённого индексатора существующий `solana_support_transfers` +**однократно** агрегируется в кеш: это позволяет обновить сервер без сброса +накопленной истории. Флаг `stats_cache_ready` в `solana_support_sync_state` +предотвращает повторный полный подсчёт при каждом запуске. + +Далее каждая новая уникальная инструкция записывается в журнал и увеличивает +счётчики соответствующих пользователей **в одной PostgreSQL-транзакции с +checkpoint**. Повторная инструкция с теми же `(signature, instruction_index)` +не увеличивает кеш. Для `support_user`: отправителю прибавляется вся сумма, +получателю — 90%. Для `support_dao`: отправителю прибавляется вся сумма в +`dao_direct`. Первая история может занимать время; флаг `history_complete` +становится TRUE только после успешного полного прохода. API `GetSupportStats` +при FALSE возвращает `ready=false`, чтобы не показывать неполные суммы. + +Free-аккаунты не имеют Paid PDA; API использует `solana_user_pda_current` +и возвращает `available=false` без демонстрации фиктивной статистики. +Текущая статистика может отставать от Solana до следующего poll. Для аудита +возможна отдельная сверка с полями `SupportStats` ончейн PDA. + +**Восстановление кеша:** при необходимости полного пересчёта из сохранённого +журнала транзакций на остановленном синхронизаторе выполнить +`UPDATE solana_support_sync_state SET stats_cache_ready=FALSE WHERE id=1`, +после чего запустить синхронизатор. Не удалять journal/checkpoint без специальной +процедуры повторной полной индексации. diff --git a/shine-UI/js/components/support-stats.js b/shine-UI/js/components/support-stats.js index 740d2996..d6dd344c 100644 --- a/shine-UI/js/components/support-stats.js +++ b/shine-UI/js/components/support-stats.js @@ -1,5 +1,5 @@ import { t } from '../i18n/index.js'; -import { readShineUserPda } from '../services/shine-user-pda-service.js'; +import { authService } from '../state.js'; import { formatLamportsSol } from '../services/shine-support-amount.js'; export function supportStatsValues(stats = {}) { @@ -10,7 +10,7 @@ export function supportStatsValues(stats = {}) { } /** Adds an independent asynchronous block; failure/Free accounts do not get fictitious statistics. */ -export function attachSupportStats(parent, { login, solanaEndpoint, isActive = () => true }) { +export function attachSupportStats(parent, { login, isActive = () => true }) { const section = document.createElement('section'); section.className = 'card stack profile-support-stats'; section.style.cssText = 'margin-top:12px;gap:8px;'; @@ -21,11 +21,34 @@ export function attachSupportStats(parent, { login, solanaEndpoint, isActive = ( content.textContent = t('screens.support_phase2.loading'); section.append(title, content); parent.append(section); + let pendingRefresh = null; + const scheduleRetry = () => { + if (pendingRefresh !== null) return; + pendingRefresh = window.setTimeout(() => { + pendingRefresh = null; + if (isActive() && section.isConnected) void refresh(); + }, 10_000); + }; const refresh = async () => { try { - const pda = await readShineUserPda({ login, solanaEndpoint }); + const stats = await authService.getSupportStats(login); if (!isActive() || !section.isConnected) return; - const values = supportStatsValues(pda.supportStats ?? {}); + if (!stats.ready) { + // Первичная индексация ещё идёт. Повторим запрос к кешу без RPC Solana. + content.textContent = t('screens.support_phase2.loading'); + scheduleRetry(); + return; + } + if (!stats.available) { + // Free-аккаунты не имеют Paid PDA, поэтому блок статистики не показываем. + section.remove(); + return; + } + const values = supportStatsValues({ + supportSent: stats.supportSentLamports, + supportReceived: stats.supportReceivedLamports, + daoDirect: stats.daoDirectLamports, + }); content.replaceChildren(); content.className = 'stack'; [t('screens.support_phase2.sent'), t('screens.support_phase2.received'), t('screens.support_phase2.shine')].forEach((label, idx) => { diff --git a/shine-UI/js/pages/profile-view.js b/shine-UI/js/pages/profile-view.js index 5d1bfd45..3941155a 100644 --- a/shine-UI/js/pages/profile-view.js +++ b/shine-UI/js/pages/profile-view.js @@ -67,7 +67,7 @@ export function render({ navigate, chrome }) { `; - attachSupportStats(body, { login: card.login || login, solanaEndpoint: state.entrySettings.solanaServer, isActive: () => !disposed }); + attachSupportStats(body, { login: card.login || login, isActive: () => !disposed }); avatarPreview = attachProfileAvatarPreview(body.querySelector('.user-profile-avatar-slot'), card); status.replaceChildren(); diff --git a/shine-UI/js/pages/user-profile-view.js b/shine-UI/js/pages/user-profile-view.js index 7e5d08f6..a6392370 100644 --- a/shine-UI/js/pages/user-profile-view.js +++ b/shine-UI/js/pages/user-profile-view.js @@ -67,7 +67,7 @@ export function render({ navigate, route, chrome }) { ].join(''), }); - attachSupportStats(body, { login: card.login, solanaEndpoint: state.entrySettings.solanaServer, isActive: () => !disposed }); + attachSupportStats(body, { login: card.login, isActive: () => !disposed }); syncRelationTile(); avatarPreview = attachProfileAvatarPreview(body.querySelector('.user-profile-avatar-slot'), card); diff --git a/shine-UI/js/services/auth-service.js b/shine-UI/js/services/auth-service.js index ca782be8..9cd416f0 100644 --- a/shine-UI/js/services/auth-service.js +++ b/shine-UI/js/services/auth-service.js @@ -1598,6 +1598,12 @@ export class AuthService { return response.payload || {}; } + async getSupportStats(login) { + const response = await this.ws.request('GetSupportStats', { login: String(login || '').trim() }); + if (response.status !== 200) throw opError('GetSupportStats', response); + return response.payload || {}; + } + async getSupportTotals(channel) { const payload = { channelRootBlockNumber: Number(channel?.channelRootBlockNumber), diff --git a/shine-UI/tests/support-phase2.test.mjs b/shine-UI/tests/support-phase2.test.mjs index 095dfcb5..c9f0c77d 100644 --- a/shine-UI/tests/support-phase2.test.mjs +++ b/shine-UI/tests/support-phase2.test.mjs @@ -8,9 +8,10 @@ function file(path) { return readFileSync(new URL(path, import.meta.url), 'utf8' test('three displayed counters: full sent, net received, sent/10 + direct', () => { assert.deepEqual(supportStatsValues({ supportSent: 1_000_000_000n, supportReceived: 900_000_000n, daoDirect: 200_000_000n }), [1_000_000_000n, 900_000_000n, 300_000_000n]); assert.deepEqual(supportStatsValues({}), [0n, 0n, 0n]); + assert.deepEqual(supportStatsValues({ supportSent: '10000000000000000000', supportReceived: '9000000000000000000', daoDirect: '250000000000000000' }), [10000000000000000000n, 9000000000000000000n, 1250000000000000000n]); }); -test('profile views attach counters from Solana PDA and support user action', () => { +test('profile views attach counters from server cache and support user action', () => { assert.match(file('../js/pages/profile-view.js'), /attachSupportStats\(body/); const other = file('../js/pages/user-profile-view.js'); assert.match(other, /attachSupportStats\(body/); @@ -41,3 +42,12 @@ test('shared modal protects direct and tracked workflows', () => { assert.match(src, /window\.confirm\(t\('screens\.support_phase2\.direct_warning'\)\)/); assert.match(src, /amount % 10n/); }); + +test('profile statistics use server API without Solana RPC', () => { + const component = file('../js/components/support-stats.js'); + const auth = file('../js/services/auth-service.js'); + assert.match(component, /authService\.getSupportStats\(login\)/); + assert.doesNotMatch(component, /readShineUserPda/); + assert.match(component, /if \(!stats\.ready\)/); + assert.match(auth, /this\.ws\.request\('GetSupportStats'/); +});