# 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 Требования к данным бонусного контура

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

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