docs: document hourly attempt lifecycle semantics (WealthLedger/backend#56)

2026-10-12 20:28:59 +03:00
parent 04dc662b2e
commit 1378ac9fe2
2 changed files with 14 additions and 1 deletions
@@ -29,6 +29,14 @@ completeness, `lastSuccessfulAt`, `lastAttempt` и availability. Первые,
 результату. `lastAttempt` описывает относящуюся к ресурсу часовую попытку:
 `none`, `running`, `succeeded`, `partial` или `failed`.

+Итог попытки выводится из фактических результатов её шагов: попытка, не
+завершившая обязательный шаг, не обозначается полным успехом, а полученные
+успешные результаты сохраняются. Ожидание каждого шага ограничено; зависший
+шаг учитывается проблемным, а начатое обращение к T-Bank не отменяется.
+Попытка, потерявшая выполнение после сбоя сохранения или остановки процесса,
+закрывается частичным успехом либо неуспехом и не блокирует следующий обход
+дольше обычного часового срока.
+
 Поздняя неуспешная или частичная попытка сохраняет прежний полный результат и
 его исходное время. Если полного результата нет, `data` равно `null`: состояние
 availability объясняет первоначальную загрузку, временную недоступность либо