# 🗺️ ДОРОЖНАЯ КАРТА И АРХИТЕКТУРНЫЙ РОАДМАП ПРОЕКТА SCUD ORION AI

## 📌 Зафиксированные вехи и концептуальные архитектурные решения

Схема веток Gitea для ближайшего развития проекта:

main (100% стабильный релиз)
  │
  ├──► feature/tool-registry-db ──────┐ (Создание таблицы tool_action_registry в SQLite)
  │                                   ▼
  ├───────────────────────────────► merge to main
  │
  ├──► feature/interactive-buttons ───┐ (Подключение Да/Нет чипсов на фронтенде)
  │                                   ▼
  ├───────────────────────────────► merge to main
  │
  └──► feature/ephemeral-context ─────┐ (Внедрение флагов is_ephemeral для очистки памяти LLM)
                                      ▼
                                  merge to main




### 1. Архитектура скользящего контекста и отслеживания смены темы (Intent / Topic Drift Tracking)
* **Проблема:** При работе с длинными операциями (редактирование промптов, мастера табелей, снапшотов) оператор может отвлекаться на сторонние вопросы или уточнения. Жесткий сброс сессии уничтожает черновики, а вечное хранение засоряет память LLM.
* **Решение (Сферическое / Фундаментальное):**
  1. **Семантическая оценка моделью:** Модель через системный контекст определяет, относится ли вопрос оператора к активному черновику/инструменту или разговор ушел в сторону (`topic_shift = true`).
  2. **Детерминированный счетчик в бэкенде:** Бэкенд фиксирует шаги отвлечения (`idle_turns`). Пока $N < 3$, оператор может свободно общаться, не теряя висящий контекст.
  3. **Вежливый перехват и выбор (Guard):** На 3-м шаге отвлечения система отвечает на текущий вопрос оператора и мягко напоминает о незавершенной транзакции кнопками `[Применить / Сохранить]` или `[Отменить и сбросить]`.

---

## 🚀 Будущие модули и запланированный функционал (Backlog)

### 2. Интерактивный модуль планирования и дорожных карт (Checklist & Task Planner Engine)
* **Концепция:** Специализированный инструмент для LLM-агента, позволяющий вести динамические проектные чек-листы и планы с интерактивными чекбоксами прямо в диалоге и базе данных.
* **Ключевые возможности:**
  * Составление многоуровневых планов с чекбоксами (`[ ]` / `[x]`).
  * Фиксация промежуточных комментариев и статусов выполнения по каждому пункту.
  * Синхронизация задач плана с SQLite-таблицей `tasks`.
  * Экспорт планов в Markdown/Excel и отображение на дашборде.