# Общие сведения {#overview}

**Система управления взаимоотношениями с клиентами** (Customer Relationship 
Management, CRM-система) — это программное обеспечение для организации 
целостного системного подхода по выстраиванию отношений с потребителем на всех 
этапах взаимодействия от маркетинга и продаж, до сервисного обслуживания 
для обеспечения прироста доли рынка и объемов продаж.

Внедрение управления взаимоотношениями с клиентами — это в первую очередь 
изменение подхода к организации работы маркетинга, продаж и сервиса. Это 
необходимо, чтобы сфокусировать команду на клиентоориентированность (мотивация) 
и задать нормативы работы, а также подготовить регламентную базу для последующей 
автоматизации.

> **Примечание:**
>
>Для работы данного приложения требуется Synergy 3.11 и выше.

Synergy CRM устанавливается отдельным пакетом. Возможные варианты установки:

1. Установка конфигурации CRM без данных (чистая установка)

2. Установка конфигурации CRM с демо-данными

3. Установка конфигурации CRM без потери данных


# Базовая установка конфигурации CRM {#basic_setting}

В терминале необходимо выполнить следующие команды:

1. Войти под SuperAdmin-ом

2. Установить систему CRM: 

`aptitude install arta-synergy-apps-crm`

3. При выводе окна Mysql ввести пароль - root

![Настройки пакета](resources/img/package_configuration.png)

4. После этого выйдет окно терминала для выбора вида установки:

![Виды установки CRM](resources/img/install_type.png)

Необходимо выбрать вид установки CRM-приложений:

-   **Clean CRM** - это чистая установка, в этом случае будут удалены старые 
    схемы и хранилище, где будет установлена конфигурация CRM.

-   **Demo CRM** - это тоже чистая установка, но также содержит демо-данные.

-   **Manual** - руководство не коснется ваших данных, добавляет реестры и очереди, 
    оставляя старые данные,т.е. без потери данных.


# Установка конфигурации CRM без данных {#crm_without_data}

Выбрав 1 вариант Clean crm, необходимо ввести адрес сервера, на котором 
производится работа. Например: http://192.168.1.172:8080/Synergy

![Настройки пакета CRM](resources/img/package_configuration2.png)

Далее ввести пароль Mysql - root.

Права на реестры настраиваются в Конфигураторе. Заходим в систему под 
пользователем с правами на реестры. Например: Жуматаев - руководитель отдела 
маркетинга (логин - Жуматаев, пароль - Жуматаев). 

> **Примечание:**
>
>Необходимо настроить "Интеграцию с почтой" - (при необходимости, создать 
произвольные форму и реестр).

После обновления системы необходимо зайти в пользовательскую часть и 
проверить установку. При переходе в модуль “Хранилище” должны отображаться 
реестры, указанные в следующем рисунке:

![Реестры](resources/img/registries.png)

На рисунке показано как должна выглядеть система, если кликнуть на верхней 
панели модуля Маркетинг, т.к данных нет, во всех данных нулевые значения. 
Если отображается серое окно, значит при установке были допущены ошибки.

![Маркетинг](resources/img/marketing.png)


# Установка конфигурации CRM с демо-данными {#crm_with_demo}

Для варианта 2 (**Demo CRM**), в дополнение к варианту 1, необходимо загрузить 
схемы и хранилище, которое будет содержать демо-данные. В частности, записи 
в каждом реестре и соответствующая им воронка и канбан. Данная установка 
отличается тем, что будут загружены данные, а в чистой установке конфигурации 
CRM - нулевые значения в модулях.


# Установка конфигурации CRM без потери данных - Manual {#crm_manual}

Чтобы установить CRM систему на сервер без потери данных необходимо выполнить 
следующие шаги:

1. Скопировать `crm.war` в папку `opt/synergy/jboss/standalone/deployments`

2. Импортировать конфигурацию в Конфигуратор (Хранилище/Департамент развития 
технологии/02 - Отделы/06 - Центр технической компетенции/01 - Обучающие 
материалы/Инструкции/CRM)

3. Добавить внешний модуль в Конфигураторе  с адресом `http://host:port/crm`, 
в нашем случае - `http://192.168.1.124:8080/crm`

![Внешний модуль](resources/img/external_module.png)

Для того, чтобы работали сопоставления нужно:

1. Остановить работу системы с помощью команды в терминале:

   ` /etc/init.d/arta-synergy-jboss stop`

2. В файл `/opt/synergy/jboss/standalone/configuration/arta/api-observation-configuration.xml` 
прописать очередь:

```xml
	<listener>
	 <queue>java:jboss/queues/Synergy/FormDataChange</queue>
	 <event>event.form.formdata.change</event>
	</listener>
	<listener>
	 <queue>java:jboss/queues/Synergy/LeadDelete</queue>
	 <event>crm.lead.delete</event>
	</listener>
```

3. Создать файл в `/opt/synergy/jboss/standalone/configuration/arta/apps/crm/crm.properties`
cо следующим содержимым:

```xml
	synergy.address=http://localhost:8080/Synergy
	user.login=логин
	user.password=пароль
```

4. В файл `/opt/synergy/jboss/standalone/configuration/standalone-onesynergy.xml`
добавить очередь:

```xml
		<jms-queue name="FormDataChange">
                   <entry name="queue/FormDataChange"/>
                   <entry name="java:jboss/queues/Synergy/FormDataChange"/>
                   <durable>true</durable>
                </jms-queue>
                <jms-queue name="LeadDelete">
                    <entry name="queue/LeadDelete"/>
                    <entry name="java:jboss/queues/Synergy/LeadDelete"/>
                    <durable>true</durable>
                </jms-queue>
```

5. Задеплоить crm.war (подробнее 
http://tdd.lan.arta.kz/docs/synergy/trunk/sdk-doc/html/integration.deploy.html).

   Задеплоить, т.е. скопировать в директорию ${jboss.home}/standalone/deployments. 
   Если приложение состоит из нескольких файлов, необходимо создать *.ear приложение.

   Затем необходимо предоставить права с помощью команды в терминале:

   `chown -R jboss:synergy opt/synergy/jboss/standalone/deployments`

6. Перезапустить jboss:

   `/etc/init.d/arta-synergy-jboss start`

> **Примечание:**
>
>Обязательно нужно добавить права пользователям на реестры для их отображения 
>в пользовательской части системы для модуля Хранилище.


