av
bb973b0a68
Разведка job-queue-choice — очередь написана вручную: захват не транзакционен, повторов и счётчика попыток нет, очереди мёртвых задач нет. Стоит перед сменой хранилища, чтобы не переписывать захват дважды. Цель text-insights: заголовок, пересказ и темы внешним сервисом с OpenAI-совместимым интерфейсом. Граница паспорта сдвинута — «понимание сказанного» было записано как то, чем проект не является; за границей остались ответы на вопросы по записи и поиск по смыслу. Цель service-observability в сопровождении и разведка opentelemetry-fit: /metrics остаётся и развивается, способ решает замер.
4.7 KiB
4.7 KiB
Роадмап
Состояние проекта: что приложение уже умеет и чего ещё не умеет.
Цель — возможность приложения: файл типа goal (🎯) в
items/. Её задачи здесь не перечисляются — перечень даёт
tasks.py list --goal <слаг>.
- Запланировано — очередь значима и обосновывается прозой;
- Направления — очереди нет, тянутся долго;
- Сопровождение — чем держат проект: инструмент, процесс, эксплуатация. Не возможности приложения, и отдельно — чтобы не читаться как обещание продукта;
- Готово — достигнутое: строку пишет
tasks.py close <цель> --implemented, ссылки на файл в ней нет — файл удаляется, поведение живёт в спеках. Стоит последней: копится.
Секции канонические и переименованию проектом не подлежат:
у каждой свой смысл, и в достигнутое пишет сам close. Порядок
тоже канонический. Английский
вариант — Planned | Directions | Operations | Done, один язык на весь
индекс.
Запланировано
- 🎯 Записи загружаются и читаются в приложении, которое ставится на телефон — Сегодня записи принимает только бот и голый HTTP API без интерфейса: отдать сервис человеку, у которого нет Telegram, нечем.
- 🎯 Сервисом пользуются несколько человек, и записи одного не видны другому — У задачи нет владельца, а HTTP API открыт наружу без аутентификации: пригласить второго человека сейчас значит открыть ему чужие расшифровки.
- 🎯 Пользователь узнаёт о готовности текста, не держа приложение открытым — Расшифровка занимает минуты, и всё это время человек либо смотрит на экран с опросом статуса, либо забывает вернуться.
Направления
- 🎯 Принимается запись любого формата, включая дорожку из видео — Конвертер вызывается одной командой ffmpeg, проверенной на голосовых Telegram; что он берёт помимо них, никто не мерил.
- 🎯 Запись длиной в несколько часов доходит до текста — Потолок не замерен ни на одном звене: Telegram не отдаёт больше 20 МиБ, а границы модели deferred-general неизвестны.
- 🎯 Приложение показывает, о чём запись, не читая её целиком — Расшифровка часового разговора — это стена текста: найти в списке нужную запись и вспомнить, о чём она, сегодня нечем.
Сопровождение
- 🎯 Состояние сервиса видно без чтения логов — Отказ замечает пользователь, а не владелец: оповещения нет, а путь записи по конвейеру собирается глазами по логам контейнера.
Готово
- 2025-08-14
telegram-transcription— Голосовое сообщение из Telegram возвращается текстом. Основной вход сервиса: бот принимает голосовое, аудиофайл и документ с аудио и отвечает расшифровкой. - 2025-08-08
api-transcription— Запись, отданная по HTTP, возвращается текстом. Программный вход: файл отдаётся формой, готовность и текст забираются опросом статуса задачи.