# SHiNE Registration V2 — связи с `solana_user_pda_current` (этап 0) **Источник:** `SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql`, текущие SQL-миграции до `migration_v32.sql`; Java исходники архива 23.10.2026. Это **статический** аудит исходников, а не `pg_catalog` реальной БД. Перед этапом 5 обязательно проверить живую тестовую БД через `pg_constraint`/`pg_trigger`/`pg_views`, поскольку baseline + миграции содержат переопределения. ## Foreign keys, объявленные в текущем `schema_v1.sql` | Таблица-зависимость | Ключ таблицы пользователя | Исходная строка `schema_v1.sql` | |---|---|---:| | `user_access_servers_current` (два FK: пользователь и сервер) | `login` | 150–151 | | `active_sessions` | `login` | 369 | | `esp_pairing_settings` | `login` | 389 | | `esp_pairing_requests` | `login` | 401 | | `users_params` | `login` | 422 | | `user_settings` | `login` | 435 | | `channel_read_state` | `login` | 453 | | `test_free_avatar_uploads` | `login` | 482 | | `blockchain_state` | `login` | 502 | | `blocks` | `normalized_login` | 518 | | `connections_state` | `normalized_login` | 590 | | `user_stats_state` | `login` | 684 | | `user_push_tokens` | `login` | 745 | | `user_notifications_state` | `normalized_login` | 856 | | `key_rotation_sessions` | `login` | 2158 | В текущем `schema_v1.sql` явно перечислено **16 FK** в **15 таблицах** на `solana_user_pda_current` (из них один двойной для `user_access_servers_current`). Проверить финальное состояние ограничений в PostgreSQL: в некоторых старых миграциях (`migration_v7`, `migration_v8`) FK накладывались через `ALTER TABLE`, а в `schema_v1.sql` уже представлены встроенными. Не применять миграции вслепую поверх готового baseline. Дополнительные места объявления/изменения FK в `migration_v2`, `v7`, `v8`, `v9`, `v10`, `v14`, `v21`, `v26`: оригиналы нужны для трассировки истории схемы и корректной миграции существующих БД; не считать эти объявления отдельными дополнительными активными FK без `pg_catalog`. ## Функции и триггеры с зависимостью от таблицы - `shine_refresh_user_access_servers_for_user`: финальная версия в `migration_v16.sql` (строка 4). Удаляет маршруты и пересчитывает их через `solana_user_pda_current u`, `access_servers_json` и lookup server `s` из той же таблицы. - `shine_refresh_user_access_servers_for_server`: версия `migration_v16.sql` (строка 64); перечисляет затронутых пользователей в таблице Solana. - `shine_refresh_user_access_servers_all`: исходная функция `schema_v1.sql` (строка 262) / `migration_v2.sql` (строка 116): массовое обновление маршрутов на основании Solana списка. - `trg_refresh_user_access_servers_row` и `trg_refresh_user_access_servers_truncate`: подключены к `solana_user_pda_current` в `schema_v1.sql` (строки 313, 319) и `migration_v2.sql` (строки 167, 173), в частности реагируют на обновление/очистку on-chain snapshot. - `shine_resolve_login`: `schema_v1.sql`, строка 965, выполняет lookup в `solana_user_pda_current` (строка 979). - `shine_refresh_user_stats`: оригинал `schema_v1.sql`, а переопределение в `migration_v19.sql` (строка 6) проверяет наличие логина в `solana_user_pda_current` (строка 16). Функция повторно менялась в `migration_v31.sql`; перед этапом 5 получить конечное определение из реально инициализированной БД. - `shine_channel_names_state_stats_ai`: определение `migration_v15.sql` (строка 3) читает `solana_user_pda_current` для логики канала; оценить влияние на free. - `migration_v5.sql` содержит JOIN на `solana_user_pda_current` для connections. Проверить актуальность этого legacy-прохода на текущем schema baseline. - `schema_v1.sql` объявляет `CREATE VIEW blockchain_state` и `CREATE VIEW blocks` около строк 2277–2279. Это **исторические/переопределяемые объявления**, не доказательство текущих зависимостей view от Solana. Проверить финальный `pg_views`/`pg_rewrite` до миграции. ## Вызовы из Java — единая идентичность / Solana-only допущения - `shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java::usersSubquery()` — источник логинов **только** `solana_user_pda_current`. - Его потребители: `CurrentUsersDAO`, `ConnectionsStateDAO`, `Net_AddCloseFriend_Handler`, `Net_GetUserConnectionsGraph_Handler`, `Net_GetFriendsLists_Handler`, `ChannelsReadSupport`. - Прямая зависимость от `SolanaUserPdaCurrentDAO`: `Net_GetMyBlockchain_Handler`, обработчики сессий и ротации через `SolanaUserPdaImportService`, `KeyRotationSessionsDAO`. - `SolanaUserPdaImportService.fetchRawUserPda` делает `getProgramAccounts`/memcmp и предполагает user PDA; это **не** способ признавать free identity. - `AuthAccessScopeSupport` опирается на `UserAccessServersCurrentDAO` и на маршруты, созданные из Solana PDA. - `SolanaUsersSyncService` + `PostgresStorageRepository` создают/перезаписывают snapshots; не допустить, чтобы sync очищал доверенные free-сертификаты или создавал дубль при Solana upgrade. - `ArweaveBlockSyncService` читает `solana_user_pda_current` и blockchain-данные: восстановление free должно оставаться независимым от факта существования реального Solana PDA. ## Решение для этапа 5 — пока НЕ принято Требование мастер-плана: одна логическая личность для `FREE_CERT` и `PAID_UPGRADED`; при free **нет on-chain PDA**, но сохраняются FK/индексы/функциональность сообщений, каналов, связей и сессий. Не вставлять фиктивный Solana snapshot со slot/signature только ради удовлетворения FK. Выбрать единый identity-index после проверки реальной схемы и протестировать: 1. создание free до появления в Solana, работа всех 15 зависимых таблиц; 2. транзакционный upgrade без перегенерации root/blockchain/client и без переименования логина; 3. re-sync snapshot Solana и повторный импорт сертификата, отсутствие потерянных FK/двойников; 4. безошибочный sync/route, если namespace server зарегистрирован в Solana, а сам free-user — нет; 5. rollback сценарий **только** для изолированной тестовой БД до появления новых данных. Проверки каталога PostgreSQL на этапе 5 (проверить в тестовой копии, не в production): ```sql SELECT conrelid::regclass AS dependent_table, conname, confrelid::regclass AS referenced_table, pg_get_constraintdef(oid) AS definition FROM pg_constraint WHERE contype='f' AND confrelid='solana_user_pda_current'::regclass ORDER BY 1,2; SELECT tgrelid::regclass AS table_name, tgname, pg_get_triggerdef(oid) AS definition FROM pg_trigger WHERE NOT tgisinternal AND tgrelid='solana_user_pda_current'::regclass ORDER BY 1,2; ```