Files
SHiNE-server/docs/registration-v2/SOURCE_BASELINE.md
T

12 KiB
Raw Blame History

SHiNE Registration V2 — аудит исходников, этап 0

Дата аудита: 2026-10-23. Статус: инвентаризация выполнена; интеграционные сборки Rust/Gradle/PostgreSQL не подтверждены (ограничения окружения).

Исходник и правила

  • Фактический исходник: SHiNE-bundle-2026.10.23-12.36.02.zip, SHA-256: e2871bb11610437c354507dc9a723d64f14b0be4161af5f82d19f1466af648a6.
  • Мастер-план V2 от 23.10.2026 ссылается на архив от 22.10.2026. Здесь взята более свежая прикреплённая версия 23.10.2026. Все ссылки на файлы проверены относительно этого архива; при переходе к другому commit провести повторный diff/аудит.
  • Архив не содержит .git/: исходная ветка, коммит и чистота git-дерева неизвестны. В данном пакете не создан git-коммит, не выполнен push, не объявлена связь с remote-веткой. Для работы в настоящем репозитории нужна отдельная ветка, например feature/registration-v2, от реального текущего commit.
  • Прочитаны обязательные правила: корневой AGENTS.md, COMMIT_AND_VERSION_RULES.md, deploy/AGENTS.md, deploy/TEST_SERVERS.md, shine-solana/shine/AGENTS.md, SHiNE-server/AGENTS.md, shine-UI/AGENTS.md. Дополнительные AGENTS.md в unrelated ESP32/DM/test-publisher/backup не относятся к редактируемым в этапе 0 областям.
  • Код регистрации и действующий API/форматы/миграции не изменены. Production, testnet, секреты и реальные базы не тронуты. VERSION.properties не изменялся, поскольку не было изменений клиентского/серверного кода или git-коммита.

Локальные инструменты и честный baseline

Компонент Фактически обнаружено Результат
ОС/runtime Linux, Java 21.0.12.1 Java runtime есть; Gradle java.toolchain просит Java 17
Node.js v22.16.0, npm 10.9.2 node --test shine-UI/tests/*.test.* — 18 passed / 0 failed
UI parse check node --check на register-view.js, solana-register-service.js, shine-user-pda-service.js 3/3 успешны
Java isolated javac --release 17 -d /tmp/shine_stage0_javac SHiNE-server/shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java успешно, лишь изолированный Java-файл, НЕ сборка сервера
Gradle wrapper ./gradlew --version BLOCKED: попытка загрузить Gradle 8.14 с services.gradle.org, UnknownHostException; Gradle не собран
Solana/Rust rustc, cargo, anchor, solana отсутствуют NOT RUN: Solana build/test невозможен в данном окружении
PostgreSQL psql/Docker не обнаружены NOT RUN: SQL migration/integration тесты не выполнены
Git /usr/bin/git имеется, внутри архива нет .git реальные branch/commit неизвестны

Команды для полноценной перепроверки в подготовленной среде:

# Из корня отдельной рабочей ветки репозитория
./gradlew assemble
# Обратите внимание: в корневом build.gradle задача test отключена:
# tasks.named('test') { enabled = false }
# Поэтому ./gradlew test сам по себе не доказывает прохождение тестов сервера.
node --test shine-UI/tests/*.test.*
node --check shine-UI/js/pages/register-view.js
node --check shine-UI/js/services/solana-register-service.js
node --check shine-UI/js/services/shine-user-pda-service.js
cd shine-solana/shine
cargo test -p shine_users
# Специальные Anchor/local validator тесты — по AGENTS.md и тестовым конфигурациям;
# перед запуском убедиться, что тесты не используют реальные кошельки/production.

Для Java/SQL настоящих интеграционных тестов нужен безопасный локальный или выделенный тестовый PostgreSQL и подготовленная JDK17/Gradle инфраструктура. Не запускать деплой в production автоматически.

Прямые точки изменений

Подсистема Файлы / исходное состояние Этапы
Solana PDA shine-solana/shine/programs/shine_users/src/lib.rs, settings.rs: find_user_pda строит 2 отдельных seed (user_login= и login), не SHA256 всей строки; program IX 1–6 1–3
Экономика/guard В shine_users есть DAO_AUTHORITY, registration_fee_lamports, promo_seller и CPI к shine_login_guard; сменить только новый registration flow согласно плану 2–3
Пользовательская запись shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md — не изменять формат существующей PDA без необходимости 1–3
UI PDA/transaction shine-UI/js/services/shine-user-pda-service.js, solana-register-service.js, solana-programs.js — старые seed, promo и guard 4, 11–12
UI форма shine-UI/js/pages/register-view.js: временная нормализация удаляет _, отсекает >20 символов, MIN_REGISTRATION_LOGIN_LENGTH=8; менять одновременно с полным логином и namespace 11
UI KDF shine-UI/js/services/auth-service.js: derivePasswordKeyBundle(login,password); после новой регистрации ключи выводить из полного login@namespace без изменения KDF 4, 11–12
Solana sync SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SolanaUsersSyncService.java, sync/codec/ShineUsersCodec.java, sync/util/SolanaPdaUtil.java, sync/source/rpc/SolanaRpcClient.java, sync/storage/postgres/PostgresStorageRepository.java 6
База SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql; миграции через migration_v32.sql; SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java разрешает текущую версию 32 5–6
SQL единый пользователь SHiNE-server/shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java: usersSubquery строит список только из solana_user_pda_current 5, 10
Server auth .../handlers/auth/Net_ResolveLoginForAuth_Handler.java, Net_CreateAuthSession__Handler.java, Net_SessionLogin_Handler.java, SolanaUserPdaImportService.java (проверка сессий ходит в real Solana PDA) 10
Сервер доступа CurrentUsersDAO.java, SolanaUserPdaCurrentDAO.java, UserAccessServersCurrentDAO.java, AuthAccessScopeSupport.java и SQL-функции refresh 5, 10
Key rotation .../handlers/keyRotation/Net_KeyRotationStart_Handler.java, KeyRotationSessionsDAO.java, операции обновления PDA 10
Сертификат SHiNE-server/shine-server-blockchain/src/main/java/blockchain/Ans104DataItem.java; SHiNE-server/shine-server-archive/src/main/java/server/archive/TurboDataItemUploader.java принимает подписанный DataItem, сам не подписывает 7
Arweave .../server/archive/ArweaveBlockSyncService.java: обычный импорт зависит от block.height; требуется отдельный тип сертификата + локальный импорт по Turbo ACK 8
WS .../JSON/JsonHandlerRegistry.java, docs/API/01_User_Registration_API.md, docs/API/09_Operations_Index.md 9

Ключевые найденные несовместимости с будущим V2

  1. Старый пользовательский PDA seed: lib.rs использует [b'user_login=', login.as_bytes()]; новый план использует один сырой 32-байтовый SHA256 seed полного логина. Существующие legacy PDA автоматически не мигрируют.
  2. Старый UI: register-view.js удаляет _, хотя a_b и ab должны быть разными пользователями. В Solana нормализация тоже ограничивает длину 20 (lib.rs); нельзя менять лишь одну сторону.
  3. Точка поиска Solana PDA в авторизации: SolanaUserPdaImportService.fetchRawUserPda через getProgramAccounts/memcmp по offsets 61 и 62. Для нового типа аккаунтов потребуется корректное различение namespace и user PDA и прямые PDA-адреса, а для FREE_CERT — отдельный проверенный путь.
  4. Системная SQL-зависимость: реестр логинов, связи, блоки, статистика, сессии, маршруты и уведомления имеют FK к solana_user_pda_current. Простая таблица «free_users» без переноса зависимостей неработоспособна: подробнее в SQL_DEPENDENCIES.md.
  5. Маршрутизация: shine_refresh_user_access_servers_for_user (migration_v16.sql) читает solana_user_pda_current и его access_servers_json и ищет сервер только среди on-chain пользователей; для free должен быть server из namespace-PDA без фальшивого on-chain user PDA.
  6. DB миграции: DatabaseInitializer обработал переходы 30→31→32 и требует итоговую 32. Для v33 нужно и отдельную миграцию, и обновление инициализатора, и сценарий как для чистой БД, так и для 32→33. Старые миграции не переписывать.
  7. Лимиты и история: у бесплатного аккаунта до upgrade мог существовать контент и расход лимитов. Не сбрасывать при создании on-chain PDA; отдельно тестировать старую дату создания blockchain и новую дату Solana PDA.
  8. Необходимы согласования: изменение публичных WS операций и формата существующего пользовательского блокчейна подпадает под AGENTS.md. Этап 0 не меняет ни того ни другого. Протокол нового отдельного сертификата разрабатывается на этапе 1 без маскировки под обычный блок.

Очерёдность (основной мастер-план V2)

0 аудит → 1 протоколы → 2 namespace Solana → 3 create/upgrade Solana → 4 JS-кодеки → 5 identity DB → 6 Solana sync → 7 signer → 8 Arweave importer → 9 WS API → 10 auth → 11 UI registration → 12 UI upgrade → 13 E2E / тестовый релиз.

Состояние на конец этапа 0: точные файлы и SQL-зависимости найдены, UI smoke прошёл, Java isolate compile прошёл; полный baseline Java/SQL/Solana заблокирован отсутствием дистрибутивов/toolchain и БД. Следующий исполнитель должен повторить заблокированные проверки в dev-среде, прежде чем маркировать этап 0 полностью завершённым.