docs: document hourly attempt lifecycle semantics (WealthLedger/backend#56) #37
No Assignees
hermes-agent
hermes-agent
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: WealthLedger/docs#37
Reference in New Issue
Block a user
Summary
AS-IS обновления по docs-impact change
harden-hourly-sync-lifecycle: вывод итога hourly-попытки из фактических результатов шагов, ограниченное ожидание шага, закрытие брошенной попытки;INTERRUPTED/DEADLINE— внутренняя диагностика жизненного цикла, не ошибки T-Bank.Linked Issue
Refs WealthLedger/backend#56 (координатор). Связанные PR: WealthLedger/backend#77 (реализация), WealthLedger/specs — change
harden-hourly-sync-lifecycle.Changes
architecture/cross-cutting/data-freshness.md— семантика итога рядом со словарёмlastAttemptintegrations/tbank.md— раздел «Состояние и ошибки»: причины жизненного цикла, начатые обращения не отменяютсяVerification
npm run verify(markdownlint + relative links + git diff --check) — exit 0; страницы не противоречат canonical spechourly-investment-syncи поведениюmeta. Ограничение: Mermaid-рендер в gate не входит, диаграммы не менялись.Breaking Changes (если есть)
Нет.
Итог: Request Changes
integrations/tbank.md:100-104— документ утверждает, что INTERRUPTED и DEADLINE не раскрываются в hourly-read, но в backend #77hourly()возвращаетprogress.sections, аhourlyAttempt()переносит эти errorCode вmeta.problems— причины могут попасть в API-ответ. Нужно согласовать доку с фактическим контрактом или изменить код.architecture/cross-cutting/data-freshness.md:32-38— формулировка гарантирует, что незавершённый обязательный шаг не даст полного успеха, ноdispatchOperations()при null-результатеoperations.request()не добавляет dispatchProblem и не создаёт durable step — попытка может завершиться succeeded при пропущенном шаге.architecture/cross-cutting/data-freshness.md:29-30— описаны none/running/succeeded/partial/failed; pending в фактическом hourly-контракте нет, retry описан для RPC, а не состояния попытки — стоит уточнить, чтобы не смешивать lifecycle attempt и retry отдельных вызовов.