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: кастомные звуки |
| 13 | Глубокий рефакторинг | 5 файлов (4582→модули), 5 traits, shared components, docs |

---

## Фаза 11: Показ изображений в чате [PLANNED]

### Этап 1: Инфраструктура [TODO]
- [ ] Модуль src/media/
  - image_cache.rs - LRU кэш для загруженных изображений
  - image_loader.rs - Асинхронная загрузка через TDLib
  - image_renderer.rs - Рендеринг в ratatui
- [ ] Зависимости
  - ratatui-image 1.0 - поддержка изображений в TUI
  - Определение протокола терминала (Sixel/Kitty/iTerm2/Halfblocks)
- [ ] ImageCache с лимитами
  - LRU кэш с максимальным размером в МБ
  - Автоматическая очистка старых изображений
  - MAX_IMAGE_CACHE_SIZE = 100 MB (по умолчанию)

### Этап 2: Интеграция с TDLib [TODO]
- [ ] Обработка MessageContentPhoto
  - Добавить PhotoInfo в MessageInfo
  - Извлечение file_id, width, height из Photo
  - Выбор оптимального размера изображения (до 800px)
- [ ] Загрузка файлов
  - Метод TdClient::download_photo(file_id)
  - Асинхронная загрузка через downloadFile API
  - Обработка состояний загрузки (pending/downloading/ready)
- [ ] Кэширование
  - Сохранение путей к загруженным файлам
  - Повторное использование уже загруженных изображений

### Этап 3: Рендеринг в UI [TODO]
- [ ] Модификация render_messages()
  - Определение возможностей терминала при старте
  - Рендеринг изображений через ratatui-image
  - Автоматическое масштабирование под размер области
  - Сохранение aspect ratio
- [ ] Превью в списке сообщений
  - Миниатюры размером 20x10 символов
  - Lazy loading (загрузка только видимых)
  - Placeholder пока изображение грузится
- [ ] Индикатор загрузки
  - Текстовая заглушка "[Загрузка фото...]"
  - Progress bar для больших файлов
  - Процент загрузки

### Этап 4: Полноэкранный просмотр [TODO]
- [ ] Новый режим: ViewImage
  - `v` / `м` в режиме выбора - открыть изображение
  - Показ на весь экран терминала
  - `Esc` для закрытия
- [ ] Информация об изображении
  - Размер файла
  - Разрешение (width x height)
  - Формат (JPEG/PNG/GIF)
- [ ] Навигация
  - `←` / `→` - предыдущее/следующее изображение в чате
  - Автоматическая загрузка соседних изображений

### Этап 5: Конфигурация и UX [TODO]
- [ ] MediaConfig в config.toml
  - show_images: bool - включить/отключить показ изображений
  - image_cache_mb: usize - размер кэша в МБ
  - preview_quality: "low" | "medium" | "high"
  - render_protocol: "auto" | "sixel" | "kitty" | "iterm2" | "halfblocks"
- [ ] Поддержка различных терминалов
  - Auto-detection протокола при старте
  - Fallback на Unicode halfblocks для любого терминала
  - Опция отключения изображений если терминал не поддерживает
- [ ] Оптимизация производительности
  - Асинхронная загрузка (не блокирует UI)
  - Приоритизация видимых изображений
  - Fast resize для превью
  - Кэширование отмасштабированных версий

### Этап 6: Обработка ошибок [TODO]
- [ ] Graceful fallback
  - Текстовая заглушка "[Фото]" если загрузка не удалась
  - Повторная попытка по запросу пользователя
  - Логирование проблем через tracing
- [ ] Ограничения
  - Таймаут загрузки (30 сек)
  - Максимальный размер файла для автозагрузки (10 MB)
  - Предупреждение для больших файлов

### Технические детали
- **Поддерживаемые протоколы:** Sixel, Kitty Graphics, iTerm2 Inline Images, Unicode Halfblocks (fallback)
- **Поддерживаемые форматы:** JPEG, PNG, GIF, WebP, BMP
- **Новые хоткеи:** `v`/`м` - полноэкранный просмотр, `←`/`→` - навигация, `Esc` - закрыть

---

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

### Этап 1: Инфраструктура аудио [TODO]
- [ ] Модуль src/audio/
  - player.rs - AudioPlayer на rodio
  - cache.rs - VoiceCache для загруженных файлов
  - state.rs - PlaybackState (статус, позиция, громкость)
- [ ] Зависимости
  - rodio 0.17 - Pure Rust аудио библиотека
  - Feature flag "audio" в Cargo.toml
- [ ] AudioPlayer API
  - play(), pause()/resume(), stop(), seek(), set_volume(), get_position()
- [ ] VoiceCache
  - Кэш загруженных OGG файлов в ~/.cache/tele-tui/voice/
  - LRU политика очистки, MAX_VOICE_CACHE_SIZE = 100 MB

### Этап 2: Интеграция с TDLib [TODO]
- [ ] Обработка MessageContentVoiceNote
  - Добавить VoiceNoteInfo в MessageInfo
  - Извлечение file_id, duration, mime_type, waveform
- [ ] Загрузка файлов
  - Метод TdClient::download_voice_note(file_id)
  - Асинхронная загрузка через downloadFile API
  - Обработка состояний (pending/downloading/ready)
- [ ] Кэширование путей к загруженным файлам

### Этап 3: UI для воспроизведения [TODO]
- [ ] Индикатор в сообщении
  - Иконка 🎤 и длительность голосового
  - Progress bar во время воспроизведения
  - Статус: ▶ (playing), ⏸ (paused), ⏹ (stopped), ⏳ (loading)
  - Текущее время / общая длительность (0:08 / 0:15)
- [ ] Footer с управлением
  - "[Space] Play/Pause  [s] Stop  [←/→] Seek  [↑/↓] Volume"
- [ ] Waveform визуализация (опционально)
  - Символы ▁▂▃▄▅▆▇█ для визуализации

### Этап 4: Хоткеи для управления [TODO]
- [ ] Новые команды
  - Space - play/pause, s/ы - stop
  - ←/→ - seek ±5 сек, ↑/↓ - volume ±10%
- [ ] Контекстная обработка (управление только во время воспроизведения)
- [ ] Поддержка русской раскладки

### Этап 5: Конфигурация и UX [TODO]
- [ ] AudioConfig в config.toml
  - enabled, default_volume, seek_step_seconds, autoplay, cache_size_mb, show_waveform
  - system_player_fallback, system_player (mpv, ffplay)
- [ ] Асинхронная загрузка (не блокирует UI)
- [ ] Ticker для обновления progress bar (каждые 100ms)

### Этап 6: Обработка ошибок [TODO]
- [ ] Graceful fallback на системный плеер (mpv/ffplay)
- [ ] Таймаут загрузки (30 сек), повторная попытка
- [ ] Ограничения: максимальный размер файла, автоочистка кэша

### Этап 7: Дополнительные улучшения [TODO]
- [ ] Автоматическая остановка при закрытии чата
- [ ] Сохранение позиции при паузе
- [ ] Префетчинг следующего голосового (опционально)

### Технические детали
- **Аудио библиотека:** rodio 0.17 (Pure Rust, кроссплатформенная, OGG Opus)
- **Платформы:** Linux (ALSA/PulseAudio), macOS (CoreAudio), Windows (WASAPI)
- **Fallback:** mpv --no-video, ffplay -nodisp
- **Новые хоткеи:** Space - play/pause, s/ы - stop, ←/→ - seek, ↑/↓ - volume