Skip to content

Задача 003: Навигатор документации в боте (Система Гидов)

Приоритет: 🔴 Высокий Status: 📅 Запланировано Целевая версия: v0.3.0

📝 Описание

Реализовать структурированную систему навигации для отображения документации прямо внутри Telegram-бота. Система будет использовать гибридный подход: краткая, применимая информация внутри бота и мост к полной веб-документации.

🎯 Цели

  1. MVP - Быстрый гид: Системная фича guide, которая отрисовывает основные концепции фреймворка в виде коротких, легко читаемых сообщений.
  2. Паттерн навигации:
  3. Главное меню: Список ключевых тем (Архитектура, БД, Редис и т.д.).
  4. Кнопки действий: Переход между темами.
  5. Связь с сайтом: Постоянная кнопка "🌐 Посмотреть подробнее на сайте" внизу каждого сообщения гида, ведущая на официальный сайт.
  6. Модульность: Позволить фичам регистрировать свои собственные "быстрые справки".

🚀 Этапы реализации

  • Шаг 1: Создать базовый оркестратор и UI для guide со статичными текстами.
  • Шаг 2: Реализовать кнопку "Сайт" через URL-кнопки в клавиатуре.
  • Шаг 3: Интегрировать с DiscoveryService для динамической регистрации страниц.

🛠 Технические заметки

  • Использовать DiscoveryService для управления списком доступных разделов гида.
  • URL сайта должен быть настраиваемым через BotSettings (по умолчанию ведет на сайт документации).

✅ Критерии готовности

  • [ ] Пользователь видит категоризированный список тем помощи.
  • [ ] Каждая тема отображает краткое резюме.
  • [ ] Каждая страница гида содержит рабочую ссылку на внешний сайт документации.
  • [ ] Навигация работает быстро и не замусоривает историю чата (через ViewSender).