scud_ai/docs/development_roadmap.md

🗺️ ДОРОЖНАЯ КАРТА И АРХИТЕКТУРНЫЙ РОАДМАП ПРОЕКТА 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 и отображение на дашборде.

3. Изолированная среда выполнения и песочница кода (Code Execution Sandbox Engine)

• Концепция: Безопасный изолированный Docker-контейнер (или gVisor / Pyodide / nsjail окружение) для динамического выполнения кода, генерируемого моделью в процессе рассуждений и анализа данных.
• Ключевые возможности:
  • Запуск сложных вычислений, агрегаций и статистического анализа данных СКУД на лету (Pandas / NumPy).
  • Выполнение тестовых сценариев и валидация скриптов перед их сохранением/применением на проде.
  • Полная изоляция от хост-системы: read-only доступ к копиям данных, ограничение памяти/CPU (cgroups), отсутствие доступа к чувствительным сетевым интерфейсам.
  • Возврат результатов вычислений (stdout, stderr, артефакты, сгенерированные таблицы/графики) обратно в контекст модели.