telegram-tui/ROADMAP.md

Roadmap

Завершённые фазы

Фаза	Описание	Ключевые результаты
1	Базовая инфраструктура	ratatui + crossterm, vim-навигация, русская раскладка
2	TDLib интеграция	tdlib-rs, авторизация, загрузка чатов и сообщений
3	Улучшение UX	Отправка, поиск, скролл, realtime обновления
4	Папки и фильтрация	Загрузка папок из Telegram, переключение 1-9
5	Расширенный функционал	Онлайн-статус, галочки прочтения, медиа-заглушки, muted
6	Полировка	60 FPS, оптимизация памяти, graceful shutdown, динамический инпут
7	Рефакторинг памяти	Единый источник данных, LRU-кэш (500 users), lazy loading
8	Дополнительные фичи	Markdown, edit/delete, reply/forward, блочный курсор
9	Расширенные возможности	Typing, pinned, поиск в чате, черновики, профиль, копирование, реакции, конфиг
10	Desktop уведомления (83%)	notify-rust, muted фильтр, mentions, медиа. TODO: кастомные звуки
11	Inline просмотр фото	Dual renderer (Halfblocks + iTerm2/Sixel), throttling 15 FPS, modal viewer, lazy loading
12	Голосовые сообщения	ffplay player, pause/resume with seek, VoiceCache, AudioConfig, progress bar + waveform UI
13	Глубокий рефакторинг	5 файлов (4582->модули), 5 traits, shared components, docs

---

Фаза 11: Inline просмотр фото в чате [DONE]

UX: Always-show inline preview (50 chars, Halfblocks) -> v/м открывает fullscreen modal (iTerm2/Sixel) -> ←/→ навигация между фото.

Реализовано:

• Dual renderer архитектура:
  • inline_image_renderer: Halfblocks (быстро, Unicode блоки) для навигации
  • modal_image_renderer: iTerm2/Sixel (медленно, высокое качество) для просмотра
• Performance optimizations:
  • Frame throttling: inline 15 FPS, текст 60 FPS
  • Lazy loading: только видимые изображения
  • LRU cache: max 100 протоколов
  • Skip partial rendering (no flickering)
• UX улучшения:
  • Always-show inline preview (фикс. ширина 50 chars)
  • Fullscreen modal на v/м с aspect ratio
  • Loading indicator в модалке
  • Navigation hotkeys: ←/→ между фото, Esc/q закрыть
• Типы и API:
  • MediaInfo, PhotoInfo, PhotoDownloadState, ImageModalState
  • ImagesConfig в config.toml
  • Feature flag images для зависимостей
• Media модуль:
  • cache.rs: ImageCache (LRU)
  • image_renderer.rs: new() + new_fast()
• UI модули:
  • modals/image_viewer.rs: fullscreen modal
  • messages.rs: throttled second-pass rendering

---

Фаза 12: Прослушивание голосовых сообщений [DONE]

Этап 1: Инфраструктура аудио [DONE]

• Модуль src/audio/
  • player.rs — AudioPlayer на ffplay (subprocess)
  • cache.rs — VoiceCache (LRU, configurable size, ~/.cache/tele-tui/voice/)
• AudioPlayer API: play(), play_from(ss), pause() (SIGSTOP), resume(), resume_from(ss), stop()
• Race condition fix: starting flag + pid ownership guard в потоках
• Drop impl для AudioPlayer (убивает ffplay при выходе)

Этап 2: Интеграция с TDLib [DONE]

• Типы: VoiceInfo, VoiceDownloadState, PlaybackState, PlaybackStatus
• Конвертация MessageVoiceNote в message_conversion.rs
• download_voice_note() в TdClientTrait + client_impl + fake
• Методы has_voice(), voice_info(), voice_info_mut() на MessageInfo

Этап 3: UI для воспроизведения [DONE]

• Progress bar (━●─) с позицией и длительностью
• Waveform визуализация (▁▂▃▄▅▆▇█) из base64-encoded TDLib данных
• Иконки статуса: ▶ Playing, ⏸ Paused, ⏹ Stopped
• Throttled redraw: обновление UI только при смене секунды (не 60 FPS)

Этап 4: Хоткеи [DONE]

• Space — play/pause toggle (запуск + пауза/возобновление с откатом 1s)
• ←/→ — seek ±5 сек (через resume_from() — перезапуск ffplay с -ss)
• Seek работает и при воспроизведении, и на паузе (на паузе двигает позицию, при resume стартует с неё)
• MoveLeft/MoveRight как alias для SeekBackward/SeekForward (HashMap non-deterministic order fix)
• Автоматическая остановка при навигации на другое сообщение
• Остановка ffplay при выходе из приложения (Ctrl+C)

Этап 5: Конфигурация и кэш [DONE]

• AudioConfig в config.toml (cache_size_mb, auto_download_voice)
• DEFAULT_AUDIO_CACHE_SIZE_MB константа (100 MB)
• Ticker для progress bar в event loop (delta-based position tracking)
• VoiceCache интеграция: проверка кэша перед загрузкой, кэширование после download

Технические детали

• Аудио: ffplay (subprocess), resume/seek через перезапуск с -ss offset
• Race conditions: starting flag предотвращает false is_stopped() при старте ffplay; pid ownership guard в потоках предотвращает затирание pid нового процесса старым
• Keybinding conflict: Left/Right привязаны к MoveLeft/MoveRight и SeekBackward/SeekForward; HashMap iteration order не гарантирован → оба варианта обрабатываются как seek в режиме выбора сообщения
• Платформы: macOS, Linux (везде где есть ffmpeg)
• Хоткеи: Space (play/pause), ←/→ (seek ±5s)