telegram-tui/ROADMAP.md

Roadmap

Фаза 1: Базовая инфраструктура [DONE]

• Настройка проекта (Cargo.toml)
• TUI фреймворк (ratatui + crossterm)
• Базовый layout (папки, список чатов, область сообщений)
• Vim-style навигация (hjkl, стрелки)
• Русская раскладка (ролд)

Фаза 2: TDLib интеграция [DONE]

• Подключение tdlib-rs
• Авторизация (телефон + код + 2FA)
• Сохранение сессии
• Загрузка списка чатов
• Загрузка истории сообщений
• Отключение логов TDLib

Фаза 3: Улучшение UX [DONE]

• Отправка сообщений
• Фильтрация чатов (только Main, без архива)
• Поиск по чатам (Ctrl+S)
• Скролл истории сообщений
• Загрузка имён пользователей (вместо User_ID)
• Отметка сообщений как прочитанные
• Реальное время: новые сообщения

Фаза 4: Папки и фильтрация [DONE]

• Загрузка папок из Telegram
• Переключение между папками (1-9)
• Фильтрация чатов по папке

Фаза 5: Расширенный функционал [DONE]

• Отображение онлайн-статуса (зелёная точка ●)
• Статус доставки/прочтения (✓, ✓✓)
• Поддержка медиа-заглушек (фото, видео, голосовые, стикеры и др.)
• Mentions (@) — индикатор непрочитанных упоминаний
• Muted чаты (иконка 🔇)

Фаза 6: Полировка [DONE]

• Оптимизация использования памяти (базовая)
  • Очистка сообщений при закрытии чата
  • Лимит кэша пользователей (500)
  • Периодическая очистка неактивных записей
• Оптимизация 60 FPS
  • Poll таймаут 16ms
  • Флаг needs_redraw — рендеринг только при изменениях
  • Обработка Event::Resize для перерисовки при изменении размера
• Минимальное разрешение (80x20)
  • Предупреждение если терминал слишком мал
• Обработка ошибок сети
  • NetworkState enum (WaitingForNetwork, Connecting, etc.)
  • Индикатор в футере с цветовой индикацией
• Graceful shutdown
  • AtomicBool флаг для остановки polling
  • Корректное закрытие TDLib клиента
  • Таймаут ожидания завершения задач
• Динамический инпут
  • Автоматическое расширение до 10 строк
  • Wrap для длинного текста
• Перенос длинных сообщений
  • Автоматический wrap на несколько строк
  • Правильное выравнивание для исходящих/входящих

Фаза 7: Глубокий рефакторинг памяти [DONE]

• Удалить дублирование current_messages между App и TdClient
• Использовать единый источник данных для сообщений
• Реализовать LRU-кэш для user_names/user_statuses вместо простого лимита
• Lazy loading для имён пользователей (батчевая загрузка последних 5 за цикл)
• Лимиты памяти:
  • MAX_MESSAGES_IN_CHAT = 500
  • MAX_CHATS = 200
  • MAX_CHAT_USER_IDS = 500
  • MAX_USER_CACHE_SIZE = 500 (LRU)

Фаза 8: Дополнительные фичи [DONE]

• Markdown форматирование в сообщениях
  • Bold, Italic, Underline, Strikethrough
  • Code (inline, Pre, PreCode)
  • Spoiler (скрытый текст)
  • URLs, упоминания (@)
• Редактирование сообщений
  • ↑ при пустом инпуте → выбор сообщения
  • Enter для начала редактирования
  • Подсветка выбранного сообщения (▶)
  • Esc для отмены
• Удаление сообщений
  • d / в / Delete в режиме выбора
  • Модалка подтверждения (y/n)
  • Удаление для всех если возможно
• Индикатор редактирования (✎)
  • Отображается рядом с временем для отредактированных сообщений
• Блочный курсор в поле ввода
  • Vim-style курсор █
  • Перемещение ←/→, Home/End
  • Редактирование в любой позиции
• Reply на сообщения
  • r / к в режиме выбора → режим ответа
  • Превью сообщения в поле ввода
  • Esc для отмены
• Forward сообщений
  • f / а в режиме выбора → режим пересылки
  • Превью сообщения в поле ввода
  • Выбор чата стрелками, Enter для пересылки
  • Esc для отмены
  • Отображение "↪ Переслано от" для пересланных сообщений

Фаза 9: Расширенные возможности [DONE]

• Typing indicator ("печатает...")
  • Показывать когда собеседник печатает
  • Отправлять свой статус печати при наборе текста
• Закреплённые сообщения (Pinned)
  • Отображать pinned message вверху открытого чата
  • Клик/хоткей для перехода к закреплённому сообщению
• Поиск по сообщениям в чате
  • Ctrl+F — поиск текста внутри открытого чата
  • Навигация по результатам (n/N или стрелки)
  • Подсветка найденных совпадений
• Черновики
  • Сохранять набранный текст при переключении между чатами
  • Индикатор черновика в списке чатов
  • Восстановление текста при возврате в чат
• Профиль пользователя/чата
  • Ctrl+i — открыть информацию о чате/собеседнике
  • Для личных чатов: имя, username, телефон, био
  • Для групп: название, описание, количество участников
• Копирование сообщений
  • y / н в режиме выбора — скопировать текст в системный буфер обмена
  • Использовать clipboard crate для кроссплатформенности
• Реакции
  • Отображение реакций под сообщениями
  • e в режиме выбора — добавить реакцию (emoji picker)
  • Список доступных реакций чата
• Конфигурационный файл
  • ~/.config/tele-tui/config.toml
  • Настройки: цветовая схема, часовой пояс, хоткеи
  • Загрузка конфига при старте

Фаза 10: Desktop уведомления [DONE - 83%]

Стадия 1: Базовая реализация [DONE]

• NotificationManager модуль
  • notify-rust интеграция (версия 4.11)
  • Feature flag "notifications" в Cargo.toml
  • Базовая структура с настройками
• Конфигурация уведомлений
  • NotificationsConfig в config.toml
  • enabled: bool - вкл/выкл уведомлений
  • only_mentions: bool - только упоминания
  • show_preview: bool - показывать превью текста
• Интеграция с TdClient
  • Поле notification_manager в TdClient
  • Метод configure_notifications()
  • Обработка в handle_new_message_update()
• Базовая отправка уведомлений
  • Уведомления для сообщений не из текущего чата
  • Форматирование title (имя чата) и body (текст/медиа-заглушка)
  • Sender name из MessageInfo

Стадия 2: Улучшения [IN PROGRESS]

• Синхронизация muted чатов
  • Загрузка списка muted чатов из Telegram
  • Вызов sync_muted_chats() при инициализации и обновлении (Ctrl+R)
  • Muted чаты автоматически фильтруются из уведомлений
• Фильтрация по упоминаниям
  • Метод MessageInfo::has_mention() проверяет TextEntityType::Mention и MentionName
  • NotificationManager применяет фильтр only_mentions из конфига
  • Работает для @username и inline mentions
• Поддержка типов медиа
  • Метод beautify_media_labels() заменяет текстовые заглушки на emoji
  • Поддержка: 📷 Фото, 🎥 Видео, 🎞️ GIF, 🎤 Голосовое, 🎨 Стикер
  • Также: 📎 Файл, 🎵 Аудио, 📹 Видеосообщение, 📍 Локация, 👤 Контакт, 📊 Опрос
• Кастомизация звуков
  • Настройка звуков уведомлений в config.toml
  • Разные звуки для разных типов сообщений

Стадия 3: Полировка [DONE]

• Обработка ошибок
  • Graceful fallback если уведомления недоступны (возвращает Ok без паники)
  • Логирование ошибок через tracing::warn!
  • Детальное логирование причин пропуска уведомлений (debug level)
• Дополнительные настройки
  • timeout_ms - продолжительность показа (0 = системное значение)
  • urgency - уровень важности: "low", "normal", "critical" (только Linux)
  • Красивые эмодзи для типов медиа
• Опциональные улучшения (не критично)
  • Кросс-платформенное тестирование (требует ручного тестирования)
  • icon - кастомная иконка приложения
  • Actions в уведомлениях (кнопки "Ответить", "Прочитано")

Фаза 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 (xterm, WezTerm, mintty)
  • Kitty Graphics Protocol (Kitty terminal)
  • iTerm2 Inline Images (iTerm2 на macOS)
  • Unicode Halfblocks (fallback для всех)
• Поддерживаемые форматы:
  • JPEG, PNG, GIF, WebP, BMP
• Новые хоткеи:
  • v / м - открыть изображение в полном размере (режим выбора)
  • ← / → - навигация между изображениями (в режиме просмотра)
  • Esc - закрыть полноэкранный просмотр