Expand technical specification architecture and prototypes

This commit is contained in:
Ruslan Bakiev
2026-05-01 12:02:16 +07:00
parent 46bb36d63c
commit fccb3039bf
8 changed files with 552 additions and 48 deletions

View File

@@ -1,6 +1,32 @@
# 7. Экранные формы и прототипы интерфейсов
# 9. Экранные формы и прототипы интерфейсов
## 7.1 Общие требования к экранным формам
## 9.1 Карта экранов
Ниже приведен базовый состав экранов, подлежащих реализации и сопровождению в рамках программного продукта.
| Раздел | Маршрут | Роль | Назначение |
| --- | --- | --- | --- |
| Главная страница | `/` | клиент | стартовая точка, быстрые действия, актуальные события |
| Каталог | `/products` | клиент | выбор товарного направления |
| Карточка товара | `/products/[slug]` | клиент | выбор параметров, просмотр вариантов, добавление в корзину |
| Корзина | `/cart` | клиент | формирование и отправка заявки |
| Список заказов клиента | `/client-orders` | клиент | просмотр истории заявок и заказов |
| Карточка заказа клиента | `/client-orders/[id]` | клиент | просмотр статуса, состава, условий и истории |
| Профиль | `/profile` | клиент | базовые данные учетной записи |
| Контрагент | `/profile/counterparty` | клиент | реквизиты и юридические данные |
| Адреса доставки | `/profile/addresses` | клиент | адресный справочник |
| Уведомления | `/notifications` | клиент | история уведомлений |
| Бонусный кабинет | `/bonus-program` | клиент | баланс, история и бонусные действия |
| Список клиентов | `/clients` | менеджер | клиентская база |
| Карточка клиента | `/clients/[id]` | менеджер | данные компании, заказы, бонусы |
| Приглашение клиента | `/clients/invite` | менеджер | выдача приглашения на регистрацию |
| Список заказов | `/orders` | менеджер | обработка заказного контура |
| Карточка заказа | `/orders/[id]` | менеджер | обработка условий, статуса и доставки |
| Настройки каталога | `/catalog-settings` | суперменеджер | параметры товарных направлений |
| Настройки синхронизации | `/settings-sync` | суперменеджер | мониторинг и управление обменом |
| Бонусная система | `/bonus-system/*` | менеджер/суперменеджер | рефералы, транзакции, выводы |
## 9.2 Общие требования к экранным формам
Экранные формы должны обеспечивать:
@@ -16,9 +42,9 @@
- остатки и доступные варианты отображаются в наглядном виде
- пользователь понимает ограничения выбора и возможность кастомизации
## 7.2 Клиентские экранные формы
## 9.3 Клиентские экранные формы
### 7.2.1 Главная страница клиента
### 9.3.1 Главная страница клиента
Назначение страницы:
@@ -32,6 +58,7 @@
- блок актуальных заказов и заявок
- блок последних уведомлений
- блок бонусной информации при наличии подключенного бонусного контура
- индикатор статуса заполненности профиля клиента
Прототип:
@@ -49,7 +76,7 @@
+------------------------------------------------------------------+
```
### 7.2.2 Каталог продукции
### 9.3.2 Каталог продукции
Назначение страницы:
@@ -61,8 +88,22 @@
- заголовок раздела
- поиск при необходимости
- сетка карточек товарных направлений
- карточка каждого товарного направления с изображением и наименованием
- переход в карточку выбранного товарного направления
### 7.2.3 Карточка товара
Прототип:
```text
+------------------------------------------------------------------+
| Каталог |
+------------------------------------------------------------------+
| [Карточка: Упаковочный скотч] [Карточка: Алюминиевый скотч] |
| [Карточка: Крепп] [Карточка: Вспененный скотч] |
| [Карточка: Двусторонний ПП] [Карточка: Двусторонний PVC] |
+------------------------------------------------------------------+
```
### 9.3.3 Карточка товара
Назначение страницы:
@@ -80,6 +121,7 @@
- блок индивидуальных возможностей, если они разрешены
- блок добавления в корзину
- таблица доступных вариантов
- блок навигации к соседним товарным направлениям
Прототип:
@@ -89,9 +131,11 @@
| Алюминиевый скотч |
+------------------------------------------------------------------+
| Изображение товара | Выбор параметров |
| | ширина / длина / толщина |
| | цвет / надпись / доп. условия |
| | [В корзину] |
| | [48 мм] [75 мм] |
| | [10 м] [25 м] [50 м] |
| | [50 мкм] |
| | [Цвет] [Надпись] |
| | [В корзину] |
+------------------------------------------------------------------+
| Пояснения по параметрам |
| Длина указывается в метрах. При наличии разрешения допускается |
@@ -102,7 +146,24 @@
+------------------------------------------------------------------+
```
### 7.2.4 Корзина
Состав блока выбора параметров:
- ширина
- длина
- толщина
- тип втулки
- цвет
- надпись
- индивидуальные опции при наличии разрешения
Состав блока пояснений:
- описание каждого параметра простым деловым языком
- ограничения по индивидуальной длине
- правила по втулке с логотипом
- правила по нанесению индивидуальной надписи
### 9.3.4 Корзина
Назначение страницы:
@@ -117,8 +178,24 @@
- параметры и количество
- комментарий клиента
- действие отправки заявки
- выбранный адрес доставки
- итоговая сводка по количеству позиций
### 7.2.5 Карточка заявки или заказа
Прототип:
```text
+------------------------------------------------------------------+
| Корзина |
+------------------------------------------------------------------+
| SKU | Товар | Параметры | Количество | Удалить |
+------------------------------------------------------------------+
| Адрес доставки: [выбранный адрес] |
| Комментарий клиента: [........................................] |
| [Отправить заявку] |
+------------------------------------------------------------------+
```
### 9.3.5 Карточка заявки или заказа
Назначение страницы:
@@ -141,20 +218,51 @@
+------------------------------------------------------------------+
```
### 7.2.6 Список заказов
Состав страницы:
- номер документа
- статус
- состав позиций
- стоимость после публикации менеджером
- условия поставки и доставки
- история статусов
- системные комментарии
### 9.3.6 Страница логина и регистрации
Назначение страницы:
- запуск входа в систему
- запуск самостоятельной заявки на подключение
- запуск сценариев входа через мессенджеры
Состав страницы:
- форма запроса кода входа
- выбор канала входа
- ссылка на самостоятельную заявку на подключение
- блок пояснения по дальнейшему сценарию доступа
### 9.3.7 Список заказов
Назначение страницы:
- просмотр текущих и архивных заказов
- фильтрация по периоду и статусу
### 7.2.7 Уведомления
Состав страницы:
- фильтры
- таблица заказов
- переход в карточку конкретного заказа
### 9.3.8 Уведомления
Назначение страницы:
- просмотр истории уведомлений по заказам, заявкам и бонусным операциям
### 7.2.8 Бонусный кабинет
### 9.3.9 Бонусный кабинет
Назначение страницы:
@@ -168,17 +276,42 @@
- история начислений и списаний
- связанные реферальные сведения
- форма подачи заявки на использование либо вывод бонусов
- правила бонусной программы
## 7.3 Менеджерские экранные формы
Прототип:
### 7.3.1 Список клиентов
```text
+------------------------------------------------------------------+
| Бонусный кабинет |
+------------------------------------------------------------------+
| Текущий баланс |
+------------------------------------------------------------------+
| История операций |
| Дата | Тип | Основание | Сумма | Статус |
+------------------------------------------------------------------+
| Реферальные связи |
+------------------------------------------------------------------+
| [Подать заявку на использование / вывод] |
+------------------------------------------------------------------+
```
## 9.4 Менеджерские экранные формы
### 9.4.1 Список клиентов
Назначение страницы:
- просмотр клиентской базы
- переход в карточку конкретного клиента
### 7.3.2 Карточка клиента
Состав страницы:
- поиск и фильтры
- таблица клиентов
- индикаторы активности и количества заказов
- действие приглашения нового клиента
### 9.4.2 Карточка клиента
Назначение страницы:
@@ -186,7 +319,15 @@
- просмотр истории заявок и заказов
- просмотр бонусных и реферальных данных
### 7.3.3 Карточка обработки заявки
Состав страницы:
- карточка компании и контактных данных
- реквизиты контрагента
- список заказов клиента
- список бонусных операций
- связанные рефералы
### 9.4.3 Карточка обработки заявки
Назначение страницы:
@@ -211,15 +352,37 @@
+------------------------------------------------------------------+
```
### 7.3.4 Список заказов менеджера
Состав страницы:
- клиент и контрагент
- состав позиции или расчетный payload
- стоимость
- доставка
- комментарий менеджера
- история изменений
- блок действий со статусом
### 9.4.4 Список заказов менеджера
Назначение страницы:
- просмотр заказов по клиентам
- контроль статусов
- переход в карточку заказа
- фильтрация по статусам
- переход к обработке конкретного заказа
### 7.3.5 Настройки каталога
Прототип:
```text
+------------------------------------------------------------------+
| Заказы |
+------------------------------------------------------------------+
| Фильтры: [Статус] [Клиент] [Период] |
+------------------------------------------------------------------+
| Код | Клиент | Статус | Сумма | Менеджер | Дата |
+------------------------------------------------------------------+
```
### 9.4.5 Настройки каталога
Назначение страницы:
@@ -228,9 +391,24 @@
- управление возможностями кастомизации
- управление описаниями параметров
### 7.3.6 Настройки уведомлений и синхронизации
Состав страницы:
- список товарных направлений
- карточка настроек конкретного направления
- чекбоксы разрешений кастомизации
- списки стандартных параметров
- единое действие сохранения настроек
### 9.4.6 Настройки синхронизации и уведомлений
Назначение страницы:
- управление шаблонами уведомлений
- управление параметрами интеграционного обмена
Состав страницы:
- список шаблонов уведомлений
- каналы отправки
- статусы последних синхронизаций
- диагностическая информация по обмену