Files
crm.clientright.ru/ai_drawer_backup_working/RESTORE_INSTRUCTIONS.md

139 lines
5.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🚀 AI Drawer - Рабочая версия (Резервная копия)
## 📅 Дата создания: 21 сентября 2025
## 👤 Создано для: Фёдор
## ✅ Статус: **РАБОЧАЯ ВЕРСИЯ** - все функции работают
---
## 🎯 Что работает в этой версии:
### ✅ **Основные функции:**
- **Управление размером шрифта** - панель с кнопками (мелкий, обычный, крупный, очень крупный)
- **Дружелюбные аватарки** - 🤖😊💡🧠 с анимацией и возможностью смены
- **Светлая тема** - белый фон с темным текстом для комфорта глаз
- **Плавающий индикатор загрузки** - центрированные уведомления
- **Улучшенный скролл** - стилизованные полосы прокрутки
### ✅ **Интерактивность:**
- **Поле ввода сообщений** - с кнопкой "Отправить" и поддержкой Enter
- **Стриминг сообщений** - постепенное появление текста ассистента
- **Индикатор печатания** - анимация "печатает..." с точками
- **Скрытие кнопки AI** - когда drawer открыт
### ✅ **Интеграция с n8n:**
- **Загрузка истории** - запрос в `https://n8n.clientright.pro/webhook/5f50933f-f761-455a-9a7d-9fe0909e3f26`
- **Отправка сообщений** - через `aiassist/n8n_proxy.php`
- **Автоматическая инициализация** - при открытии модуля загружается история
- **Передача контекста CRM** - модуль, запись, пользователь
### ✅ **Сохранение настроек:**
- **Размер шрифта** сохраняется в localStorage
- **Тип аватарки** сохраняется в localStorage
- **Восстановление** настроек при перезагрузке
---
## 📁 Файлы рабочей версии:
### 1. **ai-drawer.css.working**
- Оригинал: `layouts/v7/resources/css/ai-drawer.css`
- Стили для светлой темы, панелей управления, аватарок
### 2. **ai-drawer-simple.js.working**
- Оригинал: `layouts/v7/resources/js/ai-drawer-simple.js`
- Основной класс AIDrawer с загрузкой истории из n8n
### 3. **ai_drawer_improvements.js.working**
- Оригинал: `ai_drawer_improvements.js`
- Дополнительные функции и демонстрации
### 4. **Header.tpl.working**
- Оригинал: `layouts/v7/modules/Vtiger/Header.tpl`
- Подключение файлов и инициализация (с Nextcloud Editor)
---
## 🔄 Инструкции по восстановлению:
### Быстрое восстановление:
```bash
cd /var/www/fastuser/data/www/crm.clientright.ru
# Восстановить CSS
cp ai_drawer_backup_working/ai-drawer.css.working layouts/v7/resources/css/ai-drawer.css
# Восстановить JavaScript
cp ai_drawer_backup_working/ai-drawer-simple.js.working layouts/v7/resources/js/ai-drawer-simple.js
# Восстановить улучшения
cp ai_drawer_backup_working/ai_drawer_improvements.js.working ai_drawer_improvements.js
# Восстановить Header.tpl
cp ai_drawer_backup_working/Header.tpl.working layouts/v7/modules/Vtiger/Header.tpl
# Проверить права доступа
chmod 644 layouts/v7/resources/css/ai-drawer.css
chmod 644 layouts/v7/resources/js/ai-drawer-simple.js
chmod 644 ai_drawer_improvements.js
chmod 644 layouts/v7/modules/Vtiger/Header.tpl
```
### Поэтапное восстановление:
```bash
# 1. Только стили
cp ai_drawer_backup_working/ai-drawer.css.working layouts/v7/resources/css/ai-drawer.css
# 2. Только JavaScript
cp ai_drawer_backup_working/ai-drawer-simple.js.working layouts/v7/resources/js/ai-drawer-simple.js
# 3. Только Header.tpl
cp ai_drawer_backup_working/Header.tpl.working layouts/v7/modules/Vtiger/Header.tpl
```
---
## 🎯 Особенности этой версии:
### **Структура HTML (создается JavaScript):**
```html
<div class="ai-drawer font-normal">
<div class="ai-drawer-header">AI Ассистент</div>
<div class="ai-font-controls"><!-- кнопки размера шрифта --></div>
<div class="ai-avatar-controls"><!-- кнопки аватарок --></div>
<div class="ai-drawer-content">
<div class="ai-chat-messages"><!-- сообщения истории --></div>
</div>
<div class="ai-chat-input-container"><!-- поле ввода --></div>
</div>
```
### **Интеграция с n8n:**
- **Загрузка истории**: `action: 'get_history'` → n8n вебхук
- **Отправка сообщений**: через `n8n_proxy.php` → n8n
- **Формат истории**: `msg.content`, `msg.sender_type`, `msg.created_at`
### **Z-index значения:**
- AI Drawer: `999999`
- Toggle button: `999998`
- Loading overlay: `10000`
---
## ⚠️ ВАЖНО:
1. **Не удаляйте эту папку** `ai_drawer_backup_working`
2. **Перед изменениями** всегда делайте копию текущего состояния
3. **Nextcloud Editor интеграция** сохранена в Header.tpl
4. **Версии файлов** в Header.tpl нужно обновлять при восстановлении
---
## 📞 Контакты:
- **Разработчик**: Claude Sonnet 4 (AI Assistant)
- **Заказчик**: Фёдор
- **Проект**: CRM ClientRight.ru AI Drawer
**Эта версия работает стабильно!**