Добавить импорт архивов с доверенных серверов

docs/Archive/03_DEPLOY_TEST_SERVER.md

@@ -7,7 +7,7 @@
 Нужны изменения одновременно в:
 
 1. серверном Java-коде;
-2. PostgreSQL schema v22;
+2. PostgreSQL schema v23;
 3. Solana-программе `shine_users` (PDA block type `100` + backward-compatible update parser);
 4. Java/JS User PDA codecs.
 
@@ -107,7 +107,7 @@ SHiNE-server/build/libs/shine-server.jar
 
 # 4. Подготовить PostgreSQL backup
 
-Перед первым стартом версии со schema v22 сделать backup тестовой БД. Например:
+Перед первым стартом версии со schema v23 сделать backup тестовой БД. Например:
 
 ```bash
 pg_dump -Fc -d '<DATABASE_URL_OR_NAME>' -f shine-before-archive-v22.dump
@@ -115,7 +115,7 @@ pg_dump -Fc -d '<DATABASE_URL_OR_NAME>' -f shine-before-archive-v22.dump
 
 Точная команда зависит от текущей схемы доступа PostgreSQL.
 
-При старте сервер сам применит `migration_v22.sql`, если `db_schema_version < 22`. Вручную migration выполнять обычно не нужно.
+При старте сервер последовательно применит `migration_v22.sql` и `migration_v23.sql`, если это требуется текущей версии БД. Вручную migrations выполнять обычно не нужно.
 
 После старта проверить:
 
@@ -126,7 +126,7 @@ SELECT * FROM db_schema_version WHERE id=1;
 Ожидается:
 
 ```text
-schema_version = 22
+schema_version = 23
 ```
 
 И наличие:
@@ -413,3 +413,54 @@ archive.publish.enabled=false
 
 ### Старый `shine_users`
 Если новый update payload отклоняется программой, проверить, что целевая Solana `shine_users` действительно обновлена этой версией.
+
+
+## Trusted archive importer
+
+На обычном тестовом сервере publisher можно оставить выключенным, но разрешить импорт от конкретного архиватора:
+
+```properties
+archive.publish.enabled=false
+archive.import.allowedPublishers=<LOGIN_ARCHIVE_SERVER>
+archive.import.intervalMinutes=60
+archive.import.workDir=data/archive-import
+```
+
+Несколько логинов:
+
+```properties
+archive.import.allowedPublishers=server-a,server-b
+```
+
+Пустая строка означает, что importer не запускается.
+
+После старта проверить логи:
+
+```text
+Archive importer включён. approvedPublishers=...
+```
+
+Если сервер подключается к publisher впервые, importer скачает head, прочитает FULL reference table и обработает все ещё не известные big blocks от старых к новым.
+
+Проверка БД:
+
+```sql
+SELECT login, archive_head_tx_id, archive_imported, archive_last_imported_tx_id
+FROM solana_user_pda_current
+WHERE is_server=TRUE AND archive_head_tx_id<>''
+ORDER BY login;
+
+SELECT blockchain_name, publisher_login, arweave_tx_id,
+       big_block_number, chunk_offset, chunk_size, source_last_block_number
+FROM archive_blockchain_location
+ORDER BY updated_at_ms DESC
+LIMIT 20;
+```
+
+После деплоя UI файл должен быть доступен по:
+
+```text
+https://<UI_HOST>/Blockchain-Viewer.html
+```
+
+В приложении: `Настройки → Архив блокчейна`.