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

77 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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;
```