Expand entities and page prototypes in specification

This commit is contained in:
Ruslan Bakiev
2026-05-01 15:51:51 +07:00
parent 58e9d6806d
commit e050fd55a5
2 changed files with 501 additions and 117 deletions

View File

@@ -26,7 +26,59 @@
| Настройки синхронизации | `/settings-sync` | суперменеджер | мониторинг и управление обменом |
| Бонусная система | `/bonus-system/*` | менеджер/суперменеджер | рефералы, транзакции, выводы |
## 5.2 Общие требования к экранным формам
## 5.2 Текущие маршруты и экранные формы по реализации
Ниже приведен перечень фактически существующих страниц текущего frontend-контура.
### 5.2.1 Публичные и клиентские страницы
| Маршрут | Экран | Назначение |
| --- | --- | --- |
| `/` | Главная страница | Стартовая страница личного кабинета |
| `/login` | Вход | Вход и первичный сценарий доступа |
| `/products` | Каталог продукции | Список товарных направлений |
| `/products/[slug]` | Карточка товара | Выбор параметров, просмотр вариантов, добавление в корзину |
| `/cart` | Корзина | Состав выбранных позиций и отправка заявки |
| `/client-orders` | Список заказов клиента | История заявок и заказов клиента |
| `/client-orders/[id]` | Карточка заказа клиента | Детали конкретного заказа клиента |
| `/notifications` | Уведомления | Список системных уведомлений |
| `/bonus-program` | Бонусный кабинет | Бонусный баланс, подарочные карты и бонусные действия |
### 5.2.2 Профиль клиента
| Маршрут | Экран | Назначение |
| --- | --- | --- |
| `/profile` | Профиль | Основные данные пользователя |
| `/profile/counterparty` | Реквизиты контрагента | Юридические и банковские данные |
| `/profile/addresses` | Адреса доставки | Список адресов доставки |
| `/profile/addresses/new` | Новый адрес доставки | Создание адреса доставки |
| `/profile/notifications` | Настройки уведомлений | Подключение и настройка каналов уведомлений |
| `/profile/notifications/success` | Успешное подключение уведомлений | Финальный экран сценария подключения канала |
### 5.2.3 Менеджерские и административные страницы
| Маршрут | Экран | Назначение |
| --- | --- | --- |
| `/clients` | Клиенты | Список клиентских компаний и пользователей |
| `/clients/[id]` | Карточка клиента | Детали клиента, его заказы и бонусные данные |
| `/clients/invite` | Пригласить клиента | Создание приглашения на регистрацию |
| `/orders` | Список заказов | Очередь заказов и заявок для менеджера |
| `/orders/[id]` | Карточка заказа | Обработка стоимости, условий поставки и статуса |
| `/catalog-settings` | Настройки каталога | Параметры товарных направлений и кастомизации |
| `/settings-sync` | 1С / синхронизация | Управление и мониторинг синхронизации |
| `/messages` | Сообщения | Шаблоны и тексты менеджерских сообщений |
### 5.2.4 Бонусный менеджерский контур
| Маршрут | Экран | Назначение |
| --- | --- | --- |
| `/bonus-system` | Бонусная система | Список клиентов и бонусных сущностей |
| `/bonus-system/[userId]` | Карточка бонусного счета клиента | История и состояние бонусного счета |
| `/bonus-system/referrals/new` | Создать бонусный счет | Создание реферальной связи |
| `/bonus-system/transactions/new` | Добавить бонусную транзакцию | Ручное начисление или списание |
| `/bonus-system/withdrawals/[id]` | Проверка заявки на вывод | Рассмотрение заявки клиента на вывод бонусов |
## 5.3 Общие требования к экранным формам
Экранные формы должны обеспечивать:
@@ -42,9 +94,9 @@
- остатки и доступные варианты отображаются в наглядном виде
- пользователь понимает ограничения выбора и возможность кастомизации
## 5.3 Клиентские экранные формы
## 5.4 Клиентские экранные формы
### 5.3.1 Главная страница клиента
### 5.4.1 Главная страница клиента
Назначение страницы:
@@ -64,7 +116,7 @@
![Прототип главной страницы клиента](/prototypes/dashboard.svg)
### 5.3.2 Каталог продукции
### 5.4.2 Каталог продукции
Назначение страницы:
@@ -83,7 +135,7 @@
![Прототип каталога продукции](/prototypes/catalog-grid.svg)
### 5.3.3 Карточка товара
### 5.4.3 Карточка товара
Назначение страницы:
@@ -103,6 +155,10 @@
- таблица доступных вариантов
- блок навигации к соседним товарным направлениям
Текущий маршрут реализации:
- `/products/[slug]`
Схематичный прототип:
![Прототип карточки товара](/prototypes/product-card.svg)
@@ -124,7 +180,7 @@
- правила по втулке с логотипом
- правила по нанесению индивидуальной надписи
### 5.3.4 Корзина
### 5.4.4 Корзина
Назначение страницы:
@@ -146,7 +202,7 @@
![Прототип корзины](/prototypes/cart.svg)
### 5.3.5 Карточка заявки или заказа
### 5.4.5 Карточка заявки или заказа
Назначение страницы:
@@ -169,7 +225,7 @@
- история статусов
- системные комментарии
### 5.3.6 Страница логина и регистрации
### 5.4.6 Страница логина и регистрации
Назначение страницы:
@@ -184,7 +240,7 @@
- ссылка на самостоятельную заявку на подключение
- блок пояснения по дальнейшему сценарию доступа
### 5.3.7 Список заказов
### 5.4.7 Список заказов
Назначение страницы:
@@ -197,13 +253,13 @@
- таблица заказов
- переход в карточку конкретного заказа
### 5.3.8 Уведомления
### 5.4.8 Уведомления
Назначение страницы:
- просмотр истории уведомлений по заказам, заявкам и бонусным операциям
### 5.3.9 Бонусный кабинет
### 5.4.9 Бонусный кабинет
Назначение страницы:
@@ -223,9 +279,9 @@
![Прототип бонусного кабинета](/prototypes/bonus-cabinet.svg)
## 5.4 Менеджерские экранные формы
## 5.5 Менеджерские экранные формы
### 5.4.1 Список клиентов
### 5.5.1 Список клиентов
Назначение страницы:
@@ -239,7 +295,7 @@
- индикаторы активности и количества заказов
- действие приглашения нового клиента
### 5.4.2 Карточка клиента
### 5.5.2 Карточка клиента
Назначение страницы:
@@ -255,7 +311,7 @@
- список бонусных операций
- связанные рефералы
### 5.4.3 Карточка обработки заявки
### 5.5.3 Карточка обработки заявки
Назначение страницы:
@@ -278,7 +334,7 @@
- история изменений
- блок действий со статусом
### 5.4.4 Список заказов менеджера
### 5.5.4 Список заказов менеджера
Назначение страницы:
@@ -290,7 +346,7 @@
![Прототип списка заказов менеджера](/prototypes/manager-orders.svg)
### 5.4.5 Настройки каталога
### 5.5.5 Настройки каталога
Назначение страницы:
@@ -307,7 +363,7 @@
- списки стандартных параметров
- единое действие сохранения настроек
### 5.4.6 Настройки синхронизации и уведомлений
### 5.5.6 Настройки синхронизации и уведомлений
Назначение страницы:
@@ -320,3 +376,20 @@
- каналы отправки
- статусы последних синхронизаций
- диагностическая информация по обмену
## 5.6 Дополнительные профильные и сервисные страницы
Помимо основных клиентских и менеджерских экранов, текущая реализация содержит дополнительные экранные формы:
- профиль пользователя
- реквизиты контрагента
- список адресов доставки
- создание нового адреса доставки
- настройки уведомлений пользователя
- экран успешного подключения канала уведомлений
- менеджерский экран сообщений
- бонусная система для менеджера
- карточка бонусного счета клиента
- создание реферальной связи
- создание бонусной транзакции
- проверка заявки на вывод бонусов