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

6.3 KiB
Raw Blame History

5. Требования к данным и интеграциям

5.1 Основные сущности данных

Система должна оперировать следующими основными сущностями:

  • пользователь
  • роль
  • контрагент
  • заявка на подключение
  • товар
  • складской остаток
  • корзина
  • заявка на заказ
  • заявка на расчет
  • заказ
  • событие изменения статуса
  • уведомление
  • бонусная связь
  • бонусная операция
  • заявка на использование либо вывод бонусов

5.2 Обязательные данные по сущностям

5.2.1 Пользователь

Обязательные данные:

  • идентификатор
  • имя
  • адрес электронной почты
  • телефон
  • роль
  • статус учетной записи
  • связанный контрагент
  • подключенные каналы уведомлений

5.2.2 Контрагент

Обязательные данные:

  • идентификатор
  • наименование компании
  • ИНН
  • КПП
  • юридический адрес
  • контактные лица
  • закрепленный менеджер

5.2.3 Товар

Обязательные данные:

  • идентификатор
  • SKU
  • наименование
  • тип продукции
  • набор параметров
  • доступные варианты
  • остатки по складам
  • признаки доступности и кастомизации

5.2.4 Заявка на заказ

Обязательные данные:

  • идентификатор
  • инициатор
  • дата и время создания
  • состав позиций
  • параметры позиций
  • количество
  • комментарий клиента
  • статус
  • закрепленный менеджер
  • стоимость после обработки
  • условия поставки после обработки

5.2.5 Заявка на расчет

Обязательные данные:

  • идентификатор
  • инициатор
  • дата и время создания
  • параметры изделия
  • комментарий клиента
  • статус
  • закрепленный менеджер
  • стоимость после обработки
  • условия поставки после обработки

5.2.6 Заказ

Обязательные данные:

  • внутренний идентификатор
  • внешний идентификатор учетной системы
  • статус
  • даты изменения
  • состав заказа
  • стоимость
  • условия поставки
  • ссылка на исходную клиентскую заявку

5.2.7 Бонусная операция

Обязательные данные:

  • идентификатор операции
  • связанный клиент
  • тип операции
  • сумма или объем операции
  • основание операции
  • дата и время операции
  • текущий статус операции

5.3 Требования к данным каталога

Для каждой позиции и для каждого товарного направления система должна хранить и отображать:

  • тип продукции
  • доступные параметры выбора
  • стандартные значения параметров
  • описания параметров
  • признаки доступности индивидуальной длины, втулки с логотипом и нанесения надписи
  • доступные варианты товара
  • остатки по складам
  • сведения об актуальности данных

5.4 Требования к интеграции с 1С

Интеграция с 1С должна обеспечивать обмен данными, необходимыми для сопровождения каталога и заказов.

Система должна обеспечивать получение из 1С следующих данных:

  • каталог товаров
  • характеристики товаров
  • складские остатки
  • сведения о заказах
  • статусы заказов
  • изменения состава, стоимости, доставки и иных существенных параметров заказа

5.5 Требования к интеграционному обмену

Интеграционный слой должен обеспечивать:

  • сопоставление внутренних идентификаторов и идентификаторов 1С
  • защиту от дублирования событий
  • регистрацию входящих и исходящих операций обмена
  • повторную обработку неуспешных сообщений
  • хранение истории обновлений по интеграционным операциям

5.6 Требования к журналированию данных

Для ключевых действий и изменений система должна сохранять:

  • тип объекта
  • идентификатор объекта
  • предыдущее состояние объекта
  • новое состояние объекта
  • дату и время изменения
  • пользователя либо источник, выполнивший изменение

5.7 Требования к данным бонусного контура

Для бонусной и реферальной программы система должна хранить:

  • текущий бонусный баланс клиента
  • историю начислений
  • историю списаний
  • историю использования бонусов
  • реферальные связи
  • заявки на использование либо вывод бонусов
  • статусы обработки таких заявок