crm.clientright.ru/crm_extensions/docs/INSTALLATION.md

📦 Установка CRM Extensions

Требования

• vTiger CRM 7.2.0+
• PHP 7.4+
• Composer (опционально)
• Доступ к S3-совместимому хранилищу
• Nextcloud AIO с редактором документов

Пошаговая установка

1. Подготовка окружения

# Перейдите в папку CRM
cd /var/www/fastuser/data/www/crm.clientright.ru

# Проверьте что папка crm_extensions создана
ls -la crm_extensions/

2. Настройка переменных окружения

# Скопируйте шаблон
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. Тестирование конфигурации

# Проверьте загрузку конфигурации
php crm_extensions/tests/test_config.php

5. Интеграция с vTiger

Файлы AI Drawer уже интегрированы в:

• layouts/v7/modules/Vtiger/Header.tpl
• Ссылки на CSS/JS обновлены

6. Установка зависимостей (если требуется)

# Для работы с S3
composer require aws/aws-sdk-php

# Обновите composer.json в корне CRM

Проверка работы

1. AI Drawer: Откройте любую страницу CRM, должна появиться кнопка "AI"
2. История чата: При открытии AI Drawer должна загружаться история
3. Мобильная адаптация: Проверьте на мобильном устройстве

Устранение проблем

Проблема: .env файл не загружается

# Проверьте права доступа
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. Обратитесь к разработчику с подробным описанием проблемы