docs: explain persisted T-Bank reads and synchronization

Document local data ownership, coverage and freshness, refresh behavior, failure
recovery and additive migration rollback. Record ADR 017.

architecture/http-api.md

@@ -20,6 +20,30 @@ artifact у себя и проверяет соответствие generated ty
 API имеет prefix `/api/v1`; Swagger публикуется для локальной разработки по
 environment policy, а не используется frontend в runtime.
 
+## Инвестиционные данные и синхронизация
+
+T-Bank data GET возвращают envelope `{ data, meta }`. `data` может быть `null`
+при missing или неполном финансовом агрегате; partial ledger/candles могут
+содержать подтверждённые строки. `meta` разделяет availability, freshness,
+lastSuccessfulAt, sync, coverage и состояния зависимостей. `dataRevision`
+описывает набор данных, `stateVersion` — наблюдаемое состояние, включая
+пустое завершённое покрытие. Ни одно поле не раскрывает connection revision.
+
+Обычный GET планирует missing/stale зависимости после проверки доступа.
+GET с `sync=observe` только читает. `POST /api/v1/tbank-sync` принимает
+валидированный screen descriptor и возвращает `202` с handle и нормализованным
+scope. `GET /api/v1/tbank-sync/:id` наблюдает разрешённую работу; чужой или
+прежний handle возвращает `404`. Приём работы не означает её успех.
+
+Source failure принятой работы передаётся безопасным `meta.sync.errorCode`;
+HTTP transport/access/input errors сохраняют Problem Details. Старые данные
+при transient failure сохраняют исходное успешное время. Детали поведения —
+[свежесть и полнота](cross-cutting/data-freshness.md).
+
+Envelope несовместим с прежними bare-array ответами: backend/frontend
+поставляются согласованной парой. Финальный artifact передаётся явно;
+локальная генерация и CI frontend читают только собственный snapshot.
+
 ## Validation и identity
 
 Backend преобразует и проверяет входные данные на общей HTTP-границе.