Сервер: дочистить legacy-слои и доки

2026-07-27 19:29:10 +04:00
parent 0db3c3af5a
commit 6ed91a105e
33 changed files with 127 additions and 165 deletions
@@ -2,13 +2,12 @@

 Этот файл описывает раздел API, связанный с проверкой наличия пользователя на сервере и dev/test операциями.

-Сейчас здесь три метода:
+Сейчас здесь два метода:

- `AddUser` — операция отключена (регистрация только через Solana);
 - `GetUser` — временная серверная проверка существования пользователя и чтение его базовых данных;
 - `SearchUsers` — dev/test поиск логинов по префиксу.

-Регистрация выполняется через Solana (`shine_users`). Сервер при входе может лениво импортировать пользователя из Solana PDA в локальную БД, если записи ещё нет.
+Регистрация выполняется только через Solana. Старый серверный `AddUser` оставлен лишь как legacy-ответ `410 / ADD_USER_DISABLED` для старых клиентов и больше не считается частью актуального flow.

 ## Статус документа

@@ -18,11 +17,11 @@

 ---

-## 1. Операция `AddUser`
+## Legacy-операция `AddUser`

 ### Назначение

-Операция отключена. Используется только как явный ответ клиентам старых версий.
+Операция удалена из текущего клиентского flow. Сервер сохраняет только совместимый ответ для клиентов старых версий.

 ### Запрос

@@ -62,7 +61,7 @@

 ---

-## 2. Операция `GetUser`
+## 1. Операция `GetUser`

 ### Назначение

@@ -153,7 +152,7 @@

 ---

-## 3. Операция `SearchUsers`
+## 2. Операция `SearchUsers`

 ### Назначение

@@ -195,7 +194,6 @@

 ## 4. Короткое резюме

- `AddUser` — отключен (`410 / ADD_USER_DISABLED`).
 - `GetUser` — проверка существования пользователя на сервере.
 - `SearchUsers` — временный поиск пользователей по префиксу.
 - Регистрация выполняется только через Solana.
@@ -138,7 +138,7 @@ AUTH_CREATE_SESSION:{login}:{sessionKey}:{storagePwd}:{timeMs}:{authNonce}

 Перед проверкой подписи сервер должен:

-1. взять актуальный `solana_users.client_key`;
+1. взять актуальный `solana_user_pda_current.client_key`;
 2. сравнить его с `payload.clientKey`;
 3. только потом проверять подпись.

@@ -19,7 +19,7 @@
 - `Ping` нужен для регулярной проверки, что соединение всё ещё живо;
 - `GetServerInfo` нужен до авторизации и до работы с данными, чтобы клиент понял, что сервер доступен, и показал пользователю краткую карточку этого узла.
 - `ListBlockchainHeads` нужен для сервер-сервер сверки: партнёр получает список heads по всем цепочкам, сравнивает его со своим состоянием и затем добирает недостающие блоки по диапазону.
- `GetSyncUserProfile` нужен для server-to-server режима, когда принимающий сервер хочет создать у себя локальные `solana_users + blockchain_state` без прямого обращения в Solana. Это используется как временный обход ограничений внешнего Solana RPC.
+- `GetSyncUserProfile` нужен для server-to-server режима, когда принимающий сервер хочет создать у себя локальную runtime-проекцию пользователя и `blockchain_state` без прямого обращения в Solana.
 - `SendSignal` нужен для доверенных межсессионных команд одного пользователя. Первое практическое применение — `remote AddBlock via homeserver session`, но формат задуман как общий transport на вырост.

 Ниже сначала описаны назначение методов, затем точные форматы запросов и ответов.
@@ -216,7 +216,7 @@
 - `clientKey`
 - `blockchainSizeLimitBytes`

-После этого принимающий сервер может локально создать записи в `solana_users` и `blockchain_state`, а затем уже докачивать блоки через `GetBlockchainBlock`.
+После этого принимающий сервер может локально создать runtime-проекцию пользователя и запись в `blockchain_state`, а затем уже докачивать блоки через `GetBlockchainBlock`.

 Этот запрос доступен без авторизации и предназначен именно для server-to-server sync.

@@ -12,7 +12,6 @@

 | Операция | Раздел документации | Кратко |
 | --- | --- | --- |
-| `AddUser` | `01_User_Registration_API.md` | отключено (`410 / ADD_USER_DISABLED`) |
 | `GetUser` | `01_User_Registration_API.md` | чтение/проверка пользователя + server-состояние его блокчейна |
 | `SearchUsers` | `01_User_Registration_API.md` | поиск логинов по префиксу |
 | `TestGetFreeAvatarQuota` | `14_Test_Free_Avatar_Upload_API.md` | временный тестовый просмотр остатка бесплатных загрузок аватара |