CRM16 user manual

.gitattributes

@@ -188,6 +188,7 @@ crm/user-manual/src/account.md -text
 crm/user-manual/src/appendix.md -text
 crm/user-manual/src/certificates.md -text svneol=unset#application/octet-stream
 crm/user-manual/src/commission.md -text
+crm/user-manual/src/commission_sales.md -text
 crm/user-manual/src/components.md -text
 crm/user-manual/src/contact.md -text svneol=unset#application/octet-stream
 crm/user-manual/src/contract_all.md -text
@@ -199,6 +200,11 @@ crm/user-manual/src/index.md -text
 crm/user-manual/src/invoice.md -text svneol=unset#text/plain
 crm/user-manual/src/lead.md -text
 crm/user-manual/src/lead_activity.md -text svneol=unset#application/octet-stream
+crm/user-manual/src/management.md -text
+crm/user-manual/src/management_cost_comission.md -text
+crm/user-manual/src/management_funnel.md -text
+crm/user-manual/src/management_pipeline.md -text
+crm/user-manual/src/management_sidePannel.md -text
 crm/user-manual/src/marketing.md -text
 crm/user-manual/src/marketing_cost_comission.md -text
 crm/user-manual/src/marketing_event.md -text

crm/user-manual/src/commission.md

-## Реестр "% комиссии" {#commission}
+## Реестр "% комиссии лидогенерации" {#commission}
 
-В реестре "% комиссии" отображается одна запись реестра, в 
+В реестре "% комиссии лидогенерации" отображается одна запись реестра, в 
 которой хранятся данные о проценте комиссии, получаемой 
 ответственным менеджером с каждой сделки. 
 
@@ -34,7 +34,7 @@
 вышеупомянутые компоненты. При необходимости удалить строку с 
 компонентами можно, кликнув на крестик в конце блока. 
     
-![% комиссии](resources/img/storage/commission.png)
+![% комиссии лидогенерации](resources/img/storage/commission.png)
 
 Для сохранения записи реестра необходимо нажать на кнопку "Сохранить". 
 

crm/user-manual/src/commission_sales.md

+## Реестр "% комиссии продаж" {#commission_sales}
+
+В реестре "% комиссии продаж" отображается одна запись реестра, в 
+которой хранятся данные о проценте комиссии, получаемой 
+ответственным менеджером с каждой сделки. 
+
+При выборе данного реестра в основной рабочей области отображается
+таблица со столбцами, настроенными разработчиком Synergy в конфигураторе.
+
+Для [типовой конфигурации](http://tdd.lan.arta.kz/docs/cases/crm/methodologist-manual/html/)
+доступно только редактирование существующей записи реестра. 
+В открывшемся окне записи реестра присутствует следующая 
+информация:
+
+-   *Дата начала.* Предназначена для фиксирования даты начала 
+    периода, для которого используется введенный % комиссии. Поле
+    неактивно для изменения, автоматически заполняется датой, 
+    когда добавили новый период (строку). 
+
+-   *Дата окончания.* Предназначена для фиксирования даты окончания
+    периода, для которого используется введенный % комиссии. Поле
+    неактивно для изменения, автоматически заполняется датой, 
+    когда добавили дату начала следующего периода (строку). То есть
+    дата начала последующего периода соответствует дате окончания 
+    предыдущего периода.
+
+-   *% комиссии* (обяз.). Представляет собой поле для ввода чисел.
+    В поле серым цветом отображается подсказка с текстом "Введите
+    число". Данное поле принимает только числа и некоторые символы
+    (точка, запятая).
+    
+Возможно указание нескольких периодов с комиссией, для этого 
+необходимо кликнуть по лейблу "+Добавить блок", после чего добавятся
+вышеупомянутые компоненты. При необходимости удалить строку с 
+компонентами можно, кликнув на крестик в конце блока. 
+    
+![% комиссии продаж](resources/img/storage/commission_sales.png)
+
+Для сохранения записи реестра необходимо нажать на кнопку "Сохранить". 
+
+Для перехода в режим просмотра используется кнопка "Режим редактирования".
+При повторном нажатии на нее запись реестра отображается в режиме 
+редактирования.
+

crm/user-manual/src/dictionaries.md

@@ -55,19 +55,20 @@
 
 #### Статусы сделки {#dictionaryDealStatus}
 
-+-------+--------------------------------+
-| **№** | **Название**                   |
-+=======+================================+
-| 1     | Уточнение потребности          |
-+-------+--------------------------------+
-| 2     | Подготовка предложения         |
-+-------+--------------------------------+
-| 3     | Защита предложения             |
-+-------+--------------------------------+
-| 4     | Закрытие сделки                |
-+-------+--------------------------------+
-| 5     | Отказ                          |
-+-------+--------------------------------+
++--------------------------------+-----------------------------+----------------+-------------------+-------------------+
+| **Название**                   | **Порядковый номер пункта** | **Качество**   | **Законченность** | **Цвет панели в** |
+|                                | **в выпадающем списке**     |                |                   | **воронке**       |
++================================+=============================+================+===================+===================+
+| Уточнение потребности          | 1                           | Качественный   | Не конечный       | `#ee902d`         |
++--------------------------------+-----------------------------+----------------+-------------------+-------------------+
+| Подготовка приложения          | 2                           | Качественный   | Не конечный       | `#f3c02d`         |
++--------------------------------+-----------------------------+----------------+-------------------+-------------------+
+| Защита предложения             | 3                           | Качественный   | Не конечный       | `#c9d02c`         |
++--------------------------------+-----------------------------+----------------+-------------------+-------------------+
+| Закрытие сделки                | 4                           | Качественный   | Конечный          | `#9fcb2c`         |
++--------------------------------+-----------------------------+----------------+-------------------+-------------------+
+| Отказ                          | 5                           | Некачественный |                   | `#b82b2b`         |
++--------------------------------+-----------------------------+----------------+-------------------+-------------------+
 
 #### Статусы аккаунта {#dictionaryAccountStatus}
 

crm/user-manual/src/index.md

@@ -4,12 +4,14 @@ author:
 - Олеся Хусаинова
 - Айгерим Шауменова
 - Кристина Маркова
+- Гульнур Ережеева
 title: Система управления взаимоотношениями с клиентами. Руководство пользователя
 ...
 
 <#include "about.md">
 <#include "storage.md">
 <#include "marketing.md">
+<#include "management.md">
 <#include "appendix.md">
 
 

crm/user-manual/src/management.md

+Внешний модуль "Управление продажами" {#sec.sales_management}
+===============================================
+
+Внешний модуль содержит компоненты:
+
+*   Групповые кнопки, переключающие вид отображения воронки:
+
+	*   [Воронка](#management.funnel)
+
+	*   [Канбан](#management.pipeline)
+
+*   [Панели стоимости и комиссии](#management.cost_comission)
+
+*   [Боковая панель](#management.sidePannel)
+
+	*   [Пользователи](#management.users)
+
+	*   [Фильтры](#management.filters)
+
+<#include "management_funnel.md">
+<#include "management_pipeline.md">
+<#include "management_cost_comission.md">
+<#include "management_sidePannel.md">
+

crm/user-manual/src/management_cost_comission.md

+### Панели стоимости и комиссии {#management.cost_comission}
+
+1.  Стоимость продаж в панели - сумма значений компонента
+    [Бюджет](#deal) всех сделок текущей воронки.
+
+2.  Комиссия лидогенерации в панели рассчитывается как:
+
+    `стоимость продаж * % комиссии продаж`
+
+    где `% комиссии продаж` - значение поля "% комиссии" первой созданной записи
+    реестра [% комиссии продаж](#commission_sales).
+
+> Значение комиссии в панели округляется до целого.
+
+1.  Значение поля "% комиссии" для каждого отдельной сделки идет в расчет
+    согласно значению поля "Законченность" записи справочника
+    [Статусы сделки](#dictionaryDealStatus):
+
+	*   "Законченность"=1 - % комиссии на момент сохранения этого статуса;
+
+	*   остальные - % комиссии на конец [рассматриваемого периода](#management.filters).
+
+2.  При смене статуса сделки на запись справочника [Статусы сделки](#dictionaryDealStatus), 
+    у которой "Законченность"=1, для нее сохраняется текущий % комиссии. Он будет 
+    использоваться в расчете, даже если строка динамической таблицы с таким % будет 
+    удалена.
+
+3.  Если в записи реестра [% комиссии продаж](#commission_sales) указано
+    несколько записей с одинаковыми датами начала, то в расчет идет
+    последний % комиссии, удовлетворяющий требованиям.
+
+

crm/user-manual/src/management_funnel.md

+### Воронка продаж {#management.funnel}
+
+По нажатию на кнопку "Воронка" вид основной области изменяется на воронку
+продаж. Воронка представлена в виде кнопок статусов сделок, определяемых
+в Конфигураторе (илл. "Воронка продаж").
+
+![Воронка продаж](resources/img/management_funnel_1.png)
+
+Кнопки статусов имеют форму трапеции и содержат два типа значений:
+
+*   количество сделок данного статуса;
+
+*   коэффициент конвертации.
+
+Ширина кнопок статична, высота пропорционально максимальной высоте воронки.
+
+> **Примечание 1:** коэффициент конвертации отсутствует для кнопки первого статуса.
+
+> **Примечание 2:** коэффициент конвертации рассчитывается как:
+>
+>количество сделок последующего статуса / количество сделок предыдущего статуса * 100%.
+
+> **Примечание 3:** изменение высоты кнопок, количества сделок и коэффициентов
+конвертации происходит в режиме реального времени.
+
+Если воронка содержит один статус, то его кнопка также отображается в виде
+трапеции на максимальную высоту всей воронки (илл. "Воронка продаж
+для статуса **Отказ**):
+
+![Воронка продаж для статуса "Отказ"](resources/img/management_funnel_2.png)
+
+Если не выбран ни один [пользователь](#management.users), то воронка отображается 
+пустой (илл. "Пустая воронка продаж"):
+
+*   значения количества сделок и коэффициента конвертации - 0;
+
+*   кнопки имеют минимальную высоту.
+
+![Пустая воронка продаж](resources/img/management_funnel_3.png)
+

crm/user-manual/src/management_pipeline.md

+### Канбан {#management.pipeline}
+
+По нажатию на кнопку "Канбан" вид основной области изменяется на канбан
+продаж, который является развернутым представлением воронки
+продаж с детализацией сведений о сделках (илл. "Канбан продаж"):
+
+![Канбан продаж](resources/img/management_canban_1.png)
+
+> [Канбан (Kanban)](https://ru.wikipedia.org/wiki/%D0%9A%D0%B0%D0%BD%D0%B1%D0%B0%D0%BD) -
+методология управления производством. Одним из ее инструментов является доска, где все
+текущие задачи распределены по столбцам, соответствующим стадиям производства. При
+условии своевременной актуализации расположения задач на этой доске такой подход наглядно
+отображает общий статус производства и позволяет своевременно корректировать возможные
+отставания от плана.
+
+Основная рабочая область содержит панели сделок, расположенные в виде таблицы, где:
+
+*   столбцы - статусы сделок (значения поля "Тип" справочника [Статусы сделки](#dictionaryDealStatus))
+согласно текущей [фильтрации](#management.filters);
+
+*   строки - сделки.
+
+Панели статусов окрашены в цвета, указанные в поле "Цвет панели в воронке"
+справочника [Статусы сделки](#dictionaryDealStatus).
+
+Панели сделок отсортированы в столбце по убыванию значений компонента
+[Бюджет](#deal) всех сделок текущего статуса.
+
+Переместить панели сделки можно из всех столцов в любой столбец без исключений.
+
+При перемещении панели сделки между стоблцами изменяется значение поля "Статус"
+данной записи реестра [Сделка](#deal) согласно новому статусу (столбцу таблицы).
+
+Панель статуса содержит:
+
+*   Значение поля "Тип" (согласно справочнику [Статусы сделки](#dictionaryDealStatus))
+
+*   Количество сделок данного статуса
+
+*   Сумма значений компонента [Бюджет](#deal) всех сделок текущего статуса.
+
+Панель сделки содержит значение полей:
+
+- [Наименование аккаунта](#account)
+
+- [Тема сотрудничества](#deal)
+
+- [Бюджет](#deal)
+
+- [Ответственный менеджер](#deal)
+
+По нажатию на панель сделки откроется соответствующая запись реестра [Сделка](#deal).
+
+Если таблица содержит один статус, то ее столбец отображается на ширину всей рабочей 
+области:
+
+![Канбан статуса "Отказ"](resources/img/management_canban_2.png)
+
+**Примечание 1:** имеется возможность перемещения панелей сделок горизонтально между 
+столбцами при помощи drag-n-drop.
+
+**Примечание 2 :** цвет фона [наименования аккаунта](#account) в панели соответствует
+цвету воронки для выбранного статуса согласно справочнику [Статусы сделки](#dictionaryDealStatus)
+прозрачностью 30%.
+

crm/user-manual/src/management_sidePannel.md

+### Боковая панель {#management.sidePannel}
+
+Боковая панель предназначена для фильтрации сведений о сделках, которые 
+должны включаться в воронку/канбан продаж.
+
+Доступна настройка следующих параметров отображения:
+
+- [пользователи](#management.users)
+
+- [фильтры](#management.filters)
+
+#### Пользователи {#management.users}
+
+Параметр содержит авторизованного пользователя, а также его подчиненных, 
+которые входят в группу "Отдел продаж". Доступен множественный выбор пользователей.
+По умолчанию выбран авторизованного пользователя.
+
+#### Фильтры {#management.filters}
+
+Доступно три параметра фильтрации:
+
+*   Период
+
+*   Статус лида
+
+*   Стоимость
+
+При фильтрации сделок за период учитывается только факт смены значения в поле "Статус" 
+записи реестра [Сделка](#deal). Если за указанный период значение этого поля 
+изменялось несколько раз, то в воронке учитывается только последнее изменение.
+
+Параметр **"Период"** представлен выпадающим списком и двумя компонентами выбора даты, 
+разделенными тире. 
+
+Выпадающий список периода содержит пункты:
+
+*   *"За все время"* - воронка содержит все лиды с момента создания записи реестра 
+до текущего времени на сервере.
+
+*   *"Прошедшая неделя"* - учитываются только те лиды, у которых изменился статус 
+за последнюю неделю от текущего дня на сервере.
+
+*   *"Прошедший месяц"* - учитываются только те лиды, у которых изменился статус 
+за последний месяц от текущего дня на сервере.
+
+*   *"Прошедший квартал"* - учитываются только те лиды, у которых изменился статус 
+за последний квартал от текущего дня на сервере.
+
+*   *"Прошедший год"* - учитываются только те лиды, у которых изменился статус за 
+последний год от текущего дня на сервере.
+
+*   *"Произвольный период"* - учитываются только те лиды, у которых изменился статус 
+за указанный пользователем период. При выборе этого пункта активны компоненты выбора 
+даты.
+
+Параметр **"Статус"** представлен выпадающим списком с пунктами:
+
+- *"Все"* (включает в себя все записи справочника [Статусы сделки](#dictionaryDealStatus)
+  со значением 0 в поле "Законченность");
+
+- значение поля "Тип" из справочника [Статусы сделки](#dictionaryDealStatus), у которой
+  значение поля "Законченность" равно 1;
+
+- значения поля "Тип" всех записей справочника [Статусы сделки](#dictionaryDealStatus), 
+  у которой значение поля "Законченность" равно 0.
+
+Параметр **"Стоимость"** представлен двумя числовыми полями:
+
+- минимальная граница значения поля [Бюджет](#deal) всех сделок;
+
+- максимальная граница значения поля [Бюджет](#deal) всех сделок.
+
+По умолчанию выбраны:
+
+- Период - "За все время"
+
+- Статус - "Все"
+
+- Стоимость:
+
+	-   от - минимальная значение поля [Бюджет](#deal)
+
+	-   до - максимальная значение поля [Бюджет](#deal)
+
+

crm/user-manual/src/marketing_funnel.md

@@ -29,9 +29,9 @@
 
 ![Воронка лидогенерации для статуса "Некачественный лид"](resources/img/funnel_3.png)
 
-Если не выбран ни один [пользователь](#marketing.users) и ни одно [мероприятие](#marketing.event)
-(при выключенном флаге "Показывать лиды, не привязанные к мероприятиям"),
-воронка отображается пустой (илл. "Пустая воронка лидогенерации"):
+Если не выбран ни один [пользователь](#marketing.users) и ни одно 
+[мероприятие](#marketing.event) (при выключенном флаге "Показывать сделки, не привязанные 
+к мероприятиям"), воронка отображается пустой (илл. "Пустая воронка продаж"):
 
 *   значения количества лидов и коэффициента конвертации - 0;
 

crm/user-manual/src/storage.md

@@ -20,7 +20,9 @@
 
 -   [Счет-фактуры](#invoices)
 
--   [% комиссии](#commission)
+-   [% комиссии лидогенерации](#commission)
+
+-   [% комиссии продаж](#commission_sales)
 
 -   [Аккаунты](#account)
 
@@ -38,6 +40,7 @@
 <#include "contact.md">
 <#include "deal.md">
 <#include "commission.md">
+<#include "commission_sales.md">
 <#include "contract_all.md">
 <#include "contract_part.md">
 <#include "certificates.md">