Добавить периодический sync блокчейнов каждые 12 часов

Dev_Docs/API/04_Add_Block_to_Blockchain_API.md

@@ -1,6 +1,11 @@
-# API для разработчиков: 04 — Добавление блока в блокчейн (AddBlock)
+# API для разработчиков: 04 — Запись и чтение блока блокчейна
 
-Документ описывает **текущий рабочий формат** сетевого вызова `AddBlock`, который используется для записи **любого** блока в блокчейн пользователя.
+Документ описывает **текущий рабочий формат** сетевых вызовов:
+
+- `AddBlock` — запись любого блока в блокчейн пользователя;
+- `GetBlockchainBlock` — публичное чтение одного конкретного блока по имени цепочки и номеру.
+
+`GetBlockchainBlock` нужен в том числе для межсерверной синхронизации и для открытого чтения публичного блокчейна по одному блоку.
 
 > Важный принцип: на уровне JSON API сейчас есть **один универсальный метод** записи — `AddBlock`.
 > Конкретный смысл записи задаётся типом самого бинарного блока (`type/subType/version` в заголовке блока).
@@ -174,3 +179,60 @@
 - сейчас нет серверной ACL-политики чтения параметров (в MVP их может читать любой клиент, который знает `login`);
 - нет валидации формата значений для конкретных ключей (телефон, URL и т.д. проверяются только на стороне клиента);
 - нет отдельного индекса/поиска по этим полям — только точечное чтение и listing по `login`.
+
+---
+
+## 9. `GetBlockchainBlock`
+
+### Назначение
+
+Публичное чтение одного конкретного блока из цепочки.
+
+Нужно для:
+
+- открытого чтения блокчейна по одному блоку;
+- межсерверной синхронизации;
+- восстановления/докачки отсутствующего хвоста цепочки.
+
+### JSON формат запроса
+
+`op = "GetBlockchainBlock"`.
+
+```json
+{
+  "op": "GetBlockchainBlock",
+  "requestId": "req-2001",
+  "payload": {
+    "blockchainName": "alice-001",
+    "blockNumber": 12
+  }
+}
+```
+
+Поля `payload`:
+
+- `blockchainName` — обязательно, формат `login-NNN`.
+- `blockNumber` — обязательно, номер блока в цепочке, `>= 0`.
+
+### Успешный ответ
+
+```json
+{
+  "op": "GetBlockchainBlock",
+  "requestId": "req-2001",
+  "status": 200,
+  "ok": true,
+  "payload": {
+    "blockchainName": "alice-001",
+    "blockNumber": 12,
+    "blockHash": "9f0eaabbccddeeff00112233445566778899aabbccddeeff0011223344556677",
+    "blockBytesB64": "AAAB..."
+  }
+}
+```
+
+### Ошибки
+
+- `400 / BAD_FIELDS` — некорректные `blockchainName` или `blockNumber`.
+- `404 / BLOCK_NOT_FOUND` — такого блока нет.
+- `500 / INTERNAL_ERROR` — внутренняя ошибка сервера.

Dev_Docs/API/09_Operations_Index.md

@@ -32,6 +32,7 @@
 | `ListSessions` | `03_Session_Management_API.md` | список активных сессий |
 | `CloseActiveSession` | `03_Session_Management_API.md` | закрытие активной сессии |
 | `AddBlock` | `04_Add_Block_to_Blockchain_API.md` | добавление блока в блокчейн |
+| `GetBlockchainBlock` | `04_Add_Block_to_Blockchain_API.md` | чтение одного блока блокчейна |
 | `Ping` | `05_Technical_Requests_API.md` | keep-alive |
 | `GetServerInfo` | `05_Technical_Requests_API.md` | публичная информация о сервере |
 | `ListBlockchainHeads` | `05_Technical_Requests_API.md` | список heads всех локальных блокчейнов |

Dev_Docs/Pending_Features/2026-06-25_1200_periodic_blockchain_sync.md

@@ -0,0 +1,23 @@
+# Периодическая межсерверная синхронизация блокчейнов
+
+- Краткое описание:
+  - Добавлен публичный `GetBlockchainBlock` для чтения одного блока.
+  - Добавлен плановый sync блокчейнов при старте сервера и затем каждые `12` часов.
+  - Синхронизация пока умеет только докачивать отсутствующий хвост цепочки.
+  - Случай рассинхрона цепочек пока не исправляется автоматически: он только логируется как не реализованный сценарий.
+
+- Что именно проверять:
+  - После старта сервера в логах появляется запуск периодического sync.
+  - Сервер может запросить у партнёра `ListBlockchainHeads`.
+  - Сервер может запросить у партнёра `GetBlockchainBlock` и локально применить блок через существующий `AddBlock`.
+  - На чистом тестовом сервере после удаления БД и файлов блокчейнов сервер сам подтягивает блоки при старте.
+  - После первичного старта новые блоки продолжают догоняться без ручного вмешательства.
+  - При рассинхроне цепочек в логах появляется явное сообщение, что reconciliation пока не реализован.
+
+- Ожидаемый результат:
+  - Чистый сервер после старта сам восстанавливает локальные цепочки от партнёра синхронизации.
+  - Периодический sync не мешает обычной работе сервера и не ломает локальный `AddBlock`.
+  - Нереализованный случай рассинхрона не приводит к падению сервера и явно отражается в логах.
+
+- Статус:
+  - `pending`