Унифицировать платный статус регистрации

This commit is contained in:
AidarKC
2026-10-28 11:28:59 +03:00
parent a22f590395
commit ce97171d5a
12 changed files with 183 additions and 35 deletions
@@ -25,11 +25,13 @@ public final class DatabaseInitializer {
public static final int SCHEMA_VERSION_32 = 32;
public static final int SCHEMA_VERSION_33 = 33;
public static final int SCHEMA_VERSION_34 = 34;
public static final int SCHEMA_VERSION_35 = 35;
public static final String POSTGRES_SCHEMA_RESOURCE = "postgres/schema_v1.sql";
public static final String POSTGRES_MIGRATION_V31_RESOURCE = "postgres/migration_v31.sql";
public static final String POSTGRES_MIGRATION_V32_RESOURCE = "postgres/migration_v32.sql";
public static final String POSTGRES_MIGRATION_V33_RESOURCE = "postgres/migration_v33.sql";
public static final String POSTGRES_MIGRATION_V34_RESOURCE = "postgres/migration_v34.sql";
public static final String POSTGRES_MIGRATION_V35_RESOURCE = "postgres/migration_v35.sql";
private DatabaseInitializer() {}
@@ -137,9 +139,13 @@ public final class DatabaseInitializer {
runSqlScript(conn, POSTGRES_MIGRATION_V34_RESOURCE);
currentVersion = readCurrentSchemaVersion(conn);
}
if (currentVersion != SCHEMA_VERSION_34) {
if (currentVersion == SCHEMA_VERSION_34) {
runSqlScript(conn, POSTGRES_MIGRATION_V35_RESOURCE);
currentVersion = readCurrentSchemaVersion(conn);
}
if (currentVersion != SCHEMA_VERSION_35) {
throw new SQLException(
"Unsupported SHiNE DB v2 schema version: expected 34, found " + currentVersion);
"Unsupported SHiNE DB v2 schema version: expected 35, found " + currentVersion);
}
}
}
@@ -0,0 +1,62 @@
-- v35: один полноценный статус для всех зарегистрированных в Solana.
-- Старые регистрационные сертификаты Arweave и дата исходной регистрации сохраняются.
BEGIN;
-- Сначала снимаем старое ограничение, затем переводим существующие строки.
ALTER TABLE user_identity_current
DROP CONSTRAINT user_identity_current_registration_status_check;
UPDATE user_identity_current
SET registration_status = 'PAID'
WHERE registration_status IN ('PAID_DIRECT', 'PAID_UPGRADED');
ALTER TABLE user_identity_current
ADD CONSTRAINT user_identity_current_registration_status_check
CHECK (registration_status IN ('FREE_CERT', 'PAID'));
-- Важнее миграции существующих строк: при следующих Solana sync/upsert
-- и обычный платный, и ранее бесплатный пользователь получают тот же PAID.
CREATE OR REPLACE FUNCTION shine_sync_identity_from_solana()
RETURNS TRIGGER LANGUAGE plpgsql AS $$
DECLARE old_user user_identity_current%ROWTYPE;
BEGIN
-- Если PostgreSQL получил старую запись из replay, она не должна затереть
-- уже принятую более новую логическую идентичность в BEFORE INSERT.
IF TG_OP = 'INSERT' AND EXISTS (
SELECT 1 FROM solana_user_pda_current prior
WHERE prior.pda_address = NEW.pda_address AND prior.record_number > NEW.record_number
) THEN
RETURN NEW;
END IF;
SELECT * INTO old_user FROM user_identity_current
WHERE normalized_login = NEW.normalized_login FOR UPDATE;
IF FOUND AND old_user.registration_status = 'FREE_CERT' AND
(old_user.root_key <> NEW.root_key OR old_user.client_key <> NEW.client_key OR old_user.blockchain_key <> NEW.blockchain_key) THEN
RAISE EXCEPTION 'Free certificate keys differ from Solana upgrade for %', NEW.login;
END IF;
IF FOUND AND old_user.solana_pda_address IS NOT NULL AND old_user.solana_pda_address <> NEW.pda_address THEN
RAISE EXCEPTION 'Duplicate on-chain identity for %', NEW.login;
END IF;
INSERT INTO user_identity_current (
login, normalized_login, namespace, registration_source, registration_status,
solana_pda_address, free_data_item_id, root_key, client_key, blockchain_key,
blockchain_name, is_server, registered_at_ms, updated_at_ms)
VALUES (NEW.login, NEW.normalized_login,
CASE WHEN position('@' in NEW.login) > 0 THEN split_part(NEW.login,'@',2) ELSE NULL END,
'SOLANA', 'PAID',
NEW.pda_address, old_user.free_data_item_id, NEW.root_key, NEW.client_key,
NEW.blockchain_key, NEW.blockchain_name, NEW.is_server,
COALESCE(old_user.registered_at_ms, NEW.created_at_ms), NEW.updated_at_ms)
ON CONFLICT (login) DO UPDATE SET
registration_source='SOLANA',
registration_status=EXCLUDED.registration_status,
solana_pda_address=EXCLUDED.solana_pda_address,
root_key=EXCLUDED.root_key, client_key=EXCLUDED.client_key,
blockchain_key=EXCLUDED.blockchain_key, blockchain_name=EXCLUDED.blockchain_name,
is_server=EXCLUDED.is_server, updated_at_ms=EXCLUDED.updated_at_ms;
RETURN NEW;
END $$;
UPDATE db_schema_version
SET schema_version=35,
updated_at_ms=CAST(EXTRACT(EPOCH FROM clock_timestamp())*1000 AS BIGINT)
WHERE id=1;
COMMIT;
+2 -2
View File
@@ -1,2 +1,2 @@
client.version=1.20.3
server.version=1.16.2
client.version=1.20.4
server.version=1.16.3
+19
View File
@@ -130,3 +130,22 @@ Migration v26 добавляет server-local поля `rotation_status` / `rota
## Этапы регистрации V2 4–7: подготовка тестового окружения (23.10.2026)
Перед запуском новой синхронизации нужен тестовый `shine_users` (opcode 7, namespace accounts), применённая PostgreSQL v33, бэкап и отдельная БД. Только после этого разрешён импорт namespace в отдельный регистр `shine_namespace_current`. Не совмещать с существующим UI/production. `freeRegistration.enabled` по умолчанию false; `freeRegistration.registrarSeedFile` — локальный secret path (Base64 seed32) вне Git. При несоответствии регистратора публичному ключу on-chain namespace выдача сертификата прекращается. Нет Arweave importer до этапа 8, API/UI до этапов 9–10. Сначала прогоните чистый snapshot, историю, restart/replay, FK и ключевую ротацию на тестовом контуре.
## DB v35: единый платный статус (26.10.2026)
`DatabaseInitializer` при запуске сервера последовательно обновляет схему до v35. Старые
`PAID_DIRECT` и `PAID_UPGRADED` преобразуются в единый `PAID`; `FREE_CERT` не изменяется.
Любой новый пользователь с настоящей PDA Solana получает `PAID` независимо от способа регистрации.
Данные аккаунтов, Arweave-сертификаты, начальная дата регистрации и ключи не удаляются.
Порядок на тестовом контуре: резервная копия БД → обновление серверного кода с `migration_v35.sql`
→ перезапуск и проверка `db_schema_version=35` → обновление UI → пробная регистрация и upgrade.
До обновления сервера или при неудачной миграции оставьте существующий UI: новое значение `PAID`
должно приходить только от сервера с применённой v35. На production — отдельное согласование.
Для проверки статусов после миграции:
```sql
SELECT registration_status, count(*) FROM user_identity_current GROUP BY registration_status;
SELECT schema_version FROM db_schema_version WHERE id=1;
```
+10
View File
@@ -107,3 +107,13 @@
- `GetRegistrationStatus` — статус и публичные поля сертификата для upgrade.
Точный JSON и ограничения: `docs/registration-v2/WS_REGISTRATION_V2_PROPOSED_NOT_ENABLED.md` (имя сохранено для обратных ссылок; внутри утверждённая версия).
### `GetRegistrationStatus` после DB v35
Для существующего пользователя `payload.registrationStatus` имеет одно из **двух** значений:
`FREE_CERT` (бесплатная регистрация Arweave) или `PAID` (подтверждённая PDA Solana).
`PAID` применяется и к первоначально платным, и к ранее бесплатным пользователям;
`NOT_FOUND` остаётся техническим ответом для отсутствующего логина.
Во время поэтапного развертывания старый сервер может ещё возвращать `PAID_DIRECT`
или `PAID_UPGRADED`; обновлённый UI понимает эти устаревшие ответы как платные.
Поля сертификата для `FREE_CERT` и остальные поля API не меняются.
+1 -1
View File
@@ -2,7 +2,7 @@
`GetMyBlockchain` — авторизованное постраничное чтение **только текущей активной версии собственного блокчейна**. API используется постоянным экраном «Мой блокчейн» и мастером смены ключей для выбора последнего доверенного блока.
Login сервер берёт только из авторизованной пользовательской сессии. Активное `blockchainName` определяется через общий реестр `user_identity_current` (DAO `CurrentUsersDAO`): для `PAID_DIRECT`/`PAID_UPGRADED` он синхронизирован с Solana, для `FREE_CERT` — с проверенным сертификатом Arweave. Наличие пользовательского Solana PDA **не требуется** для чтения собственного блокчейна. Клиент не может запросить этим методом чужую цепочку.
Login сервер берёт только из авторизованной пользовательской сессии. Активное `blockchainName` определяется через общий реестр `user_identity_current` (DAO `CurrentUsersDAO`): для `PAID` он синхронизирован с Solana, для `FREE_CERT` — с проверенным сертификатом Arweave. Наличие пользовательского Solana PDA **не требуется** для чтения собственного блокчейна. Клиент не может запросить этим методом чужую цепочку.
У только что зарегистрированного пользователя до первого `HEADER` может отсутствовать запись с блоками: тогда при существующей идентичности возвращается `status=200`, `tipBlockNumber=-1`, `blocks=[]`, а не `BLOCKCHAIN_NOT_FOUND`. Ошибка `BLOCKCHAIN_NOT_FOUND` относится к отсутствующему пользователю или отсутствующему в его записи имени блокчейна; отсутствие блоков само по себе не является ошибкой. Это изменение внутреннего источника поиска, **без изменения JSON-полей, op или кодировки блоков**.
@@ -613,6 +613,6 @@ Arweave/Turbo publisher обрабатывает candidate-блоки приор
## V2 регистрация — разработка (2026-10-23, этап 6, без развёртывания)
Для новых `login@namespace` используется `SHA256(UTF8("user_login=" + fullLogin))` как один 32-byte PDA seed; для namespace — `SHA256(UTF8("namespace=" + namespace))`. `IX_CREATE_NAMESPACE=7` читается как отдельное событие. `SolanaUsersSyncService` декодирует namespace независимо от user-PDA и сохраняет снапшоты namespaces в `shine_namespace_current`; paid user-PDA параллельно синхронизируются как прежде. При upsert Solana запись переносит логического пользователя `FREE_CERT → PAID_UPGRADED` без изменения логина и исходной даты в user_identity_current; free-сертификат не превращается в фальшивый Solana PDA. Общий индекс только в миграции DB v33. При запуске standalone sync сначала выполнить v33 migration через Java-сервер.
Для новых `login@namespace` используется `SHA256(UTF8("user_login=" + fullLogin))` как один 32-byte PDA seed; для namespace — `SHA256(UTF8("namespace=" + namespace))`. `IX_CREATE_NAMESPACE=7` читается как отдельное событие. `SolanaUsersSyncService` декодирует namespace независимо от user-PDA и сохраняет снапшоты namespaces в `shine_namespace_current`; paid user-PDA параллельно синхронизируются как прежде. При upsert Solana запись переносит логического пользователя `FREE_CERT → PAID` без изменения логина и исходной даты в `user_identity_current`; free-сертификат не превращается в фальшивый Solana PDA. Общий индекс появляется в DB v33. Миграция DB v35 консолидирует исторические `PAID_DIRECT`/`PAID_UPGRADED` в `PAID` и переопределяет Solana-trigger, чтобы все последующие PDA синхронизировались в одном платном статусе. `free_data_item_id` и `free_registration_certificate` остаются как свидетельства первоначальной бесплатной регистрации, но не создают особый статус. Standalone sync можно запускать только после применения миграций DB v33–v35 через Java-сервер.
**ВНИМАНИЕ:** проверить на настоящем PostgreSQL + RPC replay до включения. Read-only economy-PDA остаётся индексом истории через `getSignaturesForAddress`, не гарантирует websocket account notification.
@@ -0,0 +1,24 @@
# SHiNE — два состояния регистрации (DB v35, 26 октября 2026)
Актуальное продуктовое правило: **`FREE_CERT`** — есть серверный сертификат в Arweave,
но нет Solana PDA; **`PAID`** — подтверждён пользовательский PDA в Solana.
`PAID` равнозначен для прямой регистрации и перехода `FREE_CERT → PAID`.
- Логин, namespace и первые три ключа при переходе не меняются.
- `registered_at_ms` у перешедшего пользователя остаётся датой исходной регистрации.
Дата создания PDA остаётся в отдельном on-chain/account snapshot.
- Исходные Arweave DataItem и `free_registration_certificate` сохраняются для проверки
исторических событий; отдельная статистика способа регистрации не добавляется.
- В `migration_v35.sql` старые `PAID_DIRECT`/`PAID_UPGRADED` конвертируются в `PAID`,
статус ограничивается двумя значениями, а Solana sync-триггер при каждом upsert пишет `PAID`.
- `GetRegistrationStatus` возвращает `FREE_CERT`, `PAID` или `NOT_FOUND` для отсутствующего
логина. Новых API-полей или операций нет.
- В настройках предложение закрепить аккаунт видно только для `FREE_CERT`. После подтверждения
Solana PDA и серверной синхронизации пользователь видит поздравление и предложение исчезает.
- Промежуточная совместимость в UI допускает чтение старых платных статусов со старого сервера,
но после DB v35 они не хранятся и больше не генерируются.
- Не изменять исторические миграции v33/v34 и старые планы этапов: они отражают прежние
этапы проекта. Источником актуального состояния является этот документ и DB v35.
Перед обновлением production необходима резервная копия PostgreSQL и реальное
интеграционное тестирование миграции, синхронизации и повторного входа.
@@ -105,9 +105,9 @@ export function render({ navigate, chrome }) {
const done = element('div', 'card stack');
done.append(
element('h3', '', 'Аккаунт зарегистрирован в Solana!'),
element('h3', '', 'Поздравляем! Ваш аккаунт теперь полноценный!'),
element('p', 'meta-muted', `Ваш логин ${login} и namespace не изменились. Регистрация подтверждена PDA Solana. Прежние ключи и история сохранены.`),
element('p', 'meta-muted', 'Теперь вы можете управлять ключами и выбирать совместимые серверы доступа.'),
element('p', 'meta-muted', 'Регистрация подтверждена Solana. Теперь вы самостоятельно управляете ключами и можете переходить между совместимыми серверами доступа.'),
);
const settingsButton = makeButton('Вернуться в настройки');
settingsButton.addEventListener('click', () => navigate('settings-view'));
@@ -226,7 +226,8 @@ export function render({ navigate, chrome }) {
if (!login.includes('@')) throw new Error('Войдите в существующий аккаунт login@namespace');
const current = await getRegistrationStatus(login);
if (disposed) return;
if (isUpgradeComplete(current.registrationStatus)) { succeed(); return; }
// Уже платный аккаунт не должен повторно попадать в мастер покупки.
if (isUpgradeComplete(current.registrationStatus)) { navigate('settings-view'); return; }
if (current.registrationStatus !== 'FREE_CERT') throw new Error('Переход доступен только для бесплатного аккаунта');
// Проверяем наличие PDA до любых новых платежей. Это также позволяет возобновить проверку после перезагрузки.
const onChainExists = await hasVerifiedPda(current);
+26 -21
View File
@@ -123,6 +123,7 @@ export function render({navigate, chrome}) {
const palette = PALETTE_PRESETS[getPaletteSettings().preset]?.label || '';
const appearanceHint = `Тема: ${THEME_LABELS[getThemeMode()] || 'авто'}${palette ? ` · цвета «${palette}»` : ''}`;
card.innerHTML = `
<div class="nav-list" id="settings-account-tier" hidden></div>
<div class="nav-list">
${row('settings-appearance', 'Оформление', appearanceHint)}
${row('settings-notifications', 'Уведомления', 'Звук, разрешение, чаты без звука')}
@@ -144,27 +145,31 @@ export function render({navigate, chrome}) {
</div>
`;
// Бесплатному аккаунту показываем переход, после синхронизации — подтверждённый статус.
if (String(state.session?.login || '').includes('@')) {
void getRegistrationStatus(state.session.login).then(info => {
if (isDisposed) return;
const list = card.querySelector('.nav-list');
if (!list || card.querySelector('#settings-solana-upgrade') || card.querySelector('#settings-solana-registered')) return;
if (info.registrationStatus === 'FREE_CERT') {
const button = document.createElement('button');
button.id = 'settings-solana-upgrade';
button.className = 'nav-row';
button.textContent = 'Закрепить аккаунт в Solana';
button.addEventListener('click', () => navigate('registration-upgrade-view'));
list.append(button);
} else if (info.registrationStatus === 'PAID_UPGRADED' || info.registrationStatus === 'PAID_DIRECT') {
const label = document.createElement('div');
label.id = 'settings-solana-registered';
label.className = 'nav-row nav-row--static';
label.textContent = '✓ Аккаунт зарегистрирован в Solana';
list.append(label);
}
}).catch(() => {});
// Плашка показывается только FREE_CERT; у всех пользователей с PDA Solana её нет.
const accountTier = card.querySelector('#settings-account-tier');
const currentLogin = String(state.session?.login || '');
if (currentLogin.includes('@')) {
void getRegistrationStatus(currentLogin).then(info => {
// Не отображаем устаревший ответ после смены аккаунта или размонтирования экрана.
if (isDisposed || String(state.session?.login || '') !== currentLogin) return;
if (info.registrationStatus !== 'FREE_CERT') return;
const button = document.createElement('button');
button.id = 'settings-solana-upgrade';
button.type = 'button';
button.className = 'nav-row';
const title = document.createElement('span');
title.className = 'nav-row__label';
title.textContent = '⚠ Бесплатный аккаунт с ограниченными возможностями';
const hint = document.createElement('span');
hint.className = 'nav-row__hint';
hint.textContent = 'Ваша регистрация зависит от сервера. Перейти на полноценный аккаунт Solana →';
button.append(title, hint);
button.addEventListener('click', () => navigate('registration-upgrade-view'));
accountTier.replaceChildren(button);
accountTier.hidden = false;
}).catch(() => {
// Если статус неизвестен, нельзя ошибочно предлагать новую оплату.
});
}
card.querySelector('#settings-appearance').addEventListener('click', () => navigate('appearance-view'));
card.querySelector('#settings-notifications').addEventListener('click', () => navigate('notification-settings-view'));
@@ -1,4 +1,4 @@
/** Расчёт минимального пополнения для перехода FREE_CERT → PAID_UPGRADED. */
/** Расчёт минимального пополнения для перехода FREE_CERT → PAID. */
export const USER_PDA_SPACE = 768; // shine-solana/shine/programs/shine_users/src/settings.rs
export const UPGRADE_NETWORK_RESERVE_LAMPORTS = 100_000; // запас на подписи/комиссию сети
export const UPGRADE_TEST_TOPUP_SOL = 0.02;
@@ -15,7 +15,8 @@ export function calculateUpgradeFunding({ namespaceFeeLamports, rentLamports })
}
export function isUpgradeComplete(status) {
return status === 'PAID_UPGRADED';
// Старые серверы могут временно вернуть старые значения при последовательном развёртывании.
return status === 'PAID' || status === 'PAID_DIRECT' || status === 'PAID_UPGRADED';
}
export function solFromLamports(lamports) {
@@ -18,10 +18,30 @@ test('платный переход оплачивает namespace + депоз
assert.ok(result.recommendedLamports > result.requiredLamports);
assert.throws(() => calculateUpgradeFunding({ namespaceFeeLamports: -1, rentLamports: 0 }));
});
test('успех только после синхронизации PAID_UPGRADED', () => {
assert.equal(isUpgradeComplete('PAID_UPGRADED'), true);
test('после синхронизации Solana оба типа платных аккаунтов имеют статус PAID', () => {
assert.equal(isUpgradeComplete('PAID'), true);
assert.equal(isUpgradeComplete('FREE_CERT'), false);
assert.equal(isUpgradeComplete('PAID_DIRECT'), false);
assert.equal(isUpgradeComplete('NOT_FOUND'), false);
// Совместимость с предыдущим сервером при поэтапном обновлении.
assert.equal(isUpgradeComplete('PAID_UPGRADED'), true);
assert.equal(isUpgradeComplete('PAID_DIRECT'), true);
});
test('в настройках только бесплатным предлагается платный переход', () => {
const settings = read('shine-UI/js/pages/settings-view.js');
assert.match(settings, /info.registrationStatus !== 'FREE_CERT'/);
assert.match(settings, /id="settings-account-tier" hidden/);
assert.match(settings, /Бесплатный аккаунт с ограниченными возможностями/);
assert.doesNotMatch(settings, /settings-solana-registered/);
});
test('миграция БД делает статусы действительно едиными', () => {
const migration = read('SHiNE-server/shine-server-db/src/main/resources/postgres/migration_v35.sql');
assert.match(migration, /WHERE registration_status IN \('PAID_DIRECT', 'PAID_UPGRADED'\)/);
assert.match(migration, /CHECK \(registration_status IN \('FREE_CERT', 'PAID'\)\)/);
assert.match(migration, /'SOLANA', 'PAID',/);
assert.match(migration, /free_data_item_id=EXCLUDED|old_user.free_data_item_id/);
assert.doesNotMatch(migration, /DELETE FROM user_identity_current/);
const dbInit = read('SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java');
assert.match(dbInit, /POSTGRES_MIGRATION_V35_RESOURCE/);
});
test('роут settings/solana-upgrade действительно обслуживается', () => {
const router = read('shine-UI/js/router.js');