Files
transcriber/tasks/items/external-call-timeouts.md
T
av d21da8575c Единый список задач вместо двух секций, порядок по выполнению
Секции «Ядро» и «Инфра» слиты в одну «Очередь»: полок домена у проекта
нет, а две секции держали два независимых порядка вместо одного.

Порядок: красный гейт, потом долги, задевающие интерфейсы, потом
хранилище, вход, разграничение, приложение. Разведка потолков SpeechKit
последней — она обслуживает направление, а не очередь.
2026-08-10 21:39:55 +03:00

3.3 KiB
Raw Blame History

🧹 Задать таймауты обращениям к внешним сервисам

  • Тип: chore
  • Категория: Очередь
  • Зачем: Ни у Telegram, ни у Object Storage, ни у SpeechKit нет таймаута: молчащий собеседник держит шаг конвейера до истечения часового захвата.

Все обращения наружу идут с context.Background() либо через http.Get без клиента со своим таймаутом. Отказ такого рода в architecture.md назван условием: собеседник, который «отвечает медленно», сегодня останавливает воркер целиком, и заметить это можно только по тому, что задачи перестали двигаться.

Сюда же контекст: воркеры получают ctx и отменяют его при остановке, но ни один шаг конвейера внутрь его не передаёт — мягкая остановка ждёт таймаута вместо того, чтобы прервать вызов.

Затрагивает

  • internal/adapter/recognizer/yandex/s3.go — заливка объекта;
  • internal/adapter/recognizer/yandex/speechkit.go — запуск распознавания, чтение потока, опрос операции;
  • internal/controller/tg/tg.go — скачивание файла через http.Get;
  • internal/adapter/telegram/sender.go — отправка сообщения;
  • internal/contract/contract.go — интерфейсам нужен context.Context первым аргументом;
  • internal/controller/worker/worker.go и internal/service/transcribe.go — протаскивание контекста в шаг;
  • config.dist.toml и internal/config — числа таймаутов;
  • docs/database.md, таблица настроек с числовым значением.

Критерии приёмки

  • У каждого обращения наружу есть таймаут, и его значение задаётся конфигом. Оракул — тест на подставном сервере, который не отвечает: вызов возвращается с ошибкой за назначенное время, а не висит.
  • Отмена контекста при остановке приложения прерывает шаг конвейера. Оракул — тест: отменённый контекст возвращает управление из шага, задача остаётся в прежнем состоянии.
  • Прерванная по таймауту задача достаётся повторно и доходит до текста. Оракул — тест на повторный прогон шага после отказа по таймауту.
  • Числа таймаутов записаны в docs/database.md. Оракул — task gate.

Рамки

Повторов с нарастающей паузой не заводим — это отдельная работа; здесь только таймаут и отмена.