av
4d1c2bf44c
docs/ по канону 12: паспорт с целью проекта, архитектура сегодняшнего устройства, схема хранилища, модель угроз, конвенции кода, журнал ревью. Конвенции перенесены из jellybit; места, где код им не следует, помечены строкой «Расхождение» как объявленный долг. tasks/ с роадмапом: две достигнутые цели, две запланированные (веб и многопользовательский режим), два направления (все форматы, долгие записи) и пять задач в беклоге. openspec/config.yaml — маршрутизатор с адресами документов, спек пока нет. CLAUDE.md переписан по форме канона: инварианты с severity, семантика гейта, запреты с путями. Taskfile получил task gate.
3.3 KiB
3.3 KiB
🧹 Задать таймауты обращениям к внешним сервисам
- Тип: 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.
Рамки
Повторов с нарастающей паузой не заводим — это отдельная работа; здесь только таймаут и отмена.