docs: document hourly attempt lifecycle semantics (WealthLedger/backend#56)
This commit is contained in:
@@ -29,6 +29,14 @@ completeness, `lastSuccessfulAt`, `lastAttempt` и availability. Первые,
|
||||
результату. `lastAttempt` описывает относящуюся к ресурсу часовую попытку:
|
||||
`none`, `running`, `succeeded`, `partial` или `failed`.
|
||||
|
||||
Итог попытки выводится из фактических результатов её шагов: попытка, не
|
||||
завершившая обязательный шаг, не обозначается полным успехом, а полученные
|
||||
успешные результаты сохраняются. Ожидание каждого шага ограничено; зависший
|
||||
шаг учитывается проблемным, а начатое обращение к T-Bank не отменяется.
|
||||
Попытка, потерявшая выполнение после сбоя сохранения или остановки процесса,
|
||||
закрывается частичным успехом либо неуспехом и не блокирует следующий обход
|
||||
дольше обычного часового срока.
|
||||
|
||||
Поздняя неуспешная или частичная попытка сохраняет прежний полный результат и
|
||||
его исходное время. Если полного результата нет, `data` равно `null`: состояние
|
||||
availability объясняет первоначальную загрузку, временную недоступность либо
|
||||
|
||||
@@ -97,7 +97,12 @@ sequenceDiagram
|
||||
|
||||
`INVALID_TBANK_TOKEN` означает отказ внешней аутентификации или прав доступа.
|
||||
`TBANK_UNAVAILABLE` сообщает о временной или иной upstream-ошибке, включая
|
||||
исчерпание очереди. Ответы и ошибки не содержат token. Удаление подключения
|
||||
исчерпание очереди. Диагностические причины жизненного цикла часовой попытки
|
||||
(`INTERRUPTED` — прерывание до нормального завершения, `DEADLINE` — истечение
|
||||
ограничения ожидания шага) не относятся к ошибкам T-Bank: они остаются
|
||||
внутренней диагностикой и не раскрываются в hourly-read. Истечение ограничения
|
||||
ожидания не отменяет уже начатые обращения к T-Bank; их поздние результаты
|
||||
остаются в строках шагов. Ответы и ошибки не содержат token. Удаление подключения
|
||||
идемпотентно: удаляются локальный секрет, личные datasets и work; поздняя
|
||||
публикация прежней revision запрещена. Общие неперсональные источники могут
|
||||
сохраняться. Оно не описывает отзыв token на стороне T-Bank.
|
||||
|
||||
Reference in New Issue
Block a user