Files

Mikhail Kilin 6845ee69bf docs: trim CONTEXT.md and ROADMAP.md (3006→246 lines, -92%)

Completed phases condensed to summary tables, detailed history
removed (available in git log). Detailed plans kept only for
upcoming phases 11 (images) and 12 (voice messages).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-06 16:57:27 +03:00

4.2 KiB

Raw Blame History

Текущий контекст проекта

Статус: Фазы 1-10, 13 завершены. Следующие: Фаза 11 (изображения) или 12 (голосовые)

Завершённые фазы (краткий итог)

Фаза	Описание	Статус
1	Базовая инфраструктура (ratatui + crossterm, vim-навигация)	DONE
2	TDLib интеграция (авторизация, чаты, сообщения)	DONE
3	Улучшение UX (отправка, поиск, скролл, realtime)	DONE
4	Папки и фильтрация (загрузка папок, переключение 1-9)	DONE
5	Расширенный функционал (онлайн-статус, медиа-заглушки, muted)	DONE
6	Полировка (60 FPS, память, graceful shutdown, динамический инпут)	DONE
7	Рефакторинг памяти (единый источник данных, LRU-кэш)	DONE
8	Дополнительные фичи (markdown, edit/delete, reply/forward, блочный курсор)	DONE
9	Расширенные возможности (typing, pinned, поиск в чате, черновики, профиль, копирование, реакции, конфиг)	DONE
10	Desktop уведомления (notify-rust, muted фильтр, mentions, медиа)	DONE (83%)
13	Глубокий рефакторинг архитектуры (7 этапов)	DONE

Фаза 13: Рефакторинг (подробности)

Разбиты 5 монолитных файлов (4582 строк) на модульную архитектуру:

input/main_input.rs (1199→164): чистый роутер + 5 handler модулей в handlers/
app/mod.rs (1015→371): 5 trait модулей в methods/ (Navigation, Message, Compose, Search, Modal)
ui/messages.rs (893→365): модули modals/ (search, pinned, delete, reactions) + compose_bar.rs
tdlib/messages.rs (836→3 файла): messages/ (mod, convert, operations)
config/mod.rs (642→3 файла): validation.rs, loader.rs
Очистка дублей: ~220 строк удалено (shared components, format_user_status, scroll_to_message)
Документация: PROJECT_STRUCTURE.md переписан, 16 файлов получили //! docs

Ключевая архитектура

main.rs → event loop (16ms poll)
├── input/ → роутер + handlers/ (chat, chat_list, compose, modal, search)
├── app/ → App<T: TdClientTrait> + methods/ (5 traits, 67 методов)
├── ui/ → рендеринг (messages, chat_list, modals/, compose_bar, components/)
└── tdlib/ → TDLib wrapper (client, auth, chats, messages/, users, reactions, types)

Тестирование

500+ тестов (0 failures):

Snapshot tests: 57 (UI компоненты)
Integration tests: 93 (user flows)
E2E tests: 12 (smoke + journey)
Utils tests: 18
Performance benchmarks: 8

Ключевые решения

Неблокирующий receive: TDLib updates через mpsc::channel в отдельном потоке
Trait-based App: методы разбиты на traits — требуют use import на call site
FakeTdClient: mock для тестов без TDLib (реализует TdClientTrait)
Оптимизация рендеринга: needs_redraw флаг, рендеринг только при изменениях
Конфиг: TOML ~/.config/tele-tui/config.toml, credentials с приоритетом (XDG → .env)

Зависимости (основные)

ratatui = "0.29"      # TUI фреймворк
crossterm = "0.28"     # Терминальный backend
tdlib-rs = "1.1"       # Telegram TDLib binding
tokio = "1"            # Async runtime
notify-rust = "4.11"   # Desktop уведомления (feature flag)

Полная структура проекта: см. PROJECT_STRUCTURE.md Подробный план: см. ROADMAP.md

4.2 KiB Raw Blame History Unescape Escape