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

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
+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 и реальное
интеграционное тестирование миграции, синхронизации и повторного входа.