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