ksv741
fe295aa73a
4.1 KiB
Documentation Impact
Summary
Durable docs update нужен ограниченно: наблюдаемая семантика итога часовой попытки уже описана в AS-IS, но правила вывода итога, ограниченного ожидания и восстановления после сбоя сохранения/перезапуска в docs отсутствуют. Переносится только это знание; migration history остаётся в archived change.
Documentation Changes
| Action | Target | Category | Resulting AS-IS | Source | Verification |
|---|---|---|---|---|---|
| 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,
hourly-bounded-wait.mmd, hourly-recovery.mmd) — planning evidence этого
change; AS-IS достаточно текстового описания семантики в data-freshness.md.
ADR Decision
N/A — архитектурно значимого решения с новыми alternatives/consequences нет:
чинятся существующие владельцы строк в прежней одно-процессной топологии,
без новых компонентов и контрактов (Solution Assessment остаётся в archived
change).
Glossary / Navigation Impact
Нет: новые термины (terminal barrier, преемник попытки) — внутренние;
публичный словарь состояний не расширяется, navigation не меняется.
No-Change Rationale
docs/architecture/containers.md не меняется: раздел «Сохранение и
восстановление данных» описывает backup/restore уровня базы, а не восстановление
попытки приложением. Остальные AS-IS страницы не затрагиваются: HTTP contract
и словарь состояний не изменились.