111 lines
3.6 KiB
Markdown
111 lines
3.6 KiB
Markdown
# 📦 Установка CRM Extensions
|
||
|
||
## Требования
|
||
|
||
- vTiger CRM 7.2.0+
|
||
- PHP 7.4+
|
||
- Composer (опционально)
|
||
- Доступ к S3-совместимому хранилищу
|
||
- Nextcloud AIO с редактором документов
|
||
|
||
## Пошаговая установка
|
||
|
||
### 1. Подготовка окружения
|
||
|
||
```bash
|
||
# Перейдите в папку CRM
|
||
cd /var/www/fastuser/data/www/crm.clientright.ru
|
||
|
||
# Проверьте что папка crm_extensions создана
|
||
ls -la crm_extensions/
|
||
```
|
||
|
||
### 2. Настройка переменных окружения
|
||
|
||
```bash
|
||
# Скопируйте шаблон
|
||
cp crm_extensions/.env.example crm_extensions/.env
|
||
|
||
# Отредактируйте файл своими данными
|
||
nano crm_extensions/.env
|
||
|
||
# Установите безопасные права доступа
|
||
chmod 600 crm_extensions/.env
|
||
```
|
||
|
||
### 3. Заполните .env файл
|
||
|
||
Обязательные переменные:
|
||
- `S3_ACCESS_KEY` - ключ доступа к S3
|
||
- `S3_SECRET_KEY` - секретный ключ S3
|
||
- `S3_ENDPOINT` - URL вашего S3 хранилища
|
||
- `S3_BUCKET` - имя бакета
|
||
- `NEXTCLOUD_URL` - URL Nextcloud AIO
|
||
- `NEXTCLOUD_USERNAME` - пользователь для интеграции
|
||
- `NEXTCLOUD_PASSWORD` - пароль приложения
|
||
- `N8N_WEBHOOK_URL` - URL webhook n8n
|
||
- `ENCRYPTION_KEY` - 32 случайных символа
|
||
|
||
### 4. Тестирование конфигурации
|
||
|
||
```bash
|
||
# Проверьте загрузку конфигурации
|
||
php crm_extensions/tests/test_config.php
|
||
```
|
||
|
||
### 5. Интеграция с vTiger
|
||
|
||
Файлы AI Drawer уже интегрированы в:
|
||
- `layouts/v7/modules/Vtiger/Header.tpl`
|
||
- Ссылки на CSS/JS обновлены
|
||
|
||
### 6. Установка зависимостей (если требуется)
|
||
|
||
```bash
|
||
# Для работы с S3
|
||
composer require aws/aws-sdk-php
|
||
|
||
# Обновите composer.json в корне CRM
|
||
```
|
||
|
||
## Проверка работы
|
||
|
||
1. **AI Drawer**: Откройте любую страницу CRM, должна появиться кнопка "AI"
|
||
2. **История чата**: При открытии AI Drawer должна загружаться история
|
||
3. **Мобильная адаптация**: Проверьте на мобильном устройстве
|
||
|
||
## Устранение проблем
|
||
|
||
### Проблема: .env файл не загружается
|
||
```bash
|
||
# Проверьте права доступа
|
||
ls -la crm_extensions/.env
|
||
|
||
# Должно быть: -rw------- (600)
|
||
chmod 600 crm_extensions/.env
|
||
```
|
||
|
||
### Проблема: AI Drawer не появляется
|
||
1. Проверьте консоль браузера на ошибки
|
||
2. Убедитесь что пользователь авторизован
|
||
3. Проверьте что CSS/JS файлы загружаются
|
||
|
||
### Проблема: История не загружается
|
||
1. Проверьте n8n webhook URL
|
||
2. Проверьте логи: `tail -f logs/php_errors.log`
|
||
3. Протестируйте эндпоинт: `curl -X POST your-n8n-webhook`
|
||
|
||
## Логи
|
||
|
||
Все логи записываются в:
|
||
- `crm_extensions/logs/crm_extensions.log` - основной лог
|
||
- Системные логи PHP
|
||
- Логи веб-сервера
|
||
|
||
## Поддержка
|
||
|
||
Для получения помощи:
|
||
1. Проверьте логи на ошибки
|
||
2. Запустите тестовые файлы
|
||
3. Обратитесь к разработчику с подробным описанием проблемы
|