Редактирование

Markdown (tb.md)

# [б24/RMS/1C] Процесс создания сервисного центра (СЦ) со складами через Bitrix24

> **Процесс уровня:** L2 (Детальный процесс)
> **Категория:** Operational
> **Методология:** TO-BE Only
> **Способ проектирования:** Collaborative
> **Дата создания:** 2023-10-27
> **Статус:** Draft
---

## Цель процесса

Обеспечить автоматизированный процесс создания сервисного центра (СЦ) и связанных сущностей (адрес, склады, подразделения) через Bitrix24 с корректной синхронизацией между системами: Bitrix24, Comunda, RMS, 1С, Dadata.

---

## Глоссарий и термины

| Термин | Определение |
|--------|-------------|
| **СЦ** | Сервисный центр |
| **Bitrix24** | Система для запуска процесса и ввода данных |
| **Comunda** | Оркестратор процесса, координирующий взаимодействие систем |
| **Dadata** | Адресный сервис для нормализации адресов |
| **RMS** | Система управления сервисными центрами |
| **1С** | Система для создания подразделений, цехов и складов |
| **Org Registry** | Система для хранения адресов |
| **Франчайзи** | Партнер, к которому привязывается СЦ |

---

## Роли процесса

- **Руководитель процесса** — Инициатор процесса, пользователь Bitrix24.
- **Bitrix24** (система) — Система для запуска процесса и ввода данных.
- **Comunda** (система) — Оркестратор процесса.
- **Dadata** (система) — Адресный сервис.
- **RMS** (система) — Система управления сервисными центрами.
- **1С** (система) — Система учета и управления.
- **Org Registry** (система) — Система для хранения адресов.

---

## Шаги процесса

### БЛОК 1: Инициация и обогащение данных

### `Step-1`: Запуск процесса создания СЦ
- **Тип:** userTask
- **Ответственный:** Руководитель процесса
- **Вход:** -
- **Trigger:** Руководитель запускает процесс создания СЦ в Bitrix24.
- **Описание:** Руководитель процесса инициирует создание нового сервисного центра в системе Bitrix24.
- **Действия:**
  1. Запустить процесс в Bitrix24.
  2. Указать адрес СЦ.
  3. Указать франчайзи.
  4. Указать директора СЦ.
- **Выход:** Запрос на создание СЦ с входными данными.
- **Система:** Bitrix24
- **Автоматизация:** Ручная
- **Время:** Не указано
- **Следующие шаги:** `Step-2`

### `Step-2`: Передача данных в Comunda
- **Тип:** serviceTask
- **Ответственный:** Bitrix24
- **Вход:** Запрос на создание СЦ с входными данными (адрес, франчайзи, директор СЦ).
- **Trigger:** Процесс запущен в Bitrix24.
- **Описание:** Bitrix24 передает полученные от пользователя данные в Comunda для дальнейшей оркестрации процесса.
- **Действия:**
  1. Передать данные в Comunda.
- **Выход:** Данные для Comunda.
- **Система:** Bitrix24, Comunda
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-3`

### `Step-3`: Запрос нормализованного адреса в Dadata
- **Тип:** serviceTask
- **Ответственный:** Comunda
- **Вход:** Адрес СЦ.
- **Trigger:** Данные переданы в Comunda.
- **Описание:** Comunda отправляет запрос в Dadata для получения нормализованного адреса и дополнительных атрибутов.
- **Действия:**
  1. Отправить запрос в Dadata с адресом СЦ.
- **Выход:** Запрос в Dadata.
- **Система:** Comunda, Dadata
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-4`

### `Step-4`: Получение нормализованного адреса
- **Тип:** serviceTask
- **Ответственный:** Dadata
- **Вход:** Запрос от Comunda.
- **Trigger:** Comunda отправила запрос в Dadata.
- **Описание:** Dadata обрабатывает запрос и возвращает нормализованный адрес, город и другие атрибуты.
- **Действия:**
  1. Вернуть нормализованный адрес.
  2. Вернуть город.
  3. Вернуть дополнительные атрибуты адреса.
- **Выход:** Нормализованный адрес, город, дополнительные атрибуты.
- **Система:** Dadata, Comunda
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-5`

### БЛОК 2: Создание СЦ и связанных сущностей

### `Step-5`: Формирование названия СЦ
- **Тип:** serviceTask
- **Ответственный:** Comunda
- **Вход:** Нормализованный адрес, город.
- **Trigger:** Получен нормализованный адрес.
- **Описание:** Comunda формирует название СЦ в формате "Serviceme + город". Если в городе уже есть СЦ, добавляется инкремент.
- **Действия:**
  1. Сформировать название СЦ: "Serviceme + город".
  2. Проверить наличие СЦ с таким названием в городе.
  3. При необходимости добавить инкремент (например, "Serviceme Владикавказ 2").
- **Выход:** Сформированное название СЦ.
- **Система:** Comunda
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-6`

### `Step-6`: Создание СЦ в RMS
- **Тип:** serviceTask
- **Ответственный:** Comunda
- **Вход:** Сформированное название СЦ, франчайзи.
- **Trigger:** Сформировано название СЦ.
- **Описание:** Comunda создает новый сервисный центр в системе RMS и привязывает его к выбранному франчайзи.
- **Действия:**
  1. Создать СЦ в RMS.
  2. Привязать СЦ к выбранному франчайзи.
- **Выход:** Созданный СЦ в RMS.
- **Система:** Comunda, RMS
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-7`

### `Step-7`: Создание адреса в Org Registry
- **Тип:** serviceTask
- **Ответственный:** Comunda
- **Вход:** Нормализованный адрес.
- **Trigger:** Создан СЦ в RMS.
- **Описание:** Comunda создает запись об адресе в системе Org Registry.
- **Действия:**
  1. Создать адрес в Org Registry.
- **Выход:** Созданный адрес в Org Registry.
- **Система:** Comunda, Org Registry
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-8`

### `Step-8`: Инициирование создания сущностей в 1С
- **Тип:** serviceTask
- **Ответственный:** Comunda
- **Вход:** Адрес, франчайзи.
- **Trigger:** Создан адрес в Org Registry.
- **Описание:** Comunda инициирует создание подразделений, цехов и складов в системе 1С на основе адреса и франчайзи.
- **Действия:**
  1. Инициировать создание подразделений в 1С.
  2. Инициировать создание цехов в 1С.
  3. Инициировать создание складов в 1С.
- **Выход:** Запрос на создание сущностей в 1С.
- **Система:** Comunda, 1С
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-9`

### `Step-9`: Возврат данных по складам из 1С
- **Тип:** serviceTask
- **Ответственный:** 1С
- **Вход:** Запрос на создание сущностей.
- **Trigger:** Сущности созданы в 1С.
- **Описание:** После создания подразделений, цехов и складов, 1С возвращает идентификаторы созданных складов в Comunda.
- **Действия:**
  1. Вернуть идентификаторы созданных складов в Comunda.
- **Выход:** Идентификаторы складов.
- **Система:** 1С, Comunda
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-10`

### `Step-10`: Создание складов в RMS
- **Тип:** serviceTask
- **Ответственный:** Comunda
- **Вход:** Идентификаторы складов из 1С, созданный СЦ в RMS.
- **Trigger:** Получены идентификаторы складов из 1С.
- **Описание:** Comunda создает склады в RMS, используя полученные идентификаторы, и привязывает их к соответствующему СЦ, устанавливая корректные связи.
- **Действия:**
  1. Создать склады в RMS.
  2. Привязать склады к СЦ.
  3. Установить корректные связи.
- **Выход:** Созданные склады в RMS, привязанные к СЦ.
- **Система:** Comunda, RMS
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `Step-11`

### `Step-11`: Инициализация остатков
- **Тип:** serviceTask
- **Ответственный:** RMS
- **Вход:** Созданные склады в RMS.
- **Trigger:** Склады созданы в RMS.
- **Описание:** Для корректной работы складского учета создается перемещение "с себя на себя" с датой перемещения "-1 день" для инициализации остатков.
- **Действия:**
  1. Создать перемещение "с себя на себя".
  2. Установить дату перемещения "-1 день".
- **Выход:** Инициализированные остатки на складах.
- **Система:** RMS
- **Автоматизация:** Полная
- **Время:** Не указано
- **Следующие шаги:** `END-ready`

---

## Конечные события (End Events)

| ID | Маршрут | Результат |
|----|---------|-----------|
| `END-ready` | От `Step-11` | СЦ создан в RMS, адрес нормализован, подразделения, цеха и склады созданы в 1С, склады созданы и привязаны в RMS, инициализирован складской учёт, все системы находятся в консистентном состоянии. |

---

## Бизнес-правила

| ID | Правило | Затронутые шаги |
|----|---------|-----------------|
| BR-1 | СЦ создаётся только через процесс в Bitrix24. | `Step-1` |
| BR-2 | Название СЦ формируется автоматически в формате `Serviceme + город`. Если в городе уже есть СЦ, добавляется инкремент. | `Step-5` |
| BR-3 | Все сущности должны быть синхронизированы между системами. | `Step-2`, `Step-3`, `Step-4`, `Step-5`, `Step-6`, `Step-7`, `Step-8`, `Step-9`, `Step-10` |
| BR-4 | Склад в RMS создаётся только после получения данных из 1С. | `Step-10` |
| BR-5 | Все связи (СЦ ↔ склады ↔ франчайзи) должны быть консистентны. | `Step-6`, `Step-10` |

---

## Mermaid-диаграмма процесса

```mermaid
graph TD
    A[Руководитель запускает процесс в Bitrix24] --> B(Bitrix24 передает данные в Comunda);
    B --> C{Comunda запрашивает нормализованный адрес в Dadata};
    C --> D[Dadata возвращает нормализованный адрес];
    D --> E{Comunda формирует название СЦ};
    E --> F[Comunda создает СЦ в RMS];
    F --> G[Comunda создает адрес в Org Registry];
    G --> H{Comunda инициирует создание сущностей в 1С};
    H --> I[1С возвращает данные по складам в Comunda];
    I --> J{Comunda создает склады в RMS};
    J --> K[RMS инициализирует остатки];
    K --> END-ready(СЦ успешно создан);

classDef endEvent fill:#FFF,stroke:#333,stroke-width:2px,color:#333;
    class END-ready endEvent;
```

---

## Роли и ответственность (RACI)

| Шаг | Responsible | Accountable | Consulted | Informed | Автоматизация |
|-----|------------|-------------|-----------|----------|---------------|
| `Step-1` | Руководитель процесса | Руководитель процесса | - | - | Ручная |
| `Step-2` | Bitrix24 | Comunda | - | - | Полная |
| `Step-3` | Comunda | Comunda | Dadata | - | Полная |
| `Step-4` | Dadata | Comunda | - | - | Полная |
| `Step-5` | Comunda | Comunda | - | - | Полная |
| `Step-6` | Comunda | Comunda | RMS | - | Полная |
| `Step-7` | Comunda | Comunda | Org Registry | - | Полная |
| `Step-8` | Comunda | Comunda | 1С | - | Полная |
| `Step-9` | 1С | Comunda | - | - | Полная |
| `Step-10` | Comunda | Comunda | RMS | - | Полная |
| `Step-11` | RMS | Comunda | - | - | Полная |

---

## Системы и интеграции

| ID | Интеграция | Источник | Целевая система | Данные | Сложность |
|----|-----------|----------|----------------|--------|-----------|
| INT-1 | Запуск процесса | Bitrix24 | Comunda | Адрес СЦ, франчайзи, директор СЦ | Средняя |
| INT-2 | Обогащение адреса | Comunda | Dadata | Адрес СЦ | Средняя |
| INT-3 | Создание СЦ | Comunda | RMS | Название СЦ, франчайзи | Средняя |
| INT-4 | Создание адреса | Comunda | Org Registry | Нормализованный адрес | Средняя |
| INT-5 | Создание сущностей 1С | Comunda | 1С | Адрес, франчайзи | Высокая |
| INT-6 | Возврат данных 1С | 1С | Comunda | Идентификаторы складов | Высокая |
| INT-7 | Создание складов RMS | Comunda | RMS | Идентификаторы складов, СЦ | Средняя |
| INT-8 | Инициализация остатков | RMS | RMS | Данные о складах | Низкая |

---

## Сводка

| Метрика | Значение |
|---------|----------|
| Всего шагов | 11 |
| Всего шлюзов | 0 |
| Конечных событий | 1 |

Mermaid Preview

Редактирование tb.md