feat: добавлены папки legal и docs из ветки private/backup

This commit is contained in:
2025-11-01 20:45:25 +03:00
parent f100935d3e
commit d2ca702c6f
25 changed files with 10355 additions and 0 deletions

1195
docs/FAQ.md Normal file

File diff suppressed because it is too large Load Diff

386
docs/ai-assistant.md Normal file
View 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

View 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

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

1309
docs/security.md Normal file

File diff suppressed because it is too large Load Diff

42
docs/service-terms.md Normal file
View 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
View 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
View 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

File diff suppressed because it is too large Load Diff