feat: добавлены папки legal и docs из ветки private/backup
This commit is contained in:
1195
docs/FAQ.md
Normal file
1195
docs/FAQ.md
Normal file
File diff suppressed because it is too large
Load Diff
386
docs/ai-assistant.md
Normal file
386
docs/ai-assistant.md
Normal file
@@ -0,0 +1,386 @@
|
||||
# AI Ассистент DLE - Полные возможности для бизнеса
|
||||
|
||||
> **Философия**: AI не заменяет людей, а становится их вторым пилотом, высвобождая 85% времени для стратегии и креатива.
|
||||
|
||||
## 📋 Содержание
|
||||
|
||||
1. [Введение](#введение)
|
||||
2. [Технология и архитектура](#технология-и-архитектура)
|
||||
3. [Полные возможности AI ассистента](#полные-возможности-ai-ассистента)
|
||||
4. [Экономический эффект](#экономический-эффект)
|
||||
5. [Настройка и интеграция](#настройка-и-интеграция)
|
||||
|
||||
---
|
||||
|
||||
## Введение
|
||||
|
||||
### Что такое AI Ассистент в DLE?
|
||||
|
||||
**AI Ассистент** - это встроенный интеллектуальный помощник, который использует:
|
||||
- 🧠 **Ollama** - локальные open-source модели AI (qwen2.5:7b)
|
||||
- 🔍 **Векторный поиск** - FAISS для семантического поиска
|
||||
- 📚 **RAG** (Retrieval-Augmented Generation) - поиск по базе знаний
|
||||
- 💾 **Кэширование** - мгновенные ответы на частые вопросы
|
||||
|
||||
### Ключевые преимущества
|
||||
|
||||
1. **🏠 100% локальный** - все данные на вашем сервере
|
||||
2. **🔒 Полная конфиденциальность** - ничего не уходит в облако
|
||||
3. **⚡ Молниеносные ответы** - кэширование и векторный поиск
|
||||
4. **💰 Нулевые затраты на API** - нет оплаты за токены
|
||||
5. **📈 Обучается на ваших данных** - персонализированные ответы
|
||||
6. **🌍 Многоязычный** - поддержка русского, английского и др.
|
||||
7. **🔄 24/7 доступность** - работает круглосуточно
|
||||
|
||||
---
|
||||
|
||||
## Технология и архитектура
|
||||
|
||||
### Как это работает?
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ Архитектура AI Ассистента │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 1. Пользователь задает вопрос │
|
||||
│ "Как вернуть товар?" │
|
||||
└────────────────┬────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 2. Векторизация вопроса │
|
||||
│ Ollama mxbai-embed-large:latest │
|
||||
│ Текст → Вектор [768 чисел] │
|
||||
└────────────────┬────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 3. Векторный поиск (FAISS) │
|
||||
│ Поиск похожих вопросов в базе │
|
||||
│ Top-3 результата по семантике │
|
||||
└────────────────┬────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 4. Контекстный поиск (RAG) │
|
||||
│ Извлечение ответов из базы знаний │
|
||||
│ Фильтрация по тегам/продуктам │
|
||||
└────────────────┬────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 5. Генерация ответа (LLM) │
|
||||
│ Ollama qwen2.5:7b │
|
||||
│ Контекст + Вопрос → Ответ │
|
||||
└────────────────┬────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 6. Кэширование │
|
||||
│ Сохранение в кэш на 1 час │
|
||||
│ Следующий такой же вопрос < 50ms │
|
||||
└────────────────┬────────────────────────┘
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 7. Ответ пользователю │
|
||||
│ "Товар можно вернуть в течение..." │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Технологический стек
|
||||
|
||||
| Компонент | Технология | Назначение |
|
||||
|-----------|------------|------------|
|
||||
| **LLM модель** | Ollama qwen2.5:7b | Генерация текста, диалог |
|
||||
| **Embedding модель** | mxbai-embed-large | Векторизация текста |
|
||||
| **Векторная БД** | FAISS | Быстрый семантический поиск |
|
||||
| **Основная БД** | PostgreSQL | Хранение базы знаний |
|
||||
| **Кэш** | Node.js Map + TTL | Ускорение повторных запросов |
|
||||
| **Очередь** | AI Queue | Обработка задач по приоритету |
|
||||
|
||||
---
|
||||
|
||||
## Полные возможности AI ассистента
|
||||
|
||||
### 1. 📞 Клиентский сервис и поддержка
|
||||
|
||||
**Автоматические ответы на типовые вопросы:**
|
||||
- Мгновенные ответы 24/7 через Telegram, Email, Web чат
|
||||
- Автоматическая диагностика проблем по номеру заказа
|
||||
- Создание тикетов в CRM с приоритизацией
|
||||
- База знаний с векторным поиском
|
||||
- Многоязычная поддержка клиентов из разных стран
|
||||
- Анализ настроения клиентов в реальном времени
|
||||
- Эскалация сложных вопросов к живым операторам
|
||||
- Персонализированные рекомендации на основе истории покупок
|
||||
|
||||
**Интеграция с мессенджерами:**
|
||||
- Telegram бот с AI-ассистентом
|
||||
- Email поддержка с автоматическим анализом
|
||||
- Web чат на сайте с умным виджетом
|
||||
- SMS рассылки и уведомления
|
||||
- Веб-формы обратной связи
|
||||
|
||||
### 2. 📊 Аналитика и бизнес-интеллект
|
||||
|
||||
**Автоматический анализ данных:**
|
||||
- Анализ больших данных и выявление трендов
|
||||
- Прогнозирование продаж и спроса на товары/услуги
|
||||
- Сегментация клиентов по поведению и предпочтениям
|
||||
- Анализ эффективности маркетинговых кампаний
|
||||
- Выявление аномалий в финансовых показателях
|
||||
- Создание интерактивных дашбордов с ключевыми метриками
|
||||
- Сравнительный анализ с конкурентами
|
||||
- Бенчмаркинг и отраслевые сравнения
|
||||
|
||||
### 3. 💰 Финансовое планирование и учет
|
||||
|
||||
**Автоматизация финансовых процессов:**
|
||||
- Автоматическое ведение бухгалтерии и формирование отчетов
|
||||
- Прогнозирование денежных потоков и планирование бюджета
|
||||
- Анализ рентабельности продуктов и услуг
|
||||
- Выявление финансовых рисков и рекомендации по их снижению
|
||||
- Автоматическое создание инвойсов и отслеживание платежей
|
||||
- Оптимизация налогового планирования
|
||||
- Мониторинг KPI и финансовых показателей
|
||||
- Консолидированная отчетность по всем подразделениям
|
||||
|
||||
### 4. 🎯 Маркетинг и продажи
|
||||
|
||||
**Контент-маркетинг:**
|
||||
- Генерация контента для социальных сетей, блогов, email-рассылок
|
||||
- Персонализация маркетинговых сообщений для каждого клиента
|
||||
- A/B тестирование различных вариантов рекламы
|
||||
- Анализ эффективности каналов привлечения клиентов
|
||||
- Автоматическое создание email-кампаний
|
||||
- SEO-оптимизация контента и мета-тегов
|
||||
- Управление репутацией в интернете
|
||||
|
||||
**Продажи:**
|
||||
- Автоматическое создание коммерческих предложений
|
||||
- Анализ клиентской базы и выявление возможностей
|
||||
- Персонализированные рекомендации по продуктам
|
||||
- Автоматическое отслеживание воронки продаж
|
||||
- Генерация скриптов для холодных звонков
|
||||
|
||||
### 5. 👥 HR и управление персоналом
|
||||
|
||||
**Подбор и управление персоналом:**
|
||||
- Автоматический скрининг резюме и первичный отбор кандидатов
|
||||
- Проведение собеседований с помощью чат-бота
|
||||
- Анализ производительности сотрудников
|
||||
- Планирование обучения и развития персонала
|
||||
- Автоматическое создание должностных инструкций
|
||||
- Анализ удовлетворенности сотрудников
|
||||
- Планирование отпусков и смен
|
||||
- Мониторинг настроения команды
|
||||
|
||||
**Обучение персонала:**
|
||||
- Персонализированные программы обучения для сотрудников
|
||||
- Создание интерактивных курсов и материалов
|
||||
- Адаптивное обучение под индивидуальные потребности
|
||||
- Оценка знаний и навыков персонала
|
||||
- Рекомендации по развитию карьеры
|
||||
- Создание базы знаний и FAQ
|
||||
|
||||
### 6. 📋 Управление проектами и задачами
|
||||
|
||||
**Автоматизация проектной работы:**
|
||||
- Автоматическое планирование проектов и распределение ресурсов
|
||||
- Отслеживание прогресса и выявление задержек
|
||||
- Оптимизация рабочих процессов и устранение узких мест
|
||||
- Автоматическое создание отчетов по проектам
|
||||
- Управление рисками и планирование резервов
|
||||
- Координация работы распределенных команд
|
||||
- Анализ эффективности методологий управления
|
||||
|
||||
### 7. 🔍 Исследования и разработка
|
||||
|
||||
**Аналитика и исследования:**
|
||||
- Анализ рынка и конкурентной среды
|
||||
- Исследование новых технологий и трендов
|
||||
- Генерация идей для новых продуктов/услуг
|
||||
- Анализ патентов и интеллектуальной собственности
|
||||
- Техническая документация и спецификации
|
||||
- Анализ обратной связи клиентов для улучшения продуктов
|
||||
|
||||
### 8. 🛡️ Безопасность и комплаенс
|
||||
|
||||
**Мониторинг безопасности:**
|
||||
- Мониторинг безопасности IT-систем
|
||||
- Выявление подозрительной активности и угроз
|
||||
- Автоматическое обновление политик безопасности
|
||||
- Анализ соответствия регулятивным требованиям
|
||||
- Управление доступом и правами пользователей
|
||||
- Аудит логов и расследование инцидентов
|
||||
|
||||
### 9. 📈 Операционная эффективность
|
||||
|
||||
**Оптимизация процессов:**
|
||||
- Оптимизация цепочек поставок и логистики
|
||||
- Планирование производства и управление запасами
|
||||
- Автоматизация рутинных процессов
|
||||
- Анализ качества продукции и услуг
|
||||
- Управление активами и техническое обслуживание
|
||||
- Оптимизация энергопотребления и ресурсов
|
||||
|
||||
### 10. 🎓 Обучение и развитие
|
||||
|
||||
**Корпоративное обучение:**
|
||||
- Персонализированные программы обучения для сотрудников
|
||||
- Создание интерактивных курсов и материалов
|
||||
- Адаптивное обучение под индивидуальные потребности
|
||||
- Оценка знаний и навыков персонала
|
||||
- Рекомендации по развитию карьеры
|
||||
- Создание базы знаний и FAQ
|
||||
|
||||
### 11. 🌐 Международная деятельность
|
||||
|
||||
**Глобальные возможности:**
|
||||
- Автоматический перевод документов и коммуникаций
|
||||
- Анализ культурных особенностей целевых рынков
|
||||
- Адаптация контента под локальные требования
|
||||
- Мониторинг изменений в международном законодательстве
|
||||
- Управление валютными рисками
|
||||
- Координация работы с зарубежными партнерами
|
||||
|
||||
### 12. 🔮 Стратегическое планирование
|
||||
|
||||
**Долгосрочное планирование:**
|
||||
- Анализ макроэкономических трендов и их влияния на бизнес
|
||||
- Сценарное планирование для различных ситуаций
|
||||
- Анализ возможностей для слияний и поглощений
|
||||
- Оценка инвестиционных проектов
|
||||
- Планирование выхода на новые рынки
|
||||
- Разработка долгосрочных стратегий развития
|
||||
|
||||
### 13. 📱 Мобильные и цифровые решения
|
||||
|
||||
**Цифровая трансформация:**
|
||||
- Разработка мобильных приложений с ИИ-функциями
|
||||
- Создание чат-ботов для различных платформ
|
||||
- Голосовые ассистенты для бизнес-процессов
|
||||
- Интеграция с IoT устройствами
|
||||
- Автоматизация социальных сетей
|
||||
- Создание виртуальных ассистентов
|
||||
|
||||
### 14. 🏭 Отраслевые решения
|
||||
|
||||
**Специализированные решения:**
|
||||
- **Здравоохранение**: диагностика, планирование лечения, управление пациентами
|
||||
- **Финансы**: кредитный скоринг, управление рисками, торговые алгоритмы
|
||||
- **Ритейл**: персонализация, управление запасами, ценообразование
|
||||
- **Производство**: контроль качества, предиктивное обслуживание, оптимизация
|
||||
- **Недвижимость**: оценка, анализ рынка, управление объектами
|
||||
- **Образование**: адаптивное обучение, оценка знаний, планирование
|
||||
|
||||
### 15. 🔄 Интеграция и автоматизация
|
||||
|
||||
**Системная интеграция:**
|
||||
- API-интеграции с внешними системами
|
||||
- Автоматизация рабочих процессов (RPA)
|
||||
- Синхронизация данных между различными платформами
|
||||
- Создание единой экосистемы для всех бизнес-процессов
|
||||
- Миграция данных и систем
|
||||
- Мониторинг производительности интегрированных решений
|
||||
|
||||
---
|
||||
|
||||
## Экономический эффект
|
||||
|
||||
### Сравнение с облачными решениями
|
||||
|
||||
| Характеристика | DLE AI (Локальный) | ChatGPT API | Claude API |
|
||||
|----------------|-------------------|-------------|------------|
|
||||
| **Стоимость** | $0 | ~$0.02/запрос | ~$0.03/запрос |
|
||||
| **Конфиденциальность** | ✅ 100% | ❌ Данные в OpenAI | ❌ Данные в Anthropic |
|
||||
| **Скорость (кэш)** | 50ms | 500-2000ms | 500-2000ms |
|
||||
| **Offline работа** | ✅ Да | ❌ Нет | ❌ Нет |
|
||||
| **Настройка под бизнес** | ✅ Полная | ⚠️ Ограниченная | ⚠️ Ограниченная |
|
||||
| **Лимиты API** | ❌ Нет | ✅ Есть | ✅ Есть |
|
||||
|
||||
### Экономия при использовании облачных API
|
||||
|
||||
**При 10,000 запросов в месяц:**
|
||||
- ChatGPT API: $200/месяц = **$2,400/год**
|
||||
- Claude API: $300/месяц = **$3,600/год**
|
||||
- DLE AI: **$0/год** ✅
|
||||
|
||||
**При 50,000 запросов в месяц:**
|
||||
- ChatGPT API: $1,000/месяц = **$12,000/год**
|
||||
- Claude API: $1,500/месяц = **$18,000/год**
|
||||
- DLE AI: **$0/год** ✅
|
||||
|
||||
**При 100,000 запросов в месяц:**
|
||||
- ChatGPT API: $2,000/месяц = **$24,000/год**
|
||||
- Claude API: $3,000/месяц = **$36,000/год**
|
||||
- DLE AI: **$0/год** ✅
|
||||
|
||||
### Суммарная экономия по всем направлениям
|
||||
|
||||
| Направление | Экономия в год | ROI |
|
||||
|-------------|----------------|-----|
|
||||
| **Обслуживание клиентов** | $57,600 | 5,760% |
|
||||
| **Работа с поставщиками + AI закупщик** | $64,800 | 6,480% |
|
||||
| **Работа с партнерами** | $43,200 | 4,320% |
|
||||
| **Обучение персонала** | $30,000 | 3,000% |
|
||||
| **Управление персоналом** | $57,600 | 5,760% |
|
||||
| **Отчетность и анализ** | $144,000 | 14,400% |
|
||||
| **Контент-маркетинг** | $86,400 | 8,640% |
|
||||
| **Экономия на API токенах** | $24,000-36,000 | 2,400-3,600% |
|
||||
| **ИТОГО:** | **$507,600-519,600** | **50,760-51,960%** |
|
||||
|
||||
**Стоимость внедрения DLE**: $1,000 (единоразово, Standard Support)
|
||||
**ROI**: 50,760-51,960% или **507-519x окупаемость**
|
||||
|
||||
### Дополнительные выгоды
|
||||
|
||||
**Неизмеримые преимущества:**
|
||||
- 📈 Повышение качества работы
|
||||
- 😊 Удовлетворенность клиентов +19%
|
||||
- 👥 Удержание сотрудников +15%
|
||||
- 🚀 Скорость принятия решений +300%
|
||||
- 💡 Больше времени на стратегию
|
||||
- 🎯 Меньше рутины, больше креатива
|
||||
|
||||
---
|
||||
|
||||
## Настройка и интеграция
|
||||
|
||||
**Что нужно для запуска:**
|
||||
- ✅ Установить DLE (см. [Инструкцию по установке](./setup-instruction.md))
|
||||
- ✅ Запустить Ollama и установить модели
|
||||
- ✅ Создать базу знаний (FAQ, поставщики, HR)
|
||||
- ✅ Настроить AI ассистента под ваш бизнес
|
||||
- ✅ Интегрировать с Telegram/Email (опционально)
|
||||
|
||||
**Время настройки:**
|
||||
- 🚀 **Быстрый старт**: 20-30 минут (базовый FAQ)
|
||||
- ⚙️ **Полная настройка**: 1-2 часа (все возможности)
|
||||
|
||||
**Результат:**
|
||||
- 🤖 Работающий AI ассистент 24/7
|
||||
- 📚 База знаний для ответов клиентам
|
||||
- 🔍 Векторный поиск по вашим данным
|
||||
- 💰 Экономия до $519,600/год
|
||||
|
||||
### Следующие шаги
|
||||
|
||||
1. 📖 [Установите DLE](./setup-instruction.md)
|
||||
2. 🤖 [Настройте AI ассистента](./setup-ai-assistant.md)
|
||||
3. 📚 Загрузите базу знаний
|
||||
4. 🚀 Начните экономить время и деньги!
|
||||
|
||||
---
|
||||
|
||||
## Поддержка
|
||||
|
||||
**Нужна помощь с настройкой AI?**
|
||||
|
||||
📧 **Email**: info@hb3-accelerator.com
|
||||
💬 **Чат**: https://hb3-accelerator.com
|
||||
📚 **Документация**: [FAQ](./FAQ.md)
|
||||
🎓 **Обучение**: Онлайн-сессии для токен-холдеров
|
||||
|
||||
---
|
||||
|
||||
**© 2024-2025 Тарабанов Александр Викторович. Все права защищены.**
|
||||
|
||||
**Последнее обновление**: October 2025
|
||||
332
docs/application-description.md
Normal file
332
docs/application-description.md
Normal file
@@ -0,0 +1,332 @@
|
||||
# Digital Legal Entity (DLE) - Веб-приложение для управления бизнесом
|
||||
|
||||
> **Полный контроль. Нулевая абонентская плата. AI экономит $507,600-519,600/год.**
|
||||
|
||||
---
|
||||
|
||||
## 📋 Содержание
|
||||
|
||||
1. [Для кого это приложение](#для-кого-это-приложение)
|
||||
2. [Ключевые преимущества](#ключевые-преимущества)
|
||||
3. [Основные возможности](#основные-возможности)
|
||||
4. [Экономический эффект](#экономический-эффект)
|
||||
5. [Технические детали](#технические-детали)
|
||||
6. [Условия приобретения](#условия-приобретения)
|
||||
7. [Дополнительная документация](#дополнительная-документация)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Для кого это приложение
|
||||
|
||||
DLE создано для **всех типов организаций**, нуждающихся в прозрачном коллективном управлении:
|
||||
|
||||
- **Коммерческие организации** (ООО, АО, ИП, холдинги)
|
||||
- **Некоммерческие организации** (НКО, фонды, ассоциации)
|
||||
- **Государственные структуры** (муниципалитеты, ведомства)
|
||||
- **Инвестиционные фонды** и **венчурные компании**
|
||||
- **Стартапы** и **малый бизнес**
|
||||
- **Кооперативы** и **объединения**
|
||||
|
||||
---
|
||||
|
||||
## 💎 Ключевые преимущества
|
||||
|
||||
### Почему DLE, а не SaaS?
|
||||
|
||||
| Параметр | DLE | Обычные SaaS |
|
||||
|----------|-----|--------------|
|
||||
| **💰 Стоимость** | $1,000 один раз | $200-500/месяц |
|
||||
| **📊 Владение данными** | 100% ваши | У провайдера |
|
||||
| **🔧 Кастомизация** | Полная | Ограниченная |
|
||||
| **🌍 Соответствие законам** | Под ваш регион | Зависит от провайдера |
|
||||
| **🛡️ Соответствие регуляторам** | GDPR, CCPA, 152-ФЗ | Ограниченное |
|
||||
| **🤖 AI без лимитов** | Бесплатно | $200+/месяц |
|
||||
| **🔗 Блокчейн** | Встроен | Нет или доп. плата |
|
||||
| **⚡ Обновления** | Бесплатно 5 лет (для держателей токенов) | Зависит от тарифа |
|
||||
|
||||
### 🎁 Что вы получаете
|
||||
|
||||
✅ **Бессрочная лицензия** - платите один раз, используйте вечно
|
||||
✅ **Бесплатные обновления** - все улучшения без доп. платы
|
||||
✅ **Полный исходный код** - полная прозрачность
|
||||
✅ **AI на своем сервере** - 100% конфиденциальность
|
||||
✅ **Блокчейн-защита** - активы невозможно украсть
|
||||
✅ **Токенизация активов** - экономия 99% на сделках
|
||||
✅ **Право голоса** - влияние на развитие продукта
|
||||
✅ **Готовый пакет документов для регулятора** - политика конфиденциальности, согласие на обработку ПД, пользовательское соглашение, политика cookies
|
||||
✅ **Гарантия возврата 70%** - в течение 5 лет при отсутствии обновлений
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Основные возможности
|
||||
|
||||
### 1. CRM и управление контактами
|
||||
|
||||
**Полноценная система управления клиентами**:
|
||||
- Централизованная база контактов с историей взаимодействий
|
||||
- Группировка по тегам и категориям
|
||||
- Система задач и напоминаний
|
||||
- Импорт из CSV, Excel, внешних CRM
|
||||
- Экспорт в различных форматах
|
||||
- Конструктор документов и шаблонов
|
||||
|
||||
### 2. AI ассистент с векторным поиском
|
||||
|
||||
**Локальный AI на вашем сервере**:
|
||||
- Ollama + Vector Search (RAG)
|
||||
- Модель qwen2.5:7b (или любая другая)
|
||||
- 100% конфиденциальность (данные не уходят наружу)
|
||||
- Нулевые затраты на API токены
|
||||
|
||||
**Ключевые возможности**:
|
||||
- **📞 Обслуживание клиентов** - ответы 24/7, анализ настроения клиентов
|
||||
- **📊 Аналитика и бизнес-интеллект** - анализ данных, прогнозирование продаж
|
||||
- **💰 Финансовое планирование** - автоматическая бухгалтерия, анализ рентабельности
|
||||
- **🎯 Маркетинг и продажи** - генерация контента, персонализация сообщений
|
||||
- **👥 HR и управление персоналом** - скрининг резюме, планирование обучения
|
||||
- **📋 Управление проектами** - автоматическое планирование, отслеживание прогресса
|
||||
- **🔍 Исследования и разработка** - анализ рынка, генерация идей
|
||||
- **🛡️ Безопасность и комплаенс** - мониторинг безопасности, анализ соответствия
|
||||
- **📈 Операционная эффективность** - оптимизация процессов, автоматизация
|
||||
- **🎓 Обучение и развитие** - персонализированные программы обучения
|
||||
- **🌐 Международная деятельность** - автоматический перевод, адаптация контента
|
||||
- **🔮 Стратегическое планирование** - анализ трендов, сценарное планирование
|
||||
- **📱 Мобильные решения** - разработка приложений, создание чат-ботов
|
||||
- **🏭 Отраслевые решения** - специализированные решения для разных отраслей
|
||||
- **🔄 Интеграция и автоматизация** - API-интеграции, автоматизация процессов
|
||||
|
||||
**Экономический эффект**: $507,600-519,600/год при ROI 50,760-51,960%
|
||||
|
||||
> 💡 **Подробная информация**: См. [AI Ассистент - полное описание](./ai-assistant.md) - там детально описаны все возможности, кейсы применения, архитектура работы и расчеты экономии.
|
||||
|
||||
### 3. Омниканальные коммуникации
|
||||
|
||||
**Единый интерфейс для всех каналов**:
|
||||
- 💬 Telegram бот, 📧 Email, 🌐 Web чат, 📱 SMS, 📋 Веб-формы
|
||||
- Один контекст для клиента на всех каналах
|
||||
- AI автоответы с обучением на ваших данных
|
||||
- Аналитика по каналам и времени ответа
|
||||
|
||||
### 4. Блокчейн-управление и токенизация
|
||||
|
||||
**Смарт-контракты для бизнеса**:
|
||||
- Токенизация любых активов (недвижимость, IP, акции)
|
||||
- Управление через голосование токен-холдеров
|
||||
- Мультичейн поддержка (7+ сетей: Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base)
|
||||
- Прозрачность всех операций на блокчейне
|
||||
|
||||
> 💡 **Подробная информация**: См. [Блокчейн для бизнеса](./blockchain-for-business.md) - практические кейсы использования и [Техническая документация по блокчейну](./blockchain-integration-technical.md) - для разработчиков.
|
||||
|
||||
### 5. Группы и пространства для команд
|
||||
|
||||
- Настраиваемые пространства для проектов
|
||||
- Детальная система разрешений (20+ типов)
|
||||
- Роли: Editor, ReadOnly, User
|
||||
- Интеграция с CRM и коммуникациями
|
||||
|
||||
### 6. Внутренние инструменты
|
||||
|
||||
- Электронные таблицы (аналог Excel)
|
||||
- Система аналитики и отчетов
|
||||
- Мониторинг метрик
|
||||
- WebSSH для управления серверами
|
||||
|
||||
### 7. Безопасность и защита
|
||||
|
||||
**Многоуровневая защита DLE**:
|
||||
- **Сетевая безопасность** - TLS 1.3, HTTPS, DDoS защита
|
||||
- **Аутентификация** - SIWE (вход через кошелек), сессии в БД
|
||||
- **Авторизация** - детальные разрешения (20+ типов), токен-гейтинг
|
||||
- **Защита данных** - AES-256 шифрование, защита от SQL-инъекций
|
||||
- **Блокчейн-защита** - токены нельзя украсть без голосования
|
||||
- **Мониторинг** - логирование, алерты, audit trail
|
||||
|
||||
**Соответствие требованиям регуляторов**:
|
||||
- **GDPR** - соответствие европейским требованиям по защите персональных данных
|
||||
- **CCPA** - соответствие калифорнийским требованиям
|
||||
- **Российское законодательство** - соответствие 152-ФЗ "О персональных данных"
|
||||
- **Локальное хранение** - все данные остаются на вашем сервере
|
||||
- **Прозрачность** - полный контроль над обработкой персональных данных
|
||||
|
||||
> 💡 **Подробная информация**: См. [Безопасность DLE](./security.md) - там детально описаны все уровни защиты, сценарии атак, рекомендации по безопасности и соответствие регуляторным требованиям.
|
||||
|
||||
## 💰 Экономический эффект
|
||||
|
||||
### Сравнение с SaaS за 5 лет
|
||||
|
||||
**Типичный стек SaaS**:
|
||||
```
|
||||
CRM (HubSpot): $200/мес × 60 мес = $12,000
|
||||
Чат-бот (Intercom): $150/мес × 60 мес = $9,000
|
||||
Email (SendGrid): $100/мес × 60 мес = $6,000
|
||||
AI (ChatGPT API): $200/мес × 60 мес = $12,000
|
||||
─────────────────────────────
|
||||
ИТОГО: $39,000
|
||||
```
|
||||
|
||||
**DLE**:
|
||||
```
|
||||
Лицензия (один раз): $1,000
|
||||
Обновления (5 лет): $0
|
||||
AI без лимитов: $0
|
||||
─────────────────────────────
|
||||
ИТОГО: $1,000
|
||||
|
||||
ЭКОНОМИЯ: $38,000
|
||||
```
|
||||
|
||||
### ROI от AI ассистента
|
||||
|
||||
**Сравнение с облачными решениями**:
|
||||
|
||||
| Характеристика | DLE AI (Локальный) | ChatGPT API | Claude API |
|
||||
|----------------|-------------------|-------------|------------|
|
||||
| **Стоимость** | $0 | ~$0.02/запрос | ~$0.03/запрос |
|
||||
| **Конфиденциальность** | ✅ 100% | ❌ Данные в OpenAI | ❌ Данные в Anthropic |
|
||||
| **Скорость (кэш)** | 50ms | 500-2000ms | 500-2000ms |
|
||||
| **Offline работа** | ✅ Да | ❌ Нет | ❌ Нет |
|
||||
| **Настройка под бизнес** | ✅ Полная | ⚠️ Ограниченная | ⚠️ Ограниченная |
|
||||
| **Лимиты API** | ❌ Нет | ✅ Есть | ✅ Есть |
|
||||
|
||||
**Суммарная экономия по всем направлениям**:
|
||||
- Обслуживание клиентов: $57,600
|
||||
- Работа с поставщиками + AI закупщик: $64,800
|
||||
- Работа с партнерами: $43,200
|
||||
- Обучение персонала: $30,000
|
||||
- Управление персоналом: $57,600
|
||||
- Отчетность и анализ: $144,000
|
||||
- Контент-маркетинг: $86,400
|
||||
- Экономия на API токенах: $24,000-36,000
|
||||
- **ИТОГО**: $507,600-519,600/год
|
||||
|
||||
**Инвестиция**: $1,000
|
||||
**ROI**: 50,760-51,960% или 507-519x окупаемость ✅
|
||||
|
||||
### Экономия на токенизации активов
|
||||
|
||||
**Традиционная сделка с недвижимостью ($1M)**:
|
||||
- Комиссия риелтора: 3-5% = $30,000-50,000
|
||||
- Юридические услуги: $5,000-10,000
|
||||
- Регистрация права: $2,000-5,000
|
||||
- Время: 2-6 месяцев
|
||||
- **Итого**: $37,000-65,000
|
||||
|
||||
**Токенизированная сделка через DLE**:
|
||||
- Gas fees: $50-200
|
||||
- Смарт-контракт (один раз): $500
|
||||
- Время: 5-10 минут
|
||||
- **Итого**: $550-700
|
||||
|
||||
**Экономия**: 99% затрат и 99% времени ✅
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Технические детали
|
||||
|
||||
### Архитектура
|
||||
|
||||
**Современный технологический стек**:
|
||||
- **Frontend**: Vue.js 3 + Vite + Element Plus
|
||||
- **Backend**: Node.js + Express
|
||||
- **База данных**: PostgreSQL + pgvector
|
||||
- **AI**: Ollama (qwen2.5:7b) + FAISS Vector Search
|
||||
- **Блокчейн**: Ethers.js v6 + Hardhat
|
||||
- **Контейнеризация**: Docker Compose
|
||||
|
||||
### Принципы проектирования
|
||||
|
||||
✅ **Микросервисная архитектура** - легко масштабировать
|
||||
✅ **Полный контроль** - вы владеете приложением и данными
|
||||
✅ **Модульность** - добавляйте новые функции через модули
|
||||
✅ **Безопасность** - многоуровневая защита (TLS, AES-256, CSRF)
|
||||
✅ **API-first** - REST + WebSocket для интеграций
|
||||
|
||||
### Развертывание
|
||||
|
||||
**Гибкие варианты установки**:
|
||||
- **На своем сервере** - полный контроль
|
||||
- **В облаке** - AWS, Google Cloud, Azure
|
||||
- **На локальной инфраструктуре** - соответствие регуляторным требованиям
|
||||
- **Docker Compose** - развертывание одной командой
|
||||
|
||||
**Минимальные требования**:
|
||||
- **CPU**: 4 ядра
|
||||
- **RAM**: 12 GB (4 GB приложение + 6 GB AI + 2 GB Vector Search)
|
||||
- **Хранилище**: 100 GB SSD
|
||||
- **ОС**: Ubuntu 20.04+, Debian 11+, CentOS 8+, любая Linux с Docker
|
||||
|
||||
> 💡 **Подробная информация**: См. [Инструкция по установке](./setup-instruction.md) - пошаговая настройка и [Настройка AI ассистента](./setup-ai-assistant.md) - специализированная установка.
|
||||
|
||||
---
|
||||
|
||||
## 💳 Условия приобретения
|
||||
|
||||
> 💡 **Подробная информация**: См. [Условия обслуживания](./service-terms.md) - там детально описаны лицензионная модель, тарифы, гарантии и процесс приобретения.
|
||||
|
||||
### Краткий обзор
|
||||
|
||||
**Бессрочная лицензия (Perpetual License)**:
|
||||
- 💰 **Платите один раз** - используйте вечно
|
||||
- 📄 **Полный исходный код** с документацией
|
||||
- 🔄 **Бесплатные обновления** 5 лет для держателей лицензионных токенов (см. [legal/service-terms.md](../legal/service-terms.md))
|
||||
- 🗳️ **Право голоса** за развитие продукта
|
||||
|
||||
**Тарифы**:
|
||||
| Пакет | Цена | Голоса | Поддержка |
|
||||
|-------|------|--------|-----------|
|
||||
| **Standard Support** | $1,000 USDT | 1 голос | чат 24/7 |
|
||||
| **Priority Support** | $10,000 USDT | 10 голосов | чат 24/7 |
|
||||
|
||||
**Что включено**:
|
||||
✅ Бессрочная лицензия на использование
|
||||
✅ Исходный код с полной документацией
|
||||
✅ Бесплатные обновления 5 лет для держателей токенов
|
||||
✅ Техническая поддержка
|
||||
✅ Токены управления на блокчейне
|
||||
✅ Готовый пакет документов для регулятора
|
||||
✅ Гарантия возврата 70% в течение 5 лет
|
||||
|
||||
**Как приобрести**:
|
||||
1. Свяжитесь с нами: info@hb3-accelerator.com
|
||||
2. Получите реквизиты для оплаты (USDT)
|
||||
3. Оплатите лицензию
|
||||
4. Получите доступ к коду и токены DLE
|
||||
|
||||
---
|
||||
|
||||
## 📚 Дополнительная документация
|
||||
|
||||
### 🎯 Быстрый старт
|
||||
- 📋 **[FAQ](./FAQ.md)** - ответы на 50+ вопросов (11 разделов)
|
||||
- 🔧 **[Установка](./setup-instruction.md)** - пошаговая настройка за 15 минут
|
||||
- 🤖 **[Настройка AI](./setup-ai-assistant.md)** - запуск AI ассистента
|
||||
|
||||
### 💼 Бизнес и экономика
|
||||
- 💰 **[Блокчейн для бизнеса](./blockchain-for-business.md)** - токенизация активов, экономия 99% на сделках
|
||||
- 🤖 **[AI Ассистент](./ai-assistant.md)** - экономия $507,600-519,600/год, философия "AI+Человек"
|
||||
- 📊 **[Система таблиц](./tables-system.md)** - управление данными и документами
|
||||
|
||||
### 🔧 Техническая документация
|
||||
- 🔗 **[Блокчейн интеграция](./blockchain-integration-technical.md)** - смарт-контракты, API, примеры кода
|
||||
- 🛡️ **[Безопасность](./security.md)** - многоуровневая защита, соответствие GDPR/CCPA/152-ФЗ
|
||||
- ⚖️ **[Условия обслуживания](./service-terms.md)** - лицензирование, поддержка, гарантии
|
||||
|
||||
### 📖 Общая информация
|
||||
- 📖 **[Основной README](../README.md)** - полный список всех документов
|
||||
- ⚖️ **[Юридическая документация](../legal/README.md)** - правовая информация
|
||||
|
||||
### 📞 Поддержка и контакты
|
||||
|
||||
**Основные контакты**:
|
||||
- 📧 **Email**: info@hb3-accelerator.com
|
||||
- 🌐 **Сайт**: https://hb3-accelerator.com
|
||||
- 💬 **Чат поддержки**: https://hb3-accelerator.com/
|
||||
- 🐙 **GitHub**: https://github.com/VC-HB3-Accelerator
|
||||
---
|
||||
|
||||
**© 2024-2025 Тарабанов Александр Викторович. Все права защищены.**
|
||||
|
||||
**Digital Legal Entity (DLE)** - революция в управлении бизнесом через блокчейн и AI.
|
||||
|
||||
**Версия документа**: 2.0.0
|
||||
**Последнее обновление**: October 2025
|
||||
1289
docs/blockchain-for-business.md
Normal file
1289
docs/blockchain-for-business.md
Normal file
File diff suppressed because it is too large
Load Diff
1049
docs/blockchain-integration-technical.md
Normal file
1049
docs/blockchain-integration-technical.md
Normal file
File diff suppressed because it is too large
Load Diff
1309
docs/security.md
Normal file
1309
docs/security.md
Normal file
File diff suppressed because it is too large
Load Diff
42
docs/service-terms.md
Normal file
42
docs/service-terms.md
Normal file
@@ -0,0 +1,42 @@
|
||||
<!--
|
||||
Copyright (c) 2024-2025 Тарабанов Александр Викторович
|
||||
All rights reserved.
|
||||
|
||||
This software is proprietary and confidential.
|
||||
Unauthorized copying, modification, or distribution is prohibited.
|
||||
|
||||
For licensing inquiries: info@hb3-accelerator.com
|
||||
Website: https://hb3-accelerator.com
|
||||
GitHub: https://github.com/VC-HB3-Accelerator
|
||||
-->
|
||||
|
||||
# Условия приобретения и обслуживания Digital Legal Entity — краткое резюме
|
||||
|
||||
> Важно: это краткое резюме условий. Канонический и юридически значимый полный текст находится здесь: [legal/service-terms.md](../legal/service-terms.md).
|
||||
|
||||
Ключевые тезисы:
|
||||
- Тип лицензии: бессрочная (Perpetual), права определяются количеством токенов (1 или 10).
|
||||
- Обновления и базовое обслуживание: бесплатно 5 лет с даты on-chain передачи токена.
|
||||
- Голосование за развитие: 1 токен = 1 голос, решения большинством ≥51%.
|
||||
- Возврат 70% возможен при соблюдении условий программы (см. оригинал).
|
||||
- Поддержка, релизы, база знаний — через приложение `https://hb3-accelerator.com/`.
|
||||
- Полный перечень ограничений/ответственности — в оригинале.
|
||||
|
||||
## 📚 Дополнительная документация
|
||||
|
||||
### Изучите возможности DLE
|
||||
- 🤖 **[AI Ассистент](./ai-assistant.md)** - второй пилот для команды, высвобождает время для стратегии
|
||||
- 💼 **[Блокчейн для бизнеса](./blockchain-for-business.md)** - токенизация активов и решение бизнес-задач
|
||||
- 🛡️ **[Безопасность DLE](./security.md)** - многоуровневая защита вашего бизнеса
|
||||
|
||||
### Техническая документация
|
||||
- 🔗 **[Техническая документация по блокчейну](./blockchain-integration-technical.md)** - для разработчиков
|
||||
- 🔧 **[Инструкция по установке](./setup-instruction.md)** - пошаговая настройка
|
||||
- 📝 **[Описание приложения](./application-description.md)** - обзор функциональности
|
||||
- 📋 **[FAQ](./FAQ.md)** - часто задаваемые вопросы
|
||||
|
||||
### Контакты и поддержка
|
||||
- 📧 **Email**: info@hb3-accelerator.com
|
||||
- 🌐 **Сайт**: https://hb3-accelerator.com
|
||||
- 💬 **Чат поддержки**: https://hb3-accelerator.com/
|
||||
- 🐙 **GitHub**: https://github.com/VC-HB3-Accelerator
|
||||
929
docs/setup-ai-assistant.md
Normal file
929
docs/setup-ai-assistant.md
Normal file
@@ -0,0 +1,929 @@
|
||||
# Инструкция по настройке AI Ассистента с векторным поиском
|
||||
|
||||
## 🤖 Полное руководство по запуску интеллектуального помощника
|
||||
|
||||
Этот документ описывает пошаговый процесс настройки AI ассистента для решения бизнес-задач через электронные таблицы и векторный поиск.
|
||||
|
||||
---
|
||||
|
||||
## 📚 Что вы настроите
|
||||
|
||||
После выполнения инструкции у вас будет:
|
||||
|
||||
✅ Работающий AI ассистент с локальной моделью (Ollama)
|
||||
✅ База знаний для ответов клиентам (FAQ)
|
||||
✅ Автоматизация работы с поставщиками
|
||||
✅ Система обучения персонала
|
||||
✅ Векторный поиск по вашим данным
|
||||
✅ Значительная экономия времени и ресурсов
|
||||
|
||||
> 💡 **Экономический эффект**: См. [AI Ассистент](./ai-assistant.md) - там подробно описаны все возможности и расчеты экономии.
|
||||
|
||||
---
|
||||
|
||||
## ⏱️ Время настройки
|
||||
|
||||
- **Быстрая настройка**: 20-30 минут (базовый FAQ)
|
||||
- **Полная настройка**: 1-2 часа (все возможности)
|
||||
|
||||
---
|
||||
|
||||
## Шаг 1: Установка и запуск Ollama
|
||||
|
||||
### 1.1 Проверка статуса Ollama
|
||||
|
||||
1. Перейдите в **Настройки** → вкладка **Интеграции**
|
||||
2. Найдите блок **"Ollama"** и нажмите **"Подробнее"**
|
||||
3. Проверьте статус подключения:
|
||||
- ✅ **"Ollama is running"** — все готово, переходите к шагу 1.3
|
||||
- ❌ **"Ollama API not responding"** — переходите к шагу 1.2
|
||||
|
||||
### 1.2 Запуск Ollama (если не запущен)
|
||||
|
||||
Если Ollama не запущен, выполните в терминале:
|
||||
|
||||
```bash
|
||||
# Для Docker (рекомендуется)
|
||||
docker-compose up -d ollama
|
||||
|
||||
# Или локально
|
||||
ollama serve
|
||||
```
|
||||
|
||||
Обновите страницу и проверьте статус снова.
|
||||
|
||||
### 1.3 Установка модели для AI
|
||||
|
||||
1. В разделе **Ollama** нажмите **"Установить модель"**
|
||||
2. Выберите модель:
|
||||
- **qwen2.5:7b** (рекомендуется) — для русского языка, 4.7 GB
|
||||
- **llama2:7b** — для английского, 3.8 GB
|
||||
- **mistral:7b** — универсальная, 4.1 GB
|
||||
3. Нажмите **"Установить"**
|
||||
4. Дождитесь завершения загрузки (5-10 минут в зависимости от скорости интернета)
|
||||
|
||||
> 💡 **Подсказка**: Модель скачивается один раз и хранится локально
|
||||
|
||||
### 1.4 Установка Embedding модели
|
||||
|
||||
1. В том же разделе найдите **"Установить Embedding модель"**
|
||||
2. Выберите модель:
|
||||
- **mxbai-embed-large:latest** (рекомендуется) — 670 MB
|
||||
- **nomic-embed-text:latest** — альтернатива, 274 MB
|
||||
3. Нажмите **"Установить"**
|
||||
|
||||
> ⚠️ **Важно**: Embedding модель нужна для векторного поиска (RAG)
|
||||
|
||||
---
|
||||
|
||||
## Шаг 2: Создание базы знаний (электронные таблицы)
|
||||
|
||||
### 2.1 Создание таблицы FAQ
|
||||
|
||||
1. Перейдите в **Таблицы** (в главном меню)
|
||||
2. Нажмите **"+ Создать таблицу"**
|
||||
3. Заполните:
|
||||
- **Название**: `FAQ - Часто задаваемые вопросы`
|
||||
- **Описание**: `База знаний для AI ассистента по работе с клиентами`
|
||||
4. Нажмите **"Создать"**
|
||||
|
||||
### 2.2 Настройка столбцов таблицы
|
||||
|
||||
Добавьте следующие столбцы:
|
||||
|
||||
#### Столбец 1: Вопрос (обязательный для RAG)
|
||||
|
||||
1. Нажмите **"+ Добавить столбец"**
|
||||
2. Заполните:
|
||||
- **Название**: `Вопрос`
|
||||
- **Тип**: `Текст`
|
||||
- **Назначение**: Выберите `Вопрос для AI` ⭐
|
||||
3. Нажмите **"Сохранить"**
|
||||
|
||||
> ⚠️ **Критично**: Обязательно выберите назначение "Вопрос для AI" — это поле будет индексироваться для векторного поиска
|
||||
|
||||
#### Столбец 2: Ответ (обязательный для RAG)
|
||||
|
||||
1. Нажмите **"+ Добавить столбец"**
|
||||
2. Заполните:
|
||||
- **Название**: `Ответ`
|
||||
- **Тип**: `Текст`
|
||||
- **Назначение**: Выберите `Ответ AI` ⭐
|
||||
3. Нажмите **"Сохранить"**
|
||||
|
||||
#### Столбец 3: Продукт (опционально, для фильтрации)
|
||||
|
||||
1. Нажмите **"+ Добавить столбец"**
|
||||
2. Заполните:
|
||||
- **Название**: `Продукт`
|
||||
- **Тип**: `Множественный выбор`
|
||||
- **Варианты**: `Базовый`, `Премиум`, `Корпоративный`
|
||||
- **Назначение**: Выберите `Фильтр по продукту`
|
||||
3. Нажмите **"Сохранить"**
|
||||
|
||||
#### Столбец 4: Теги (опционально, для категоризации)
|
||||
|
||||
1. Нажмите **"+ Добавить столбец"**
|
||||
2. Заполните:
|
||||
- **Название**: `Теги`
|
||||
- **Тип**: `Множественный выбор`
|
||||
- **Варианты**: `Оплата`, `Доставка`, `Возврат`, `Гарантия`, `Техподдержка`
|
||||
- **Назначение**: Выберите `Теги пользователя`
|
||||
3. Нажмите **"Сохранить"**
|
||||
|
||||
#### Столбец 5: Приоритет (опционально)
|
||||
|
||||
1. Нажмите **"+ Добавить столбец"**
|
||||
2. Заполните:
|
||||
- **Название**: `Приоритет`
|
||||
- **Тип**: `Число`
|
||||
- **Назначение**: Выберите `Приоритет`
|
||||
3. Нажмите **"Сохранить"**
|
||||
|
||||
> 💡 **Подсказка**: Вопросы с более высоким приоритетом будут показываться AI первыми
|
||||
|
||||
### 2.3 Заполнение базы знаний
|
||||
|
||||
Добавьте типовые вопросы и ответы:
|
||||
|
||||
**Пример 1: Оплата**
|
||||
|
||||
| Вопрос | Ответ | Продукт | Теги | Приоритет |
|
||||
|--------|-------|---------|------|-----------|
|
||||
| Как оплатить заказ? | Мы принимаем оплату банковской картой, через PayPal, или банковским переводом. Выберите удобный способ при оформлении заказа. | Все | Оплата | 10 |
|
||||
| Можно ли оплатить частями? | Да, для заказов от 50,000₽ доступна рассрочка на 3, 6 или 12 месяцев без переплаты. | Премиум, Корпоративный | Оплата | 8 |
|
||||
|
||||
**Пример 2: Доставка**
|
||||
|
||||
| Вопрос | Ответ | Продукт | Теги | Приоритет |
|
||||
|--------|-------|---------|------|-----------|
|
||||
| Сколько времени занимает доставка? | Стандартная доставка: 3-5 рабочих дней по России. Экспресс-доставка: 1-2 дня в крупных городах. | Все | Доставка | 10 |
|
||||
| Сколько стоит доставка? | Бесплатная доставка при заказе от 5,000₽. Для заказов менее 5,000₽ стоимость доставки 300₽. | Все | Доставка | 9 |
|
||||
|
||||
**Пример 3: Возврат**
|
||||
|
||||
| Вопрос | Ответ | Продукт | Теги | Приоритет |
|
||||
|--------|-------|---------|------|-----------|
|
||||
| Как вернуть товар? | Возврат возможен в течение 14 дней с момента получения. Товар должен быть в оригинальной упаковке, с сохранением товарного вида. Свяжитесь с поддержкой для оформления возврата. | Все | Возврат | 10 |
|
||||
| Когда вернут деньги? | Возврат денежных средств производится в течение 5-10 рабочих дней после получения товара на наш склад. | Все | Возврат | 8 |
|
||||
|
||||
> 💡 **Рекомендация**: Добавьте минимум 20-30 вопросов для качественной работы AI. Чем больше вопросов, тем точнее ответы!
|
||||
|
||||
### 2.4 Активация таблицы как источника для AI
|
||||
|
||||
1. В правом верхнем углу таблицы найдите **⚙️ Настройки таблицы**
|
||||
2. Включите переключатель **"Использовать как источник для AI"** ✅
|
||||
3. Нажмите **"Сохранить"**
|
||||
|
||||
> ✅ **Готово!** Таблица теперь индексируется для векторного поиска
|
||||
|
||||
---
|
||||
|
||||
## Шаг 3: Настройка AI провайдера (Ollama)
|
||||
|
||||
### 3.1 Открытие настроек Ollama
|
||||
|
||||
1. Перейдите в **Настройки** → **Интеграции**
|
||||
2. Найдите блок **"Ollama"** и нажмите **"Подробнее"**
|
||||
|
||||
### 3.2 Проверка Base URL
|
||||
|
||||
1. Проверьте поле **Base URL**:
|
||||
- Для Docker: `http://ollama:11434` ✅
|
||||
- Для локального: `http://localhost:11434`
|
||||
2. Если URL неверный, исправьте и нажмите **"Сохранить"**
|
||||
|
||||
### 3.3 Выбор модели
|
||||
|
||||
1. В поле **"Модель (LLM)"** выберите установленную модель:
|
||||
- `qwen2.5:7b` (рекомендуется для русского)
|
||||
2. В поле **"Embeddings-модель"** выберите:
|
||||
- `mxbai-embed-large:latest`
|
||||
3. Нажмите **"Сохранить"**
|
||||
|
||||
---
|
||||
|
||||
## Шаг 4: Настройка AI Ассистента
|
||||
|
||||
### 4.1 Открытие настроек ассистента
|
||||
|
||||
1. Перейдите в **Настройки** → **Интеграции**
|
||||
2. Найдите блок **"ИИ-ассистент"** и нажмите **"Подробнее"**
|
||||
|
||||
### 4.2 Настройка системного промта
|
||||
|
||||
В поле **"Системный промт"** введите инструкции для AI:
|
||||
|
||||
**Базовый промт (для начала)**:
|
||||
|
||||
```
|
||||
Вы — профессиональный ассистент службы поддержки компании.
|
||||
|
||||
Правила:
|
||||
1. Отвечайте вежливо и профессионально
|
||||
2. Используйте информацию из базы знаний
|
||||
3. Если информации нет — предложите связаться с оператором
|
||||
4. Отвечайте кратко и по существу
|
||||
5. Всегда заканчивайте вопросом "Чем еще могу помочь?"
|
||||
```
|
||||
|
||||
**Продвинутый промт (с персонализацией)**:
|
||||
|
||||
```
|
||||
Вы — профессиональный ассистент службы поддержки компании "Название вашей компании".
|
||||
|
||||
О компании:
|
||||
- Мы занимаемся [краткое описание бизнеса]
|
||||
- Наши ценности: качество, надежность, клиентоориентированность
|
||||
|
||||
Стиль общения:
|
||||
- Дружелюбный, но профессиональный
|
||||
- Обращайтесь к клиенту на "Вы"
|
||||
- Используйте эмодзи умеренно (1-2 на сообщение)
|
||||
|
||||
Правила ответа:
|
||||
1. ОБЯЗАТЕЛЬНО: Отвечайте ТОЛЬКО на русском языке. Все вопросы и ответы должны быть на русском языке
|
||||
2. Сначала ищите ответ в базе знаний (RAG)
|
||||
3. Если нашли — отвечайте на основе найденной информации
|
||||
4. Если не нашли — честно скажите и предложите помощь оператора
|
||||
5. Не придумывайте информацию о ценах, сроках, условиях
|
||||
6. При сложных вопросах предлагайте связаться с менеджером
|
||||
|
||||
Всегда заканчивайте: "Чем еще могу помочь? 😊"
|
||||
```
|
||||
|
||||
### 4.3 Выбор моделей
|
||||
|
||||
1. **LLM-модель**: Выберите `qwen2.5:7b (ollama)`
|
||||
2. **Embedding-модель**: Выберите `mxbai-embed-large:latest (ollama)`
|
||||
|
||||
> 💡 **Подсказка**: Модели автоматически подтянутся из настроек Ollama
|
||||
|
||||
> 📊 **Размер контекстного окна**:
|
||||
> - **Qwen2.5:7b**: Базовый контекст = **32,768 токенов** (~24,000 русских слов)
|
||||
> - Всего данных, отправляемых в модель:
|
||||
> - Системный промпт: ~500-2000 символов (~300-1200 токенов)
|
||||
> - История диалога: до 20 сообщений (~100-500 токенов на сообщение = ~2000-10000 токенов)
|
||||
> - RAG контекст: ~500-2000 токенов (из найденных данных)
|
||||
> - Текущий вопрос: ~50-200 токенов
|
||||
> - **Итого**: примерно 3,000-15,000 токенов (запас достаточен)
|
||||
> - Если нужен больший контекст → используйте Qwen3 с YaRN (до 131K токенов)
|
||||
|
||||
### 4.4 Выбор RAG-таблицы
|
||||
|
||||
1. В поле **"Выбранные RAG-таблицы"** выберите созданную таблицу:
|
||||
- `FAQ - Часто задаваемые вопросы`
|
||||
2. Нажмите **"Сохранить"**
|
||||
|
||||
### 4.5 Настройка правил AI (Rules)
|
||||
|
||||
Создайте набор правил для управления поведением AI:
|
||||
|
||||
1. Нажмите кнопку **"Создать"** рядом с полем "Набор правил"
|
||||
2. В модальном окне заполните:
|
||||
|
||||
**Название**: `Гибридный режим (RAG + генерация)`
|
||||
|
||||
**Описание**: `AI сначала ищет в базе знаний, если не находит — генерирует ответ`
|
||||
|
||||
**Правила (JSON)**:
|
||||
```json
|
||||
{
|
||||
"checkUserTags": true,
|
||||
"searchRagFirst": true,
|
||||
"generateIfNoRag": true,
|
||||
"temperature": 0.7,
|
||||
"maxTokens": 500
|
||||
}
|
||||
```
|
||||
|
||||
3. Нажмите **"Сохранить"**
|
||||
4. Выберите созданное правило в выпадающем списке
|
||||
|
||||
> 💡 **Что означают параметры**:
|
||||
> - `checkUserTags: true` — учитывать теги пользователя при поиске
|
||||
> - `searchRagFirst: true` — сначала искать в базе знаний
|
||||
> - `generateIfNoRag: true` — генерировать ответ, если ничего не найдено
|
||||
> - `temperature: 0.7` — баланс между точностью и креативностью (0.0-1.0)
|
||||
> - `maxTokens: 500` — максимальная длина ответа
|
||||
|
||||
### 4.6 Настройки RAG поиска
|
||||
|
||||
Разверните раздел **"🔍 Настройки RAG поиска"**:
|
||||
|
||||
**Базовые настройки:**
|
||||
1. **Метод поиска**: Выберите `Гибридный поиск` (рекомендуется)
|
||||
2. **Максимальное количество результатов**: `5`
|
||||
3. **Порог релевантности**: `0.1` (от 0.01 до 1.0)
|
||||
|
||||
**Извлечение ключевых слов:**
|
||||
1. ✅ **Включить извлечение ключевых слов**
|
||||
2. **Минимальная длина слова**: `3`
|
||||
3. **Максимальное количество ключевых слов**: `10`
|
||||
4. ✅ **Удалять стоп-слова**
|
||||
|
||||
**Веса поиска (для гибридного):**
|
||||
1. **Семантический поиск**: `70%` (точность)
|
||||
2. **Поиск по ключевым словам**: `30%` (скорость)
|
||||
|
||||
**Дополнительные настройки:**
|
||||
1. ✅ **Нечеткий поиск** (для опечаток)
|
||||
2. ✅ **Стемминг слов** (находит разные формы слова)
|
||||
3. ☐ **Поиск синонимов** (пока отключен)
|
||||
|
||||
### 4.7 Сохранение настроек
|
||||
|
||||
Нажмите кнопку **"Сохранить"** внизу формы.
|
||||
|
||||
---
|
||||
|
||||
## Шаг 5: Тестирование AI Ассистента
|
||||
|
||||
### 5.1 Использование встроенного тестера
|
||||
|
||||
1. На странице настроек AI ассистента прокрутите вниз до блока **"🔍 Мониторинг системы"**
|
||||
2. В разделе **"🧠 Тест RAG-функциональности"**:
|
||||
- Убедитесь, что выбрана таблица `FAQ - Часто задаваемые вопросы`
|
||||
- Введите тестовый вопрос: `Как оплатить заказ?`
|
||||
- Нажмите **"Тестировать RAG"**
|
||||
3. Наблюдайте за процессом:
|
||||
- 🔍 Ищем ответ в базе знаний... (векторный поиск)
|
||||
- 🤖 Генерируем ответ с помощью ИИ... (LLM генерация)
|
||||
- ✅ Готово!
|
||||
4. Проверьте результат:
|
||||
- Должен отобразиться ответ из вашей таблицы
|
||||
- Score (оценка близости): чем ближе к 0, тем лучше
|
||||
|
||||
> 💡 **Хороший Score**: от -300 до 0 (ответ найден)
|
||||
> ⚠️ **Плохой Score**: больше 300 (ответ не найден, AI придумает свой)
|
||||
|
||||
### 5.2 Тестирование через Web Chat
|
||||
|
||||
1. Перейдите на главную страницу приложения
|
||||
2. Найдите виджет **"💬 Чат с AI"** (обычно справа внизу)
|
||||
3. Нажмите на виджет, чтобы открыть чат
|
||||
4. Введите вопрос: `Сколько стоит доставка?`
|
||||
5. Проверьте ответ AI
|
||||
|
||||
**Ожидаемый результат:**
|
||||
```
|
||||
🤖 AI Ассистент:
|
||||
Бесплатная доставка при заказе от 5,000₽.
|
||||
Для заказов менее 5,000₽ стоимость доставки 300₽.
|
||||
|
||||
Чем еще могу помочь? 😊
|
||||
```
|
||||
|
||||
### 5.3 Тестирование разных сценариев
|
||||
|
||||
Попробуйте задать различные вопросы:
|
||||
|
||||
**✅ Вопрос из базы знаний:**
|
||||
```
|
||||
Пользователь: "Как вернуть товар?"
|
||||
AI: [Ответ из таблицы FAQ]
|
||||
```
|
||||
|
||||
**⚠️ Вопрос НЕ из базы знаний:**
|
||||
```
|
||||
Пользователь: "Какая погода сегодня?"
|
||||
AI: "Извините, я специализируюсь на вопросах о нашей компании и продуктах.
|
||||
По вопросам погоды обратитесь к специализированным сервисам.
|
||||
Чем еще могу помочь?"
|
||||
```
|
||||
|
||||
**🎯 Вопрос с опечаткой:**
|
||||
```
|
||||
Пользователь: "Как аплатить заказ?" (опечатка)
|
||||
AI: [Найдет правильный ответ благодаря нечеткому поиску]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Шаг 6: Расширенные возможности (опционально)
|
||||
|
||||
### 6.1 Создание таблицы для работы с поставщиками
|
||||
|
||||
#### Структура таблицы "База поставщиков"
|
||||
|
||||
1. Создайте новую таблицу: `База поставщиков`
|
||||
2. Добавьте столбцы:
|
||||
|
||||
| Столбец | Тип | Описание |
|
||||
|---------|-----|----------|
|
||||
| Название компании | Текст | Наименование поставщика |
|
||||
| Категория товаров | Множественный выбор | Электроника, Мебель, Одежда, и т.д. |
|
||||
| Контактное лицо | Текст | ФИО менеджера |
|
||||
| Email | Текст | Электронная почта |
|
||||
| Телефон | Текст | Контактный телефон |
|
||||
| Цены | Текст | Прайс-лист (краткое описание) |
|
||||
| Условия оплаты | Текст | Отсрочка, предоплата, и т.д. |
|
||||
| Минимальный заказ | Число | Минимальная сумма заказа |
|
||||
| Срок доставки | Текст | Сроки поставки |
|
||||
| Рейтинг | Число | Оценка от 1 до 10 |
|
||||
| Примечания | Текст | Дополнительная информация |
|
||||
|
||||
3. Активируйте как источник для AI
|
||||
4. Заполните данными о ваших поставщиках
|
||||
|
||||
#### Промт для AI закупщика
|
||||
|
||||
Добавьте в системный промт:
|
||||
|
||||
```
|
||||
ДОПОЛНИТЕЛЬНО - Работа с поставщиками:
|
||||
|
||||
Когда пользователь спрашивает о поставщиках:
|
||||
1. Ищите в базе "База поставщиков"
|
||||
2. Фильтруйте по категории товаров
|
||||
3. Сортируйте по рейтингу и условиям
|
||||
4. Предоставьте ТОП-3 рекомендации
|
||||
|
||||
Формат ответа:
|
||||
🏆 TOP-3 поставщика по запросу "[категория]":
|
||||
|
||||
1. [Название] ⭐ [Рейтинг]/10
|
||||
📧 [Email] | 📞 [Телефон]
|
||||
💰 Условия: [Условия оплаты]
|
||||
🚚 Доставка: [Срок доставки]
|
||||
📦 Минимум: [Минимальный заказ]₽
|
||||
|
||||
2. ...
|
||||
3. ...
|
||||
|
||||
Рекомендую связаться с [Название первого поставщика] — лучшие условия.
|
||||
```
|
||||
|
||||
### 6.2 Создание таблицы для обучения персонала
|
||||
|
||||
#### Структура таблицы "База знаний для сотрудников"
|
||||
|
||||
1. Создайте новую таблицу: `База знаний для сотрудников`
|
||||
2. Добавьте столбцы:
|
||||
|
||||
| Столбец | Тип | Описание |
|
||||
|---------|-----|----------|
|
||||
| Вопрос | Текст | Вопрос сотрудника (назначение: Вопрос для AI) |
|
||||
| Ответ | Текст | Подробный ответ (назначение: Ответ AI) |
|
||||
| Категория | Множественный выбор | Продажи, HR, Финансы, IT, Маркетинг |
|
||||
| Отдел | Множественный выбор | Для какого отдела актуально |
|
||||
| Сложность | Число | От 1 (простой) до 5 (сложный) |
|
||||
| Инструкции | Текст | Пошаговые инструкции (если есть) |
|
||||
| Ссылки | Текст | Ссылки на документы/видео |
|
||||
| Дата обновления | Дата | Когда информация обновлялась |
|
||||
|
||||
3. Примеры вопросов:
|
||||
|
||||
**Категория "Продажи":**
|
||||
- "Как оформить возврат клиенту?"
|
||||
- "Какие скидки можно давать постоянным клиентам?"
|
||||
- "Как работать с корпоративными клиентами?"
|
||||
|
||||
**Категория "HR":**
|
||||
- "Как оформить отпуск?"
|
||||
- "Куда обращаться по больничному?"
|
||||
- "Как происходит адаптация новых сотрудников?"
|
||||
|
||||
**Категория "IT":**
|
||||
- "Как получить доступ к корпоративной почте?"
|
||||
- "Что делать при проблемах с VPN?"
|
||||
- "Как создать заявку в техподдержку?"
|
||||
|
||||
### 6.3 Создание связей между таблицами
|
||||
|
||||
#### Пример: Связь "Клиенты" → "Заказы"
|
||||
|
||||
1. Создайте таблицу **"Клиенты"**:
|
||||
- Название, Email, Телефон, Статус (VIP/Обычный)
|
||||
|
||||
2. Создайте таблицу **"Заказы"**:
|
||||
- Номер заказа, Дата, Сумма
|
||||
|
||||
3. В таблице "Заказы" добавьте столбец:
|
||||
- **Название**: `Клиент`
|
||||
- **Тип**: `Связь (Relation)`
|
||||
- **Связанная таблица**: выберите `Клиенты`
|
||||
- **Показывать поле**: выберите `Название`
|
||||
|
||||
4. Добавьте еще один столбец в "Заказы":
|
||||
- **Название**: `Email клиента`
|
||||
- **Тип**: `Lookup (Подстановка)`
|
||||
- **Связь через**: выберите столбец `Клиент`
|
||||
- **Подставлять поле**: выберите `Email`
|
||||
|
||||
**Результат**: При выборе клиента автоматически подставится его Email!
|
||||
|
||||
#### Использование AI с связанными таблицами
|
||||
|
||||
AI автоматически понимает связи и может отвечать на вопросы:
|
||||
|
||||
```
|
||||
Пользователь: "Покажи все заказы клиента Иванов"
|
||||
AI: [Ищет в таблице Заказы, фильтрует по клиенту Иванов]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Шаг 7: Интеграция с Telegram и Email (опционально)
|
||||
|
||||
### 7.1 Настройка Telegram бота
|
||||
|
||||
1. Перейдите в **Настройки** → **Интеграции** → **Telegram**
|
||||
2. Создайте бота через [@BotFather](https://t.me/botfather) в Telegram:
|
||||
- Отправьте `/newbot`
|
||||
- Выберите имя и username бота
|
||||
- Скопируйте **Bot Token**
|
||||
3. В настройках DLE введите:
|
||||
- **Bot Token**: вставьте токен от BotFather
|
||||
- **Bot Username**: username вашего бота (например, `@mycompany_bot`)
|
||||
4. Нажмите **"Сохранить"**
|
||||
5. В настройках AI ассистента выберите этот Telegram бот в поле **"Telegram-бот"**
|
||||
|
||||
**Результат**: AI будет отвечать на сообщения в Telegram!
|
||||
|
||||
### 7.2 Настройка Email интеграции
|
||||
|
||||
1. Перейдите в **Настройки** → **Интеграции** → **Email**
|
||||
2. Заполните IMAP настройки (для получения писем):
|
||||
- **IMAP Host**: `imap.gmail.com` (для Gmail)
|
||||
- **IMAP Port**: `993`
|
||||
- **IMAP User**: ваш email
|
||||
- **IMAP Password**: пароль приложения (не основной пароль!)
|
||||
3. Заполните SMTP настройки (для отправки писем):
|
||||
- **SMTP Host**: `smtp.gmail.com`
|
||||
- **SMTP Port**: `587`
|
||||
- **SMTP User**: ваш email
|
||||
- **SMTP Password**: пароль приложения
|
||||
- **From Email**: email для отправки
|
||||
4. Нажмите **"Тест IMAP"** и **"Тест SMTP"** для проверки
|
||||
5. Нажмите **"Сохранить"**
|
||||
6. В настройках AI ассистента выберите этот Email в поле **"Email для связи"**
|
||||
|
||||
> ⚠️ **Важно для Gmail**: Создайте "Пароль приложения" в настройках безопасности Google
|
||||
|
||||
**Результат**: AI будет отвечать на входящие email автоматически!
|
||||
|
||||
---
|
||||
|
||||
## Шаг 8: Мониторинг и оптимизация
|
||||
|
||||
### 8.1 Проверка статуса сервисов
|
||||
|
||||
1. Перейдите в **Настройки** → **Интеграции** → **ИИ-ассистент**
|
||||
2. Прокрутите вниз до **"🔍 Мониторинг системы"**
|
||||
3. Нажмите **"🔄 Обновить статус"**
|
||||
4. Проверьте статусы:
|
||||
- 🟢 **Backend**: должен быть "Работает"
|
||||
- 🟢 **Postgres**: должен быть "Работает"
|
||||
- 🟢 **Ollama**: должен показывать количество моделей
|
||||
- 🟢 **Vector Search**: должен быть "Работает"
|
||||
|
||||
> ⚠️ Если что-то красное (🔴) — см. раздел "Решение проблем" ниже
|
||||
|
||||
### 8.2 Анализ качества ответов
|
||||
|
||||
Регулярно проверяйте качество ответов AI:
|
||||
|
||||
1. **Score в тестере RAG**:
|
||||
- **-300 до 0** ✅ — отличное совпадение
|
||||
- **0 до 300** ⚠️ — среднее совпадение
|
||||
- **>300** ❌ — совпадение не найдено
|
||||
|
||||
2. **Если Score плохой**:
|
||||
- Добавьте больше похожих вопросов в таблицу
|
||||
- Используйте разные формулировки одного вопроса
|
||||
- Увеличьте порог релевантности (например, до 0.2)
|
||||
|
||||
### 8.3 Оптимизация настроек RAG
|
||||
|
||||
Экспериментируйте с настройками для улучшения результатов:
|
||||
|
||||
**Для более точных ответов:**
|
||||
```
|
||||
Метод поиска: Семантический
|
||||
Порог релевантности: 0.05 (ниже = строже)
|
||||
Веса: Семантический 100% / Ключевые слова 0%
|
||||
```
|
||||
|
||||
**Для более быстрых ответов:**
|
||||
```
|
||||
Метод поиска: Поиск по ключевым словам
|
||||
Максимальное количество результатов: 3
|
||||
```
|
||||
|
||||
**Для баланса (рекомендуется):**
|
||||
```
|
||||
Метод поиска: Гибридный
|
||||
Веса: Семантический 70% / Ключевые слова 30%
|
||||
Порог релевантности: 0.1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ AI Ассистент готов к работе!
|
||||
|
||||
### Что у вас теперь есть
|
||||
|
||||
✅ **Локальный AI ассистент** без зависимости от облака
|
||||
✅ **База знаний FAQ** для ответов клиентам
|
||||
✅ **Векторный поиск** для точных ответов
|
||||
✅ **Настроенные правила** поведения AI
|
||||
✅ **Система мониторинга** для контроля качества
|
||||
|
||||
### Экономический эффект
|
||||
|
||||
При правильной настройке AI ассистента вы получите:
|
||||
|
||||
✅ **Автоматизацию рутинных задач** - высвобождение времени для стратегии
|
||||
✅ **Повышение качества обслуживания** - AI работает 24/7 без усталости
|
||||
✅ **Снижение операционных расходов** - меньше персонала на рутинных задачах
|
||||
✅ **Ускорение принятия решений** - мгновенный доступ к информации
|
||||
|
||||
> 💡 **Подробная информация**: См. [AI Ассистент - полное описание](./ai-assistant.md#экономический-эффект) - там детально описаны все возможности, кейсы применения и расчеты экономии.
|
||||
|
||||
---
|
||||
|
||||
## 📚 Следующие шаги
|
||||
|
||||
### Расширьте возможности AI
|
||||
|
||||
1. **Добавьте больше таблиц**:
|
||||
- База знаний для партнеров
|
||||
- Инструкции для персонала
|
||||
- Каталог продуктов
|
||||
- База контактов
|
||||
|
||||
2. **Создайте правила для разных сценариев**:
|
||||
- Строгий режим (только RAG) — для финансов
|
||||
- Креативный режим (больше генерации) — для маркетинга
|
||||
- Гибридный режим (баланс) — для поддержки
|
||||
|
||||
3. **Интегрируйте с другими системами**:
|
||||
- CRM (синхронизация клиентов)
|
||||
- Складская система (остатки товаров)
|
||||
- Бухгалтерия (счета и оплаты)
|
||||
|
||||
### Обучите команду
|
||||
|
||||
1. Покажите сотрудникам, как работает AI
|
||||
2. Объясните, как добавлять новые вопросы в базу
|
||||
3. Установите процесс регулярного обновления базы знаний
|
||||
4. Назначьте ответственного за качество ответов AI
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Решение проблем
|
||||
|
||||
### Проблема: Ollama не запускается
|
||||
|
||||
**Симптомы**: Статус "Ollama API not responding"
|
||||
|
||||
**Решение**:
|
||||
```bash
|
||||
# Проверить контейнер
|
||||
docker ps | grep ollama
|
||||
|
||||
# Перезапустить
|
||||
docker-compose restart ollama
|
||||
|
||||
# Проверить логи
|
||||
docker-compose logs ollama
|
||||
```
|
||||
|
||||
### Проблема: AI отвечает неточно
|
||||
|
||||
**Симптомы**: Ответы не соответствуют базе знаний
|
||||
|
||||
**Решение**:
|
||||
1. Проверьте Score в тестере (должен быть < 300)
|
||||
2. Добавьте больше вариантов вопросов в таблицу
|
||||
3. Уменьшите порог релевантности (например, до 0.05)
|
||||
4. Проверьте, что столбцы имеют правильные назначения ("Вопрос для AI", "Ответ AI")
|
||||
|
||||
### Проблема: Vector Search не работает
|
||||
|
||||
**Симптомы**: Статус Vector Search показывает ошибку
|
||||
|
||||
**Решение**:
|
||||
1. Проверьте, установлена ли Embedding модель
|
||||
2. Пересоберите индекс: на странице таблицы нажмите **"🔄 Пересобрать индекс"**
|
||||
3. Проверьте, что таблица активирована как источник для AI
|
||||
|
||||
### Проблема: AI отвечает на неправильном языке
|
||||
|
||||
**Симптомы**: Ответы на английском вместо русского
|
||||
|
||||
**Решение**:
|
||||
1. Измените системный промт, добавив в начало: `ВСЕГДА отвечай на русском языке.`
|
||||
2. Используйте модель `qwen2.5:7b` вместо `llama2:7b`
|
||||
3. В правилах AI установите `"language": "ru"`
|
||||
|
||||
### Проблема: Медленные ответы
|
||||
|
||||
**Симптомы**: AI отвечает дольше 5-10 секунд
|
||||
|
||||
**Решение**:
|
||||
1. Используйте меньшую модель (`mistral:7b` вместо `qwen2.5:14b`)
|
||||
2. Уменьшите `maxResults` в настройках RAG (например, до 3)
|
||||
3. Отключите "Поиск синонимов" в дополнительных настройках
|
||||
4. Используйте SSD для хранения моделей
|
||||
|
||||
---
|
||||
|
||||
## 📖 Дополнительная документация
|
||||
|
||||
### Изучите возможности AI
|
||||
|
||||
- 🤖 **[AI Ассистент - полное описание](./ai-assistant.md)** - все возможности и кейсы применения
|
||||
- 📊 **[Система электронных таблиц](./tables-system.md)** - техническое описание таблиц (временный)
|
||||
- ⚙️ **[Конфигурация AI](./setup-ai-assistant.md#техническая-документация-для-разработчиков)** - технические детали настройки
|
||||
|
||||
### Общая документация
|
||||
|
||||
- 🛡️ **[Безопасность](./security.md)** - как AI защищает ваши данные
|
||||
- 💼 **[Блокчейн для бизнеса](./blockchain-for-business.md)** - интеграция AI с блокчейном
|
||||
- 📋 **[FAQ](./FAQ.md)** - часто задаваемые вопросы
|
||||
|
||||
### Поддержка
|
||||
|
||||
- 💬 **Чат поддержки**: https://hb3-accelerator.com/
|
||||
- 📧 **Email**: info@hb3-accelerator.com
|
||||
- 📚 **База знаний**: https://hb3-accelerator.com
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Техническая документация (для разработчиков)
|
||||
|
||||
### Архитектура системы AI
|
||||
|
||||
```
|
||||
┌───────────────────────────────────────────────────────────┐
|
||||
│ Настройка AI Ассистента в DLE │
|
||||
├───────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ 🤖 AI Провайдеры: │
|
||||
│ ├── OpenAI (GPT-4, GPT-3.5) │
|
||||
│ ├── Anthropic (Claude) │
|
||||
│ ├── Google (Gemini) │
|
||||
│ └── Ollama (локальные модели) │
|
||||
│ │
|
||||
│ ⚙️ Настройки AI: │
|
||||
│ ├── System Prompt │
|
||||
│ ├── Выбор LLM модели │
|
||||
│ ├── Выбор Embedding модели │
|
||||
│ ├── Выбор RAG-таблиц │
|
||||
│ ├── Правила (Rules) │
|
||||
│ └── Настройки RAG поиска │
|
||||
│ │
|
||||
│ 📋 Правила (Rules): │
|
||||
│ ├── JSON конфигурация поведения │
|
||||
│ ├── Создание/редактирование/удаление │
|
||||
│ └── Привязка к AI ассистенту │
|
||||
│ │
|
||||
│ 🔗 Интеграции: │
|
||||
│ ├── Email (IMAP + SMTP) │
|
||||
│ └── Telegram Bot │
|
||||
│ │
|
||||
│ 🔍 RAG: │
|
||||
│ ├── Выбор таблиц для поиска │
|
||||
│ ├── Настройки поиска (гибридный/семантический) │
|
||||
│ ├── Порог релевантности │
|
||||
│ └── Извлечение ключевых слов │
|
||||
│ │
|
||||
│ 📊 Мониторинг: │
|
||||
│ ├── Статус сервисов (Backend, Ollama, Postgres) │
|
||||
│ ├── Тест RAG-функциональности │
|
||||
│ └── Отслеживание прогресса │
|
||||
│ │
|
||||
└───────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### База данных
|
||||
|
||||
#### Таблица: `ai_providers_settings`
|
||||
|
||||
```sql
|
||||
CREATE TABLE IF NOT EXISTS ai_providers_settings (
|
||||
id SERIAL PRIMARY KEY,
|
||||
provider_encrypted TEXT, -- Провайдер: openai, anthropic, google, ollama
|
||||
api_key_encrypted TEXT, -- API ключ (зашифрован)
|
||||
base_url_encrypted TEXT, -- Base URL для API
|
||||
selected_model_encrypted TEXT, -- Выбранная LLM модель
|
||||
embedding_model_encrypted TEXT, -- Выбранная Embedding модель
|
||||
created_at TIMESTAMP NOT NULL DEFAULT NOW(),
|
||||
updated_at TIMESTAMP NOT NULL DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
#### Таблица: `ai_assistant_settings`
|
||||
|
||||
```sql
|
||||
CREATE TABLE IF NOT EXISTS ai_assistant_settings (
|
||||
id SERIAL PRIMARY KEY,
|
||||
system_prompt_encrypted TEXT, -- Системный промт
|
||||
selected_rag_tables INTEGER[], -- Массив ID RAG-таблиц
|
||||
languages TEXT[], -- Массив поддерживаемых языков
|
||||
model_encrypted TEXT, -- Выбранная LLM модель
|
||||
embedding_model_encrypted TEXT, -- Выбранная Embedding модель
|
||||
rules JSONB, -- Правила (DEPRECATED)
|
||||
rules_id INTEGER REFERENCES ai_assistant_rules(id), -- Ссылка на правило
|
||||
telegram_settings_id INTEGER, -- Ссылка на Telegram бота
|
||||
email_settings_id INTEGER, -- Ссылка на Email настройки
|
||||
rag_settings JSONB, -- Настройки RAG поиска
|
||||
updated_at TIMESTAMP DEFAULT NOW(),
|
||||
updated_by INTEGER
|
||||
);
|
||||
```
|
||||
|
||||
#### Таблица: `ai_assistant_rules`
|
||||
|
||||
```sql
|
||||
CREATE TABLE IF NOT EXISTS ai_assistant_rules (
|
||||
id SERIAL PRIMARY KEY,
|
||||
name TEXT NOT NULL, -- Название набора правил
|
||||
description TEXT, -- Описание правила
|
||||
rules JSONB NOT NULL, -- JSON конфигурация
|
||||
rules_encrypted TEXT, -- Зашифрованная версия правил
|
||||
created_at TIMESTAMP DEFAULT NOW(),
|
||||
updated_at TIMESTAMP DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
### Backend API
|
||||
|
||||
#### Настройки AI провайдеров
|
||||
|
||||
- **GET** `/settings/ai-settings/:provider` — Получить настройки провайдера
|
||||
- **PUT** `/settings/ai-settings/:provider` — Сохранить настройки провайдера
|
||||
- **DELETE** `/settings/ai-settings/:provider` — Удалить настройки провайдера
|
||||
- **GET** `/settings/ai-settings/:provider/models` — Получить список моделей
|
||||
- **POST** `/settings/ai-settings/:provider/verify` — Проверить API ключ
|
||||
|
||||
#### Настройки AI ассистента
|
||||
|
||||
- **GET** `/settings/ai-assistant` — Получить настройки ассистента
|
||||
- **PUT** `/settings/ai-assistant` — Сохранить настройки ассистента
|
||||
|
||||
#### Правила AI
|
||||
|
||||
- **GET** `/settings/ai-assistant-rules` — Получить все правила
|
||||
- **GET** `/settings/ai-assistant-rules/:id` — Получить правило по ID
|
||||
- **POST** `/settings/ai-assistant-rules` — Создать правило
|
||||
- **PUT** `/settings/ai-assistant-rules/:id` — Обновить правило
|
||||
- **DELETE** `/settings/ai-assistant-rules/:id` — Удалить правило
|
||||
|
||||
#### Ollama (локальные модели)
|
||||
|
||||
- **GET** `/ollama/status` — Проверить статус Ollama
|
||||
- **GET** `/ollama/models` — Получить список моделей
|
||||
- **POST** `/ollama/install` — Установить модель
|
||||
- **DELETE** `/ollama/models/:modelName` — Удалить модель
|
||||
|
||||
### Frontend страницы
|
||||
|
||||
- **`/settings/ai`** — Главная страница интеграций
|
||||
- **`/settings/ai/:provider`** — Настройки AI провайдера
|
||||
- **`/settings/ai/assistant`** — Настройки AI ассистента
|
||||
|
||||
### Процесс обработки сообщения
|
||||
|
||||
```
|
||||
1. Пользователь → Сообщение
|
||||
↓
|
||||
2. UnifiedMessageProcessor
|
||||
↓
|
||||
3. Проверка языка (только русский)
|
||||
↓
|
||||
4. Дедупликация (хеш сообщения)
|
||||
↓
|
||||
5. Загрузка настроек (aiAssistantSettingsService)
|
||||
↓
|
||||
6. Загрузка правил (aiAssistantRulesService)
|
||||
↓
|
||||
7. RAG поиск (ragService)
|
||||
├── Семантический поиск (vector search)
|
||||
├── Поиск по ключевым словам
|
||||
└── Гибридный поиск
|
||||
↓
|
||||
8. Генерация ответа (generateLLMResponse)
|
||||
├── System Prompt
|
||||
├── История разговора
|
||||
├── Контекст из RAG
|
||||
└── Правила
|
||||
↓
|
||||
9. Ответ → Пользователь
|
||||
```
|
||||
|
||||
### Безопасность
|
||||
|
||||
- **Шифрование**: Все чувствительные поля зашифрованы с помощью AES-256
|
||||
- **Права доступа**: Только администраторы могут изменять настройки
|
||||
- **Валидация**: Проверка всех входных данных и API ключей
|
||||
|
||||
---
|
||||
|
||||
**© 2024-2025 Тарабанов Александр Викторович. Все права защищены.**
|
||||
|
||||
**Версия документа**: 1.0.0
|
||||
**Дата создания**: October 25, 2025
|
||||
|
||||
195
docs/setup-instruction.md
Normal file
195
docs/setup-instruction.md
Normal file
@@ -0,0 +1,195 @@
|
||||
<!--
|
||||
Copyright (c) 2024-2025 Тарабанов Александр Викторович
|
||||
All rights reserved.
|
||||
|
||||
This software is proprietary and confidential.
|
||||
Unauthorized copying, modification, or distribution is prohibited.
|
||||
|
||||
For licensing inquiries: info@hb3-accelerator.com
|
||||
Website: https://hb3-accelerator.com
|
||||
GitHub: https://github.com/VC-HB3-Accelerator
|
||||
-->
|
||||
|
||||
# Инструкция по настройке приложения Digital Legal Entity
|
||||
|
||||
## 🚀 Полный процесс инициализации системы
|
||||
|
||||
Этот документ описывает полный процесс подготовки приложения к работе с поддержкой блокчейна, смарт-контрактов и системы управления доступом.
|
||||
|
||||
---
|
||||
|
||||
## Шаг 1: Установка софта
|
||||
|
||||
1. Клонируйте репозиторий проекта на ваше локальное устройство
|
||||
2. Запустите приложение через Docker Compose или локально в зависимости от конфигурации
|
||||
3. Откройте веб-приложение в браузере: `http://localhost:9000` (production) или `http://localhost:5173` (dev режим)
|
||||
|
||||
---
|
||||
|
||||
## Шаг 2: Подключение крипто кошелька
|
||||
|
||||
1. Убедитесь, что у вас установлен браузерный кошелек (MetaMask, WalletConnect или аналог)
|
||||
2. В кошельке создайте или импортируйте аккаунт с токеном управления
|
||||
3. В веб-приложении нажмите на кнопку **"Подключить кошелек"**
|
||||
4. Выберите тип кошелька и подтвердите подключение
|
||||
5. После успешного подключения вы увидите адрес вашего аккаунта в верхнем углу
|
||||
|
||||
---
|
||||
|
||||
## Шаг 3: Добавление RPC провайдеров (Безопасность → RPC провайдеры)
|
||||
|
||||
1. Перейдите в **Настройки** → вкладка **Безопасность**
|
||||
2. Найдите раздел **"RPC провайдеры"**
|
||||
3. Нажмите кнопку **"Добавить"**
|
||||
4. Заполните форму для каждой блокчейн сети, которую хотите использовать:
|
||||
- **Название сети** (например: Ethereum, Polygon, BSC)
|
||||
- **RPC URL** (ссылка для подключения, пример: `https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY`)
|
||||
- **ID сети** (Chain ID)
|
||||
5. Нажмите **"Сохранить"** для каждого провайдера
|
||||
6. Система автоматически проверит корректность подключения
|
||||
|
||||
> ⚠️ **Важно**: Получите API ключи от провайдеров (Alchemy, Infura, Quicknode и т.д.) перед добавлением
|
||||
|
||||
---
|
||||
|
||||
## Шаг 4: Настройка мультидеплоя смарт контрактов
|
||||
|
||||
1. Перейдите в **Настройки** → вкладка **Блокчейн**
|
||||
2. Заполните форму
|
||||
3. Нажмите **"Запустить деплой"**
|
||||
|
||||
---
|
||||
|
||||
## Шаг 5: Завершение деплоя и сохранение адреса контракта
|
||||
|
||||
1. Ожидайте завершения деплоя (зависит от сети, обычно 30-120 секунд)
|
||||
2. После успешного завершения откроется страница **"Управление контрактами"**
|
||||
3. **Копируйте адрес развернутого контракта** (обычно он выглядит как: `0x742d35Cc6634C0532925a3b844Bc...`)
|
||||
|
||||
---
|
||||
|
||||
## Шаг 6: Настройка аутентификации через смарт контракт
|
||||
|
||||
1. Вернитесь в **Настройки** → вкладка **Аутентификация**
|
||||
2. В поле **"Адрес смарт контракта"** вставьте адрес, скопированный на шаге 5
|
||||
3. Установите пороги для управления доступом:
|
||||
- **Минимальное количество токенов для редактирования** (например: 100 токенов)
|
||||
- **Минимальное количество токенов для просмотра** (например: 1 токен)
|
||||
|
||||
---
|
||||
|
||||
## Шаг 7: Настройка ИИ и базы данных
|
||||
|
||||
1. Перейдите в **Настройки** → вкладка **ИИ**
|
||||
2. Откройте подраздел **"База данных"**
|
||||
3. Замените дефолтные пароли
|
||||
4. Нажмите **"Сгенерировать новый ключ шифрования"**
|
||||
- Система автоматически создаст криптографический ключ
|
||||
- **Сохраните ключ в безопасном месте** (он понадобится для восстановления данных)
|
||||
|
||||
---
|
||||
|
||||
## Шаг 8: Настройка доступа через интернет (опционально)
|
||||
|
||||
**Если вам нужен доступ к веб приложению извне через интернет:**
|
||||
|
||||
1. Перейдите в **Настройки** → вкладка **Сервер**
|
||||
2. На странице **Сервер** выберите **WEB SSH** или иной подходящий сервис
|
||||
3. Заполните форму для миграции локального приложения на виртуальное устройство с:
|
||||
- **Публичным IP адресом**
|
||||
- **Подключением к вашему доменному имени**
|
||||
4. Нажмите **"Опубликовать"**
|
||||
5. Дождитесь завершения процесса миграции
|
||||
|
||||
> ℹ️ **Примечание**: Этот шаг требует наличия зарегистрированного доменного имени и доступа к DNS настройкам
|
||||
|
||||
---
|
||||
|
||||
## Шаг 9: Настройка юридических документов для работы с персональными данными
|
||||
|
||||
### 9.1 Заполнение юридической информации о компании
|
||||
|
||||
1. Перейдите в **CRM** → раздел **Контент**
|
||||
2. Найдите и откройте форму **"Юридическая информация компании"**
|
||||
3. Заполните все необходимые поля:
|
||||
- **Полное наименование организации** (юридическое название)
|
||||
- **Краткое наименование**
|
||||
- **Организационно-правовая форма** (ООО, ИП, АО и т.д.)
|
||||
- **Юридический адрес**
|
||||
- **Фактический адрес** (если отличается)
|
||||
- **ИНН / ОГРН / КПП** (регистрационные данные)
|
||||
- **Контактные данные** (телефон, email, сайт)
|
||||
- **Ответственное лицо за обработку персональных данных** (ФИО, должность)
|
||||
- **Применимая юрисдикция** (GDPR, CCPA, российское законодательство и т.д.)
|
||||
4. Нажмите **"Сохранить"**
|
||||
|
||||
> 💡 **Подсказка**: Все введенные данные автоматически подставятся во все шаблоны юридических документов
|
||||
|
||||
### 9.2 Работа с шаблонами документов
|
||||
|
||||
1. В разделе **Контент** перейдите в подраздел **"Шаблоны"**
|
||||
2. Выберите необходимые шаблоны документов, требуемые регуляторами:
|
||||
- **Политика конфиденциальности**
|
||||
- **Пользовательское соглашение**
|
||||
- **Согласие на обработку персональных данных**
|
||||
- **Политика использования cookies**
|
||||
3. Для каждого шаблона:
|
||||
- Нажмите **"Предварительный просмотр"** для проверки автоматически заполненных данных
|
||||
- При необходимости отредактируйте специфичные параметры обработки данных
|
||||
- Выберите действие:
|
||||
- **"Опубликовать для публичного использования"** — документ будет доступен на сайте
|
||||
- **"Опубликовать для внутреннего использования"** — документ доступен только внутри CRM
|
||||
- **"Распечатать"** — экспорт в PDF для печати или подписания
|
||||
4. Подтвердите публикацию
|
||||
5. Система автоматически добавит документы на соответствующие страницы приложения
|
||||
|
||||
> ⚠️ **Важно**: Рекомендуется проконсультироваться с юристом перед публикацией документов для обеспечения полного соответствия требованиям законодательства
|
||||
|
||||
---
|
||||
|
||||
## ✅ Приложение готово к работе!
|
||||
|
||||
После завершения всех шагов ваше приложение полностью сконфигурировано и готово к использованию.
|
||||
|
||||
**Следующие этапы:**
|
||||
- 📖 Настройка AI ассистента (см. документ: `setup-ai-assistant.md`)
|
||||
- 🔐 Управление смарт контрактами (см. документ: `manage-smart-contracts.md`)
|
||||
|
||||
---
|
||||
|
||||
## 🆘 Рекомендации по безопасности
|
||||
|
||||
✓ Сохраняйте адреса контрактов и ключи шифрования в безопасном месте
|
||||
✓ Используйте мощные пароли для БД
|
||||
✓ Регулярно создавайте резервные копии конфигурации
|
||||
✓ Никогда не делитесь приватными ключами кошелька
|
||||
✓ Используйте HTTPS для доступа к приложению в продакшене
|
||||
|
||||
---
|
||||
|
||||
## 📝 Что дальше?
|
||||
|
||||
После завершения базовой настройки вы можете:
|
||||
1. Добавлять пользователей и управлять их разрешениями
|
||||
2. Создавать группы для совместной работы
|
||||
3. Настраивать AI ассистента для автоматизации задач
|
||||
4. Управлять смарт контрактами для расширения функциональности
|
||||
5. Интегрировать внешние сервисы и боты
|
||||
|
||||
---
|
||||
|
||||
## 📚 Дополнительная документация
|
||||
|
||||
### Изучите возможности DLE
|
||||
- 🤖 **[AI Ассистент](./ai-assistant.md)** - узнайте как AI может стать вторым пилотом для вашей команды
|
||||
- 💼 **[Блокчейн для бизнеса](./blockchain-for-business.md)** - как токенизация активов решает бизнес-задачи
|
||||
- 🛡️ **[Безопасность](./security.md)** - многоуровневая защита вашего бизнеса
|
||||
|
||||
### Техническая информация
|
||||
- 🔗 **[Техническая документация по блокчейну](./blockchain-integration-technical.md)** - для разработчиков
|
||||
- 📋 **[FAQ](./FAQ.md)** - часто задаваемые вопросы
|
||||
- 📝 **[Описание приложения](./application-description.md)** - обзор функциональности
|
||||
|
||||
### Поддержка
|
||||
- 💬 **Чат поддержки**: https://hb3-accelerator.com/
|
||||
- 📧 **Email**: info@hb3-accelerator.com
|
||||
1639
docs/tables-system.md
Normal file
1639
docs/tables-system.md
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user