microdao-daarion/README-ENHANCED-CHAT.md

# 🎉 Розширений чат з оркестраторами - README

**Версія:** 1.0.0  
**Дата:** 2025-11-23

---

## 🚀 Швидкий старт

### 1. Запуск проєкту

```bash
# Встановити залежності (якщо ще не встановлено)
npm install

# Запустити dev сервер
npm run dev

# Відкрити у браузері
http://localhost:8899
```

### 2. Перегляд demo

Відкрити у браузері:
```
http://localhost:8899/chat-demo
```

### 3. Використання у кабінеті мікроДАО

Відкрити будь-який кабінет:
- `http://localhost:8899/microdao/daarion`
- `http://localhost:8899/microdao/greenfood`
- `http://localhost:8899/microdao/energy-union`
- `http://localhost:8899/microdao/yaromir`

У секції "Чат з оркестратором мікроДАО" увімкнути "Розширений режим"

---

## 📦 Що входить?

### Компоненти (8)

1. **MicroDaoOrchestratorChatEnhanced.tsx** - Головний компонент з усіма функціями
2. **MicroDaoOrchestratorChatWrapper.tsx** - Wrapper для вибору версії
3. **MultimodalInput.tsx** - Мультимодальний ввід
4. **KnowledgeBase.tsx** - Управління базою знань
5. **SystemPromptEditor.tsx** - Редагування системного промпту
6. **TelegramIntegration.tsx** - Інтеграція з Telegram

### Сервіси (3)

1. **voiceService.ts** - Голосовий ввід/вивід
2. **webSearchService.ts** - Веб-пошук
3. **knowledgeBaseService.ts** - Робота з базою знань

### Сторінки (1)

1. **ChatDemoPage.tsx** - Demo сторінка з 3 layout варіантами

---

## 🎯 Основні функції

### 🎤 Голосовий ввід
- Натисніть кнопку мікрофона
- Промовте своє повідомлення українською
- Текст автоматично з'явиться у полі вводу

### 🖼️ Завантаження зображень
- Натисніть кнопку зображення
- Виберіть файл або перетягніть (Drag & drop)
- Preview з'явиться перед відправкою

### 📎 Прикріплення файлів
- Натисніть кнопку скріпки
- Виберіть файл (PDF, DOC, DOCX, TXT, MD, JSON)
- Файл буде відправлений разом з повідомленням

### 🌐 Веб-пошук
- Натисніть кнопку глобусу
- Введіть пошуковий запит
- Отримайте результати з інтернету

### 📚 База знань
- Розгорніть секцію "База знань агента"
- Завантажте файли для навчання агента
- Файли автоматично індексуються у Vector + Graph DB

### ⚙️ Системний промпт
- Розгорніть секцію "Системний промпт агента"
- Натисніть "Редагувати"
- Змініть промпт агента
- Натисніть "Зберегти"

### 💬 Telegram
- Розгорніть секцію "Інтеграція з Telegram"
- Створіть бота через @BotFather
- Введіть токен
- Підключіть бота

---

## 📖 Документація

### Основна документація

- **ORCHESTRATOR-CHAT-ENHANCED.md** - Детальний опис всіх компонентів
- **INTEGRATION-EXAMPLE.md** - Приклади інтеграції
- **CHAT-ARCHITECTURE.md** - Архітектура системи
- **FINAL-IMPLEMENTATION-SUMMARY.md** - Фінальний підсумок

### Fixes документація

- **CHAT-MESSAGE-FIX.md** - Виправлення відправки повідомлень
- **TIMEOUT-FIX.md** - Оптимізація таймаутів

---

## 🎨 Layout варіанти (Demo сторінка)

### 1. Tabs Layout
Горизонтальні вкладки з агентами зверху

### 2. Sidebar Layout
Бічна панель з агентами ліворуч, чат праворуч

### 3. Modal Layout
Сітка карток агентів, чат по центру

---

## 🤖 Доступні агенти

### ⚡ Helion
AI-агент платформи Energy Union
- Енергетичні технології
- Токеноміка
- DAO governance

### 🌱 GREENFOOD
AI-ERP для крафтових виробників
- Управління товарами
- Якість та партії
- Логістика та продажі

### 🧙 Yaromir
Оркестратор CrewAI команди
- Стратегічне планування
- Команда з 4 агентів
- Мудрі поради

### ✨ DAARWIZZ
Головний AI-агент DAARION.city
- Загальна інформація
- Маршрутизація запитів
- Навігація по платформі

---

## 🔧 Налаштування

### Environment Variables

```bash
# .env
VITE_NODE1_URL=http://144.76.224.179:9102  # Router URL
VITE_API_URL=http://144.76.224.179:8899     # Backend API URL
```

### Router Configuration

Переконайтеся, що Router (NODE1) працює на порту 9102:
```bash
curl http://144.76.224.179:9102/health
```

---

## 🐛 Troubleshooting

### Проблема: Чат не відповідає

**Перевірте:**
1. Router працює: `curl http://144.76.224.179:9102/health`
2. Ollama працює: `curl http://localhost:11434/api/tags`
3. Консоль браузера (F12) на помилки

**Рішення:**
- Перезавантажити Router: `ssh root@144.76.224.179 "docker restart dagi-router"`
- Перевірити логи: `ssh root@144.76.224.179 "docker logs dagi-router --tail 50"`

### Проблема: Голосовий ввід не працює

**Перевірте:**
1. Браузер підтримує Web Speech API (Chrome, Edge)
2. Дозвіл на мікрофон надано
3. Використовуєте HTTPS або localhost

**Рішення:**
- Дати дозвіл на мікрофон у налаштуваннях браузера
- Використовувати Chrome або Edge

### Проблема: Файли не завантажуються

**Перевірте:**
1. Розмір файлу < 50 МБ
2. Тип файлу підтримується
3. Backend API доступний

**Рішення:**
- Зменшити розмір файлу
- Використовувати підтримувані формати: PDF, DOC, DOCX, TXT, MD, JSON

---

## 💡 Поради

### Для розробників

1. **Використовуйте TypeScript**
   - Всі компоненти повністю типізовані
   - Імпортуйте типи з компонентів

2. **Модульність**
   - Кожен компонент можна використовувати окремо
   - Імпорт через `chat/index.ts`

3. **Services**
   - Використовуйте singleton instances
   - Імпорт через `services/index.ts`

### Для користувачів

1. **Голосовий ввід**
   - Говоріть чітко та повільно
   - Використовуйте паузи між фразами

2. **База знань**
   - Завантажуйте якісні документи
   - Дочекайтеся повної індексації

3. **Системний промпт**
   - Будьте конкретними у інструкціях
   - Включайте контекст та обмеження

---

## 📊 Статус Backend API

### ✅ Готово (Frontend)
- Всі компоненти UI
- Всі сервіси клієнти
- Error handling
- Loading states

### ⏳ В розробці (Backend)
- Knowledge Base API
- System Prompt API
- Telegram API
- Web Search API
- Image Recognition API

---

## 🚀 Наступні версії

### v1.1 (Planned)
- ✅ Voice Output (TTS)
- ✅ Image Recognition
- ✅ Real-time Collaboration

### v1.2 (Planned)
- ✅ Context Memory
- ✅ Multi-language Support
- ✅ Advanced Analytics

### v2.0 (Future)
- ✅ Video Calls
- ✅ Screen Sharing
- ✅ AI Assistants Marketplace

---

## 📞 Контакти та підтримка

### Документація
- GitHub: `/docs`
- README: цей файл
- Detailed Docs: `ORCHESTRATOR-CHAT-ENHANCED.md`

### Issues
- Створюйте issue на GitHub
- Додавайте скріншоти та логи
- Описуйте кроки для відтворення

---

## ✅ Чекліст перед використанням

- [ ] Node.js встановлено
- [ ] Залежності встановлені (`npm install`)
- [ ] `.env` налаштовано
- [ ] Router працює (NODE1)
- [ ] Ollama працює
- [ ] Dev server запущено

---

## 🎉 Готово!

Насолоджуйтесь розширеним чатом з оркестраторами мікроДАО! 🚀

Якщо є питання - дивіться детальну документацію у файлах:
- `ORCHESTRATOR-CHAT-ENHANCED.md`
- `INTEGRATION-EXAMPLE.md`
- `FINAL-IMPLEMENTATION-SUMMARY.md`