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

8.5 KiB
Raw Blame History

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):

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;