📂 Центр документации (Русский)
Добро пожаловать в концептуальную документацию codex-bot. Этот раздел объясняет «Почему» и «Как» устроена архитектура фреймворка, помогая понять логику проектных решений.
🗺️ Карта архитектуры
| Раздел | Описание |
|---|---|
| 📦 Base | Базовые DTO и абстрактный Оркестратор. |
| 🧭 Director | Координатор межфичевых переходов. |
| ⚙️ Engine | Сборка роутеров, автообнаружение и фабрика бота. |
| 🧠 FSM | Управление состоянием и Garbage Collector. |
| 🔄 Redis | Интеграция с Redis Stream и фоновая обработка. |
| 📤 Sender | Доставка и синхронизация UI-сообщений. |
| 🛠️ CLI | Команды генерации (scaffolding) новых фич. |
| ✨ Animation | Анимации ожидания для Telegram UI. |
| 🔗 URL Signer | HMAC-подписанные URL для Mini Apps. |
| 🧰 Helper | Извлечение контекста и вспомогательные утилиты. |
📜 Философия проекта
codex-bot базируется на трех «китах»:
- Feature-based Isolation: Каждая фича — это изолированный модуль со своей логикой, UI и ресурсами.
- Stateless Orchestrators: Оркестраторы не хранят состояние пользователя в
self. Весь контекст передается черезDirector. - UI Persistence: Фреймворк управляет двумя постоянными сообщениями (Menu и Content), чтобы минимизировать «мусор» в чате.
Последнее обновление: 2025-02-07