Files
web-frontend/docs/tz/data-integrations.md
2026-05-01 14:50:06 +07:00

176 lines
6.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 6. Требования к данным и интеграциям
## 6.1 Основные сущности данных
Система должна оперировать следующими основными сущностями:
- пользователь
- роль
- контрагент
- заявка на подключение
- товар
- складской остаток
- корзина
- заявка на заказ
- заявка на расчет
- заказ
- событие изменения статуса
- уведомление
- бонусная связь
- бонусная операция
- заявка на использование либо вывод бонусов
## 6.2 Обязательные данные по сущностям
### 6.2.1 Пользователь
Обязательные данные:
- идентификатор
- имя
- адрес электронной почты
- телефон
- роль
- статус учетной записи
- связанный контрагент
- подключенные каналы уведомлений
### 6.2.2 Контрагент
Обязательные данные:
- идентификатор
- наименование компании
- ИНН
- КПП
- юридический адрес
- контактные лица
- закрепленный менеджер
### 6.2.3 Товар
Обязательные данные:
- идентификатор
- SKU
- наименование
- тип продукции
- набор параметров
- доступные варианты
- остатки по складам
- признаки доступности и кастомизации
### 6.2.4 Заявка на заказ
Обязательные данные:
- идентификатор
- инициатор
- дата и время создания
- состав позиций
- параметры позиций
- количество
- комментарий клиента
- статус
- закрепленный менеджер
- стоимость после обработки
- условия поставки после обработки
### 6.2.5 Заявка на расчет
Обязательные данные:
- идентификатор
- инициатор
- дата и время создания
- параметры изделия
- комментарий клиента
- статус
- закрепленный менеджер
- стоимость после обработки
- условия поставки после обработки
### 6.2.6 Заказ
Обязательные данные:
- внутренний идентификатор
- внешний идентификатор учетной системы
- статус
- даты изменения
- состав заказа
- стоимость
- условия поставки
- ссылка на исходную клиентскую заявку
### 6.2.7 Бонусная операция
Обязательные данные:
- идентификатор операции
- связанный клиент
- тип операции
- сумма или объем операции
- основание операции
- дата и время операции
- текущий статус операции
## 6.3 Требования к данным каталога
Для каждой позиции и для каждого товарного направления система должна хранить и отображать:
- тип продукции
- доступные параметры выбора
- стандартные значения параметров
- описания параметров
- признаки доступности индивидуальной длины, втулки с логотипом и нанесения надписи
- доступные варианты товара
- остатки по складам
- сведения об актуальности данных
## 6.4 Требования к интеграции с 1С
Интеграция с 1С должна обеспечивать обмен данными, необходимыми для сопровождения каталога и заказов.
Система должна обеспечивать получение из 1С следующих данных:
- каталог товаров
- характеристики товаров
- складские остатки
- сведения о заказах
- статусы заказов
- изменения состава, стоимости, доставки и иных существенных параметров заказа
## 6.5 Требования к интеграционному обмену
Интеграционный слой должен обеспечивать:
- сопоставление внутренних идентификаторов и идентификаторов 1С
- защиту от дублирования событий
- регистрацию входящих и исходящих операций обмена
- повторную обработку неуспешных сообщений
- хранение истории обновлений по интеграционным операциям
## 6.6 Требования к журналированию данных
Для ключевых действий и изменений система должна сохранять:
- тип объекта
- идентификатор объекта
- предыдущее состояние объекта
- новое состояние объекта
- дату и время изменения
- пользователя либо источник, выполнивший изменение
## 6.7 Требования к данным бонусного контура
Для бонусной и реферальной программы система должна хранить:
- текущий бонусный баланс клиента
- историю начислений
- историю списаний
- историю использования бонусов
- реферальные связи
- заявки на использование либо вывод бонусов
- статусы обработки таких заявок