diff --git a/architecture/cross-cutting/data-freshness.md b/architecture/cross-cutting/data-freshness.md index d8edd77..905cfbc 100644 --- a/architecture/cross-cutting/data-freshness.md +++ b/architecture/cross-cutting/data-freshness.md @@ -29,6 +29,14 @@ completeness, `lastSuccessfulAt`, `lastAttempt` и availability. Первые, результату. `lastAttempt` описывает относящуюся к ресурсу часовую попытку: `none`, `running`, `succeeded`, `partial` или `failed`. +Итог попытки выводится из фактических результатов её шагов: попытка, не +завершившая обязательный шаг, не обозначается полным успехом, а полученные +успешные результаты сохраняются. Ожидание каждого шага ограничено; зависший +шаг учитывается проблемным, а начатое обращение к T-Bank не отменяется. +Попытка, потерявшая выполнение после сбоя сохранения или остановки процесса, +закрывается частичным успехом либо неуспехом и не блокирует следующий обход +дольше обычного часового срока. + Поздняя неуспешная или частичная попытка сохраняет прежний полный результат и его исходное время. Если полного результата нет, `data` равно `null`: состояние availability объясняет первоначальную загрузку, временную недоступность либо diff --git a/integrations/tbank.md b/integrations/tbank.md index dfd61f3..2214df2 100644 --- a/integrations/tbank.md +++ b/integrations/tbank.md @@ -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.