av/jellybit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
Раздача активной (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
Download Patch File Download Diff File Expand all files Collapse all files
internal/worker/reconcile_test.go
+8 -4
View File
@@ -151,13 +151,17 @@ func TestReconcileDebounce(t *testing.T) {
}
func TestReconcileSkipsActiveStates(t *testing.T) {
// downloading сверкой не трогаем, даже если раздачи нет в qBittorrent.
f := newReconcileFixture(t, store.StateDownloading, false, true)
// Матрица сверки (reconcileDesync) не трогает активные состояния, даже если
// раздачи нет в qBittorrent. Берём review (не downloading): активный цикл
// поллинга листает только downloading, поэтому review остаётся нетронутым
// — пропажу источника у downloading отдельно ведёт правило source_gone
// (см. recovery_test: TestSourceGone*).
f := newReconcileFixture(t, store.StateReview, false, true)
if err := f.w.Poll(context.Background()); err != nil {
t.Fatalf("Poll: %v", err)
}
if got := f.st.downloads["1"].State; got != store.StateDownloading {
t.Errorf("state = %q, want downloading (сверка не трогает активные)", got)
if got := f.st.downloads["1"].State; got != store.StateReview {
t.Errorf("state = %q, want review (сверка не трогает активные)", got)
}
}