spec: address hourly-sync review findings (WealthLedger/backend#56)

2026-10-12 22:19:03 +03:00
parent 14174a7bb3
commit 77b211186c
3 changed files with 22 additions and 1 deletions
@@ -14,6 +14,9 @@ Durable docs update нужен ограниченно: наблюдаемая с
 | update | `docs/architecture/cross-cutting/data-freshness.md` | cross-cutting | Рядом со словарём `lastAttempt` (`none`, `running`, `succeeded`, `partial`, `failed`): итог попытки выводится из фактических результатов её шагов; попытка, не завершившая обязательный шаг, не обозначается полным успехом; ожидание шага ограничено, зависший шаг учитывается как проблемный; попытка, потерявшая выполнение (сбой сохранения, остановка процесса), закрывается частичным успехом либо неуспехом и не блокирует следующий обход дольше обычного срока | System Analysis — Data and State Semantics, Error and Recovery Semantics; Design 1–5 | Страница не противоречит canonical spec `hourly-investment-sync` и фактическому поведению `meta` |
 | update | `docs/integrations/tbank.md` | integration | В разделе «Состояние и ошибки»: диагностические причины жизненного цикла попытки (`INTERRUPTED` — прервана до нормального завершения, `DEADLINE` — истечение ожидания шага) — внутренняя диагностика, не ошибки T-Bank; в hourly-read наружу не попадают, начатые обращения к T-Bank не отменяются | System Analysis — Observability Semantics; Design 3, 6 | Раздел различает ошибки подключения/external-коды и внутренние причины жизненного цикла |

+PR реализации: WealthLedger/docs#37 (open) — обе страницы обновлены, diff
+соответствует таблице выше (задачи 6.1 и 6.2 верифицируемы по нему).
+
 ## Diagram Promotion

 Не переносить. Sequence-диаграммы (`hourly-attempt-terminal-barrier.mmd`,