8.5 KiB
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 serversиз той же таблицы.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 после проверки реальной схемы и протестировать:
- создание free до появления в Solana, работа всех 15 зависимых таблиц;
- транзакционный upgrade без перегенерации root/blockchain/client и без переименования логина;
- re-sync snapshot Solana и повторный импорт сертификата, отсутствие потерянных FK/двойников;
- безошибочный sync/route, если namespace server зарегистрирован в Solana, а сам free-user — нет;
- rollback сценарий только для изолированной тестовой БД до появления новых данных.
Проверки каталога PostgreSQL на этапе 5 (проверить в тестовой копии, не в production):
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;