Приём: пропажа источника у активной загрузки → failed(source_gone) (MAJOR-3)

Раздача активной (downloading) загрузки, исчезнувшая из qBittorrent (удалил
пользователь/другой клиент), делала задачу вечным зомби: поллинг промахивался
по torrentFor, писал Warn и continue каждый тик — состояние не менялось,
уведомления и телеметрии не было, checkTimeouts без торрента не срабатывал.
Пропажей источника у downloading не владел никто (сверка рассинхрона покрывает
только done/target_missing/orphaned, восстановление — failed/stuck).

Активный цикл Poll теперь применяет тот же дебаунс пропажи источника, что и
сверка рассинхрона (source_miss_count / source_missing_threshold): после порога
подряд идущих промахов задача уходит downloading → failed с distinct error_code
source_gone и уведомлением. До порога транзиентная недоступность qBit
(рестарт демона) задачу не роняет. source_gone восстановлению сверкой не
подлежит (удаление намеренно), но штатно retriable — Retry заново отдаёт
сохранённый источник; Retry сбрасывает source_miss_count, чтобы вернувшаяся
задача получила полное грейс-окно, а не упала снова на ближайшем тике.

Ребро downloading → failed уже было в графе, миграций/полей БД нет. Спека
download-tracking дополнена требованием, диаграмма workflow.md — ребром.
Change downloading-source-gone заархивирован.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-07-08 18:05:04 +03:00
co-authored by Claude Opus 4.8
parent bfd469bd43
commit 2a5a65f2d5
13 changed files with 524 additions and 21 deletions
+10 -1
View File
@@ -22,6 +22,7 @@ stateDiagram-v2
downloading --> completed: файлы на месте
downloading --> stuck: stalledDL дольше stuck_after
downloading --> failed: metaDL дольше magnet_timeout (страховка) / error
downloading --> failed: источник пропал из qBittorrent (source_gone, после дебаунса)
completed --> recognizing
@@ -170,6 +171,13 @@ SQLite; `worker` периодически сверяет qBittorrent с БД и
в `downloading` не ронял задачу снова на ближайшем тике.
- **ошибка:** `error`/`missingFiles``failed` (`error_code` `qbit_error`) —
это настоящий провал, в отличие от таймаута.
- **источник пропал:** раздача активной загрузки устойчиво (после дебаунса
`source_missing_threshold`, тот же счётчик, что и сверка рассинхрона) исчезла
из qBittorrent (удалил пользователь/другой клиент) → `failed` (`error_code`
`source_gone`). Иначе `downloading` без раздачи оставался бы вечным зомби,
которого никто не двигает (MAJOR-3). В отличие от таймаутов, сверка
`source_gone` **не воскрешает** (удаление намеренно) — но задача штатно
retriable: `Retry` заново отдаёт сохранённый источник.
### Уведомление и восстановление
@@ -184,7 +192,8 @@ SQLite; `worker` периодически сверяет qBittorrent с БД и
только источник в qBittorrent ожил и продвинулся за условие падения
(получил метаданные → `downloading`; уже готов → `completed`). Пока торрент
всё ещё в `metaDL`/`stalledDL`, задача остаётся упавшей (без зацикливания).
Настоящие провалы (`qbit_error`) сверкой не воскрешаются.
Настоящие провалы (`qbit_error`) и намеренная пропажа источника
(`source_gone`) сверкой не воскрешаются — только ручной retry.
- Дополнительно доступен **ручной retry** из веб-UI и Telegram (не только
REST): возвращает в `downloading`, перецепляясь к живому **здоровому** торренту
без повторного `Add` (к сломанному — `error`/`missingFiles` — не