av
8739b18a9f
- порядок беклога и роадмапа назначен слоями: проверки, которым можно верить → долги входа → владелец записи и контракт API → конвейер под тестами → приложение и возможности поверх; у каждого движения записана причина; - заведены восемь задач под пункты «Завершения», которых не закрывала ни одна запись, — цель any-audio-source была без задач вовсе; - у четырёх задач сняты критерии, требовавшие того, что делает задача ниже по очереди; исправлены ссылки на несуществующий repo/sqlite и на отменённую разведку об очереди.
6.5 KiB
6.5 KiB
Роадмап
Состояние проекта: что приложение уже умеет и чего ещё не умеет.
Цель — возможность приложения: файл типа goal (🎯) в
items/. Её задачи здесь не перечисляются — перечень даёт
tasks.py list --goal <слаг>.
- Запланировано — очередь значима и обосновывается прозой;
- Направления — очереди нет, тянутся долго;
- Сопровождение — чем держат проект: инструмент, процесс, эксплуатация. Не возможности приложения, и отдельно — чтобы не читаться как обещание продукта;
- Готово — достигнутое: строку пишет
tasks.py close <цель> --implemented, ссылки на файл в ней нет — файл удаляется, поведение живёт в спеках. Стоит последней: копится.
Секции канонические и переименованию проектом не подлежат:
у каждой свой смысл, и в достигнутое пишет сам close. Порядок
тоже канонический. Английский
вариант — Planned | Directions | Operations | Done, один язык на весь
индекс.
Запланировано
- 🎯 Сервисом пользуются несколько человек, и записи одного не видны другому — У задачи нет владельца, а HTTP API открыт наружу без аутентификации: пригласить второго человека сейчас значит открыть ему чужие расшифровки.
- 🎯 Записи загружаются и читаются в приложении, которое ставится на телефон — Сегодня записи принимает только бот и голый HTTP API без интерфейса: отдать сервис человеку, у которого нет Telegram, нечем.
- 🎯 Загрузка большого файла доходит до сервиса и не повторяется впустую — Приём рассчитан на голосовое в пару мегабайт: обрыв на середине гигабайтного файла начинает загрузку заново, а один и тот же файл распознаётся повторно за наши деньги.
- 🎯 Человек убирает свою запись из архива вместе со всеми текстами — Хранение бессрочное, а способа убрать запись нет ни одного: ошибочно загруженный файл и разговор, который человек не хочет держать у нас, остаются навсегда.
- 🎯 Пользователь настраивает, что сервис делает с его записями — Уровни текста считает платная модель, а уведомления приходят одним общим способом: отказаться от лишнего и выбрать свой канал пользователю нечем.
- 🎯 Приложение показывает, о чём запись, не читая её целиком — Расшифровка часового разговора — это стена текста: найти в списке нужную запись и вспомнить, о чём она, сегодня нечем.
- 🎯 Пользователь узнаёт о готовности текста, не держа приложение открытым — Расшифровка занимает минуты, и всё это время человек либо смотрит на экран с опросом статуса, либо забывает вернуться.
Направления
- 🎯 Запись длиной до шести часов доходит до текста — Потолок не замерен ни на одном звене: Telegram не отдаёт больше 20 МиБ, границы модели deferred-general неизвестны, а перезапуск на середине начинает распознавание заново.
- 🎯 Принимается запись любого формата, включая дорожку из видео — Конвертер вызывается одной командой ffmpeg, проверенной на голосовых Telegram; что он берёт помимо них, никто не мерил.
Сопровождение
- 🎯 Состояние сервиса видно без чтения логов — Отказ замечает пользователь, а не владелец: оповещения нет, а путь записи по конвейеру собирается глазами по логам контейнера.
- 🎯 Владелец видит, кто сколько загрузил и во что это обошлось — Распознавание и языковая модель оплачиваются по факту, а счёт приходит одной суммой: кто её набрал, из сервиса не выясняется.
Готово
- 2025-08-14
telegram-transcription— Голосовое сообщение из Telegram возвращается текстом. Первый вход сервиса: бот принимает голосовое, аудиофайл и документ с аудио и отвечает расшифровкой. - 2025-08-08
api-transcription— Запись, отданная по HTTP, возвращается текстом. Программный вход: файл отдаётся формой, готовность и текст забираются опросом статуса задачи.