vault backup: 2025-09-12 13:16:24

This commit is contained in:
Andrey Epifancev
2025-09-12 13:16:24 +04:00
parent 9bc841872f
commit 3d83d64ab9
2 changed files with 740 additions and 435 deletions

8
.obsidian/app.json vendored
View File

@@ -1,4 +1,10 @@
{ {
"alwaysUpdateLinks": true, "alwaysUpdateLinks": true,
"promptDelete": false "promptDelete": false,
"pdfExportSettings": {
"pageSize": "Letter",
"landscape": false,
"margin": "0",
"downscalePercent": 100
}
} }

463
adssa.md
View File

@@ -3,9 +3,11 @@
## Функциональные требования ## Функциональные требования
### FR-001: Поддержка типов лотков ### FR-001: Поддержка типов лотков
**Описание**: Система должна поддерживать работу с четырьмя типами лотков (TUB1, TUB2, TUB4, TUB8) с различным количеством активных ячеек. **Описание**: Система должна поддерживать работу с четырьмя типами лотков (TUB1, TUB2, TUB4, TUB8) с различным количеством активных ячеек.
**Критерии приемки**: **Критерии приемки**:
- TUB1: поддержка 1 активной ячейки с одним SKU - TUB1: поддержка 1 активной ячейки с одним SKU
- TUB2: поддержка 2 ячеек с различными SKU - TUB2: поддержка 2 ячеек с различными SKU
- TUB4: поддержка 4 активных ячеек - TUB4: поддержка 4 активных ячеек
@@ -13,9 +15,11 @@
- Валидация соответствия типа лотка и номера ячейки - Валидация соответствия типа лотка и номера ячейки
### FR-002: Контрольное сканирование товаров ### FR-002: Контрольное сканирование товаров
**Описание**: Система должна обеспечивать контрольное сканирование товаров с поддержкой различных типов кодов. **Описание**: Система должна обеспечивать контрольное сканирование товаров с поддержкой различных типов кодов.
**Критерии приемки**: **Критерии приемки**:
- Поддержка сканирования SGTIN (2D QR-коды) - Поддержка сканирования SGTIN (2D QR-коды)
- Поддержка сканирования EAN (1D штрих-коды) - Поддержка сканирования EAN (1D штрих-коды)
- Режим без сканирования для товаров, не требующих контроля - Режим без сканирования для товаров, не требующих контроля
@@ -23,9 +27,11 @@
- Защита от двойного сканирования (таймер 0.5 сек) - Защита от двойного сканирования (таймер 0.5 сек)
### FR-003: Световая индикация ячеек ### FR-003: Световая индикация ячеек
**Описание**: Система должна обеспечивать точную световую индикацию активных ячеек для каждого типа лотка. **Описание**: Система должна обеспечивать точную световую индикацию активных ячеек для каждого типа лотка.
**Критерии приемки**: **Критерии приемки**:
- TUB1: подсветка всех 8 лампочек - TUB1: подсветка всех 8 лампочек
- TUB2: подсветка 4 лампочек - TUB2: подсветка 4 лампочек
- TUB4: подсветка 2 лампочек - TUB4: подсветка 2 лампочек
@@ -33,18 +39,22 @@
- Режим мигания для товаров со специальными маркерами - Режим мигания для товаров со специальными маркерами
### FR-004: Печать этикеток ### FR-004: Печать этикеток
**Описание**: Система должна поддерживать печать этикеток через сетевые принтеры. **Описание**: Система должна поддерживать печать этикеток через сетевые принтеры.
**Критерии приемки**: **Критерии приемки**:
- Управление сетевыми принтерами через WAMAS-C - Управление сетевыми принтерами через WAMAS-C
- Загрузка файлов из директории `/hcom/to_ssi/print/pbl_network_printer/` - Загрузка файлов из директории `/hcom/to_ssi/print/pbl_network_printer/`
- Использование файла по умолчанию при недоступности основного - Использование файла по умолчанию при недоступности основного
- Обработка ошибок печати с соответствующими уведомлениями - Обработка ошибок печати с соответствующими уведомлениями
### FR-005: Инвентаризация ### FR-005: Инвентаризация
**Описание**: Система должна поддерживать процесс инвентаризации лотков хранения. **Описание**: Система должна поддерживать процесс инвентаризации лотков хранения.
**Критерии приемки**: **Критерии приемки**:
- Поячеечная инвентаризация лотков - Поячеечная инвентаризация лотков
- Отображение наименований SKU (до 42 символов) - Отображение наименований SKU (до 42 символов)
- Ввод фактического количества через интерфейс станции - Ввод фактического количества через интерфейс станции
@@ -52,9 +62,11 @@
- Автоматическая отправка результатов в HOST систему - Автоматическая отправка результатов в HOST систему
### FR-006: Обработка маркеров товаров ### FR-006: Обработка маркеров товаров
**Описание**: Система должна обрабатывать специальные маркеры товаров и отображать соответствующие индикации. **Описание**: Система должна обрабатывать специальные маркеры товаров и отображать соответствующие индикации.
**Критерии приемки**: **Критерии приемки**:
- Маркер "damaged" → отображение "МЕХ" - Маркер "damaged" → отображение "МЕХ"
- Маркер "careful" → отображение "СТЕКЛ" - Маркер "careful" → отображение "СТЕКЛ"
- Маркер "scan" + SGTIN=true → отображение "МАРКИР" - Маркер "scan" + SGTIN=true → отображение "МАРКИР"
@@ -63,26 +75,31 @@
## Нефункциональные требования ## Нефункциональные требования
### NFR-001: Производительность ### NFR-001: Производительность
- Время отклика системы на действия оператора: не более 2 секунд - Время отклика системы на действия оператора: не более 2 секунд
- Пропускная способность: обработка до 100 операций в минуту на станцию - Пропускная способность: обработка до 100 операций в минуту на станцию
- Время обработки сканирования: не более 1 секунды - Время обработки сканирования: не более 1 секунды
### NFR-002: Надежность ### NFR-002: Надежность
- Доступность системы: 99.5% в рабочее время - Доступность системы: 99.5% в рабочее время
- Устойчивость к сбоям сети между WAMAS и HOST системой - Устойчивость к сбоям сети между WAMAS и HOST системой
- Автоматическое восстановление после кратковременных отключений - Автоматическое восстановление после кратковременных отключений
### NFR-003: Безопасность ### NFR-003: Безопасность
- Валидация всех входящих сообщений от HOST системы - Валидация всех входящих сообщений от HOST системы
- Логирование всех операций для аудита - Логирование всех операций для аудита
- Защита от некорректных данных в XML сообщениях - Защита от некорректных данных в XML сообщениях
### NFR-004: Совместимость ### NFR-004: Совместимость
- Обратная совместимость с существующими процессами WAMAS - Обратная совместимость с существующими процессами WAMAS
- Поддержка существующего протокола HOST Communication - Поддержка существующего протокола HOST Communication
- Совместимость с текущим аппаратным обеспечением PTL станций - Совместимость с текущим аппаратным обеспечением PTL станций
### NFR-005: Масштабируемость ### NFR-005: Масштабируемость
- Поддержка до 50 PTL станций одновременно - Поддержка до 50 PTL станций одновременно
- Возможность добавления новых типов лотков без изменения архитектуры - Возможность добавления новых типов лотков без изменения архитектуры
- Горизонтальное масштабирование обработки сообщений - Горизонтальное масштабирование обработки сообщений
@@ -90,18 +107,21 @@
## Технические характеристики ## Технические характеристики
### Аппаратные требования ### Аппаратные требования
- **PTL станции**: Дисплеи, световые индикаторы, кнопки-мультилайты - **PTL станции**: Дисплеи, световые индикаторы, кнопки-мультилайты
- **Сканеры**: Стационарные сканеры 1D/2D кодов на каждой станции - **Сканеры**: Стационарные сканеры 1D/2D кодов на каждой станции
- **Принтеры**: Сетевые принтеры этикеток (один на станцию) - **Принтеры**: Сетевые принтеры этикеток (один на станцию)
- **Сетевая инфраструктура**: Ethernet подключение для всех устройств - **Сетевая инфраструктура**: Ethernet подключение для всех устройств
### Программные требования ### Программные требования
- **WAMAS-C**: Центральная система управления складом - **WAMAS-C**: Центральная система управления складом
- **HOST система**: ERP/WMS система верхнего уровня - **HOST система**: ERP/WMS система верхнего уровня
- **База данных**: Таблицы для хранения данных операций и кодов - **База данных**: Таблицы для хранения данных операций и кодов
- **Файловая система**: Доступ к сетевым директориям для файлов печати - **Файловая система**: Доступ к сетевым директориям для файлов печати
### Протоколы и форматы ### Протоколы и форматы
- **Обмен данными**: XML сообщения между HOST и WAMAS - **Обмен данными**: XML сообщения между HOST и WAMAS
- **Коды товаров**: SGTIN (2D QR), EAN (1D штрих-код) - **Коды товаров**: SGTIN (2D QR), EAN (1D штрих-код)
- **Файлы печати**: PDF формат для этикеток - **Файлы печати**: PDF формат для этикеток
@@ -113,34 +133,97 @@
```mermaid ```mermaid
graph TB graph TB
HOST[HOST System<br/>ERP/WMS] WAMAS[WAMAS-C<br/>Controller] HOST[HOST System<br/>ERP/WMS]
PTL1[PTL Station #001] PTL2[PTL Station #002] PTLX[PTL Station #XXX] WAMAS[WAMAS-C<br/>Controller]
subgraph Equipment1 ["PTL Station Equipment"] PTL1[PTL Station #001]
DISP[Display] LIGHTS[Light Indicators] SCAN[Scanner] PRINT[Printer] BTN[Buttons/Multilights] PTL2[PTL Station #002]
end HOST <==>|XML Messages| WAMAS PTLX[PTL Station #XXX]
WAMAS -->|Control Commands| PTL1 WAMAS -->|Control Commands| PTL2 WAMAS -->|Control Commands| PTLX PTL1 --> DISP
PTL1 --> LIGHTS PTL1 --> SCAN PTL1 --> PRINT PTL1 --> BTN subgraph Equipment1 ["PTL Station Equipment"]
DISP[Display]
LIGHTS[Light Indicators]
SCAN[Scanner]
PRINT[Printer]
BTN[Buttons/Multilights]
end
HOST <==>|XML Messages| WAMAS
WAMAS -->|Control Commands| PTL1
WAMAS -->|Control Commands| PTL2
WAMAS -->|Control Commands| PTLX
PTL1 --> DISP
PTL1 --> LIGHTS
PTL1 --> SCAN
PTL1 --> PRINT
PTL1 --> BTN
``` ```
### Взаимодействие компонентов ### Взаимодействие компонентов
```mermaid ```mermaid
sequenceDiagram sequenceDiagram
participant HOST as HOST System participant WAMAS as WAMAS-C Controller participant PTL as PTL Station Hardware HOST->>WAMAS: disp-add, tub-type, inventory-new-add participant HOST as HOST System
WAMAS->>PTL: Station Commands PTL->>WAMAS: Hardware Status & Scan Data WAMAS->>HOST: pick-response, print-response, inventory-response Note over HOST,PTL: XML Protocol Communication participant WAMAS as WAMAS-C Controller
participant PTL as PTL Station Hardware
HOST->>WAMAS: disp-add, tub-type, inventory-new-add
WAMAS->>PTL: Station Commands
PTL->>WAMAS: Hardware Status & Scan Data
WAMAS->>HOST: pick-response, print-response, inventory-response
Note over HOST,PTL: XML Protocol Communication
``` ```
### База данных ### База данных
```mermaid ```mermaid
erDiagram erDiagram
RESERVE_LINES_OW { int TRANSFERID PK int order_id int order_line_id string station_id boolean print boolean SGTIN int LEN string marker } TUB_TYPE_OW { RESERVE_LINES_OW {
int TRANSFERID PK int box_number int TRANSFERID PK
string tu_type } INVENTORY_OW { int order_id
int TRANSFERID PK int box_number string tu_type string station_id } PICK_WO { int order_line_id
int TRANSFERID PK int picked int pick_status string station_id int tub_number } PICK_CODE_WO { string station_id
int TRANSFERID PK string item_code } PRINT_WO { boolean print
int TRANSFERID PK int print_status string station_id int order_id } PICK_WO ||--o{ PICK_CODE_WO : "TRANSFERID" boolean SGTIN
int LEN
string marker
}
TUB_TYPE_OW {
int TRANSFERID PK
int box_number
string tu_type
}
INVENTORY_OW {
int TRANSFERID PK
int box_number
string tu_type
string station_id
}
PICK_WO {
int TRANSFERID PK
int picked
int pick_status
string station_id
int tub_number
}
PICK_CODE_WO {
int TRANSFERID PK
string item_code
}
PRINT_WO {
int TRANSFERID PK
int print_status
string station_id
int order_id
}
PICK_WO ||--o{ PICK_CODE_WO : "TRANSFERID"
``` ```
## Use Cases ## Use Cases
@@ -149,16 +232,38 @@ erDiagram
```mermaid ```mermaid
flowchart TD flowchart TD
A[Лоток прибывает на станцию] --> B[Отображение 'МАРКИР' и количества] B --> C[Подсветка ячейки лотка] C --> D[Оператор берет товар] D --> E[Сканирование SGTIN QR-код] E --> F{Длина кода >= LEN?} F -->|Нет| G[Сообщение 'Пересканировать'] G --> E F -->|Да| H{QR читается?} H -->|Нет| I[Сканирование эталонного QR] I --> J[Режим 1.5.3] H -->|Да| K{Двойное сканирование?} K -->|Да| L[Сообщение 'ПОВТОР'] L --> M[Мигание кнопки №2] M --> N[Нажатие кнопки №2] N --> B K -->|Нет| O[Уменьшение счетчика] O --> P{Все единицы отсканированы?} P -->|Нет| D P -->|Да| Q[Отображение 'ПОДТВЕРДИТЬ'] Q --> R[Нажатие кнопки-мультилайт] R --> S[Отправка pick-response с item_code] A[Лоток прибывает на станцию] --> B[Отображение 'МАРКИР' и количества]
B --> C[Подсветка ячейки лотка]
C --> D[Оператор берет товар]
D --> E[Сканирование SGTIN QR-код]
E --> F{Длина кода >= LEN?}
F -->|Нет| G[Сообщение 'Пересканировать']
G --> E
F -->|Да| H{QR читается?}
H -->|Нет| I[Сканирование эталонного QR]
I --> J[Режим 1.5.3]
H -->|Да| K{Двойное сканирование?}
K -->|Да| L[Сообщение 'ПОВТОР']
L --> M[Мигание кнопки №2]
M --> N[Нажатие кнопки №2]
N --> B
K -->|Нет| O[Уменьшение счетчика]
O --> P{Все единицы отсканированы?}
P -->|Нет| D
P -->|Да| Q[Отображение 'ПОДТВЕРДИТЬ']
Q --> R[Нажатие кнопки-мультилайт]
R --> S[Отправка pick-response с item_code]
``` ```
**Актеры**: Оператор склада, WAMAS-C, HOST система **Актеры**: Оператор склада, WAMAS-C, HOST система
**Предусловия**: **Предусловия**:
- Лоток хранения находится на станции - Лоток хранения находится на станции
- Получено задание disp-add с SGTIN=true, marker="scan" - Получено задание disp-add с SGTIN=true, marker="scan"
**Основной поток**: **Основной поток**:
1. Система отображает "МАРКИР" и количество на дисплее 1. Система отображает "МАРКИР" и количество на дисплее
2. Загорается подсветка нужной ячейки лотка 2. Загорается подсветка нужной ячейки лотка
3. Оператор берет единицу товара 3. Оператор берет единицу товара
@@ -171,6 +276,7 @@ flowchart TD
10. Система отправляет pick-response с item_code для каждой единицы 10. Система отправляет pick-response с item_code для каждой единицы
**Альтернативные потоки**: **Альтернативные потоки**:
- 5а. Код слишком короткий → "Пересканировать" - 5а. Код слишком короткий → "Пересканировать"
- 5б. QR не читается → сканирование эталонного кода → режим 1.5.3 - 5б. QR не читается → сканирование эталонного кода → режим 1.5.3
- 4а. Двойное сканирование → "ПОВТОР" → возврат к п.3 - 4а. Двойное сканирование → "ПОВТОР" → возврат к п.3
@@ -179,16 +285,30 @@ flowchart TD
```mermaid ```mermaid
flowchart TD flowchart TD
A[Лоток прибывает на станцию] --> B[Отображение 'КОНТР' и количества] B --> C[Подсветка ячейки лотка] C --> D[Оператор берет товар] D --> E[Сканирование EAN штрих-код] E --> F{Код читается?} F -->|Нет| G[Сканирование эталонного кода] G --> E F -->|Да| H{Защита от двойного сканирования<br/>0.5 сек} H -->|Блокировка| H H -->|OK| I[Уменьшение счетчика] I --> J{Все единицы отсканированы?} J -->|Нет| D J -->|Да| K[Отправка pick-response с item_code] A[Лоток прибывает на станцию] --> B[Отображение 'КОНТР' и количества]
B --> C[Подсветка ячейки лотка]
C --> D[Оператор берет товар]
D --> E[Сканирование EAN штрих-код]
E --> F{Код читается?}
F -->|Нет| G[Сканирование эталонного кода]
G --> E
F -->|Да| H{Защита от двойного сканирования<br/>0.5 сек}
H -->|Блокировка| H
H -->|OK| I[Уменьшение счетчика]
I --> J{Все единицы отсканированы?}
J -->|Нет| D
J -->|Да| K[Отправка pick-response с item_code]
``` ```
**Актеры**: Оператор склада, WAMAS-C, HOST система **Актеры**: Оператор склада, WAMAS-C, HOST система
**Предусловия**: **Предусловия**:
- Лоток хранения находится на станции - Лоток хранения находится на станции
- Получено задание disp-add с SGTIN=false, marker="scan" - Получено задание disp-add с SGTIN=false, marker="scan"
**Основной поток**: **Основной поток**:
1. Система отображает "КОНТР" и количество на дисплее 1. Система отображает "КОНТР" и количество на дисплее
2. Загорается подсветка нужной ячейки лотка 2. Загорается подсветка нужной ячейки лотка
3. Оператор берет единицу товара 3. Оператор берет единицу товара
@@ -198,6 +318,7 @@ flowchart TD
7. Система отправляет pick-response с item_code 7. Система отправляет pick-response с item_code
**Альтернативные потоки**: **Альтернативные потоки**:
- 4а. Код не читается → сканирование эталонного кода - 4а. Код не читается → сканирование эталонного кода
- 4б. Защита от двойного сканирования (таймер 0.5 сек) - 4б. Защита от двойного сканирования (таймер 0.5 сек)
@@ -205,12 +326,27 @@ flowchart TD
```mermaid ```mermaid
flowchart TD flowchart TD
A[Получено задание с print=true] --> B[Отображение 'УПАК' и стрелки к принтеру] B --> C[Подсветка кнопки-мультилайт у принтера] C --> D[Оператор нажимает кнопку принтера] D --> E[Загрузка файла этикетки] E --> F{Файл доступен?} F -->|Нет| G[Использование default_label.pdf] F -->|Да| H[Отправка на принтер] G --> H H --> I{Печать успешна?} I -->|Да| J[print-response status=1] I -->|Нет| K[Сообщение 'ОШИБКА ПЕЧАТИ'] K --> L[Повторное нажатие кнопки] L --> M[print-response status=2] J --> N[Продолжение основного процесса] M --> N A[Получено задание с print=true] --> B[Отображение 'УПАК' и стрелки к принтеру]
B --> C[Подсветка кнопки-мультилайт у принтера]
C --> D[Оператор нажимает кнопку принтера]
D --> E[Загрузка файла этикетки]
E --> F{Файл доступен?}
F -->|Нет| G[Использование default_label.pdf]
F -->|Да| H[Отправка на принтер]
G --> H
H --> I{Печать успешна?}
I -->|Да| J[print-response status=1]
I -->|Нет| K[Сообщение 'ОШИБКА ПЕЧАТИ']
K --> L[Повторное нажатие кнопки]
L --> M[print-response status=2]
J --> N[Продолжение основного процесса]
M --> N
``` ```
**Актеры**: Оператор склада, WAMAS-C, Принтер, HOST система **Актеры**: Оператор склада, WAMAS-C, Принтер, HOST система
**Предусловия**: **Предусловия**:
- Получено задание disp-add с print=true - Получено задание disp-add с print=true
- Принтер подключен и готов - Принтер подключен и готов
@@ -218,13 +354,29 @@ flowchart TD
```mermaid ```mermaid
flowchart TD flowchart TD
A[Получено задание inventory-new-add] --> B[Лоток прибывает на станцию] B --> C[Отображение 'ИНВЕНТАРИЗАЦИЯ'] C --> D[Оператор подтверждает кнопкой №2] D --> E[Подсветка первой ячейки] E --> F[Отображение наименования SKU<br/>до 3 экранов] F --> G[Отображение 'КОЛ-ВО: 0'] G --> H[Оператор вводит количество +/-] H --> I[Подтверждение кнопкой №2] I --> J{Есть еще ячейки?} J -->|Да| K[Переход к следующей ячейке] K --> E J -->|Нет| L[Отправка inventory-response] L --> M[Лоток покидает станцию] style A fill:#e1f5fe A[Получено задание inventory-new-add] --> B[Лоток прибывает на станцию]
style L fill:#c8e6c9 style M fill:#c8e6c9 B --> C[Отображение 'ИНВЕНТАРИЗАЦИЯ']
C --> D[Оператор подтверждает кнопкой №2]
D --> E[Подсветка первой ячейки]
E --> F[Отображение наименования SKU<br/>до 3 экранов]
F --> G[Отображение 'КОЛ-ВО: 0']
G --> H[Оператор вводит количество +/-]
H --> I[Подтверждение кнопкой №2]
I --> J{Есть еще ячейки?}
J -->|Да| K[Переход к следующей ячейке]
K --> E
J -->|Нет| L[Отправка inventory-response]
L --> M[Лоток покидает станцию]
style A fill:#e1f5fe
style L fill:#c8e6c9
style M fill:#c8e6c9
``` ```
**Актеры**: Оператор склада, WAMAS-C, HOST система **Актеры**: Оператор склада, WAMAS-C, HOST система
**Предусловия**: **Предусловия**:
- Получено задание inventory-new-add - Получено задание inventory-new-add
- Лоток прибыл на станцию - Лоток прибыл на станцию
@@ -232,9 +384,17 @@ flowchart TD
```mermaid ```mermaid
flowchart TD flowchart TD
A[Получено сообщение disp-add] --> B[Получено сообщение tub-type] B --> C[Проверка соответствия tu_type и compartment_id] C --> D{Соответствие корректно?} D -->|Да| E[Обработка задания] D -->|Нет| F[Запись в таблицу со статусом error] G[Правила валидации:<br/>TUB1: compartment_id = 1<br/>TUB2: compartment_id = 1,2<br/>TUB4: compartment_id = 1,2,3,4<br/>TUB8: compartment_id = 1,2,3,4,5,6,7,8] A[Получено сообщение disp-add] --> B[Получено сообщение tub-type]
style D fill:#fff3e0 B --> C[Проверка соответствия tu_type и compartment_id]
style F fill:#ffcdd2 style E fill:#c8e6c9 C --> D{Соответствие корректно?}
D -->|Да| E[Обработка задания]
D -->|Нет| F[Запись в таблицу со статусом error]
G[Правила валидации:<br/>TUB1: compartment_id = 1<br/>TUB2: compartment_id = 1,2<br/>TUB4: compartment_id = 1,2,3,4<br/>TUB8: compartment_id = 1,2,3,4,5,6,7,8]
style D fill:#fff3e0
style F fill:#ffcdd2
style E fill:#c8e6c9
``` ```
**Актеры**: WAMAS-C, HOST система **Актеры**: WAMAS-C, HOST система
@@ -249,31 +409,46 @@ flowchart TD
```mermaid ```mermaid
graph LR graph LR
subgraph "HOST System" A[Create Task] end subgraph "XML Message" subgraph "HOST System"
B[disp-add<br/>TRANSFERID<br/>order_id<br/>print=true/false<br/>SGTIN=true/false<br/>marker=scan/damaged/careful<br/>LEN=минимальная длина] end subgraph "WAMAS Database" A[Create Task]
C[RESERVE_LINES_OW<br/>Table] end A --> B end
subgraph "XML Message"
B[disp-add<br/>TRANSFERID<br/>order_id<br/>print=true/false<br/>SGTIN=true/false<br/>marker=scan/damaged/careful<br/>LEN=минимальная длина]
end
subgraph "WAMAS Database"
C[RESERVE_LINES_OW<br/>Table]
end
A --> B
B --> C B --> C
``` ```
**Назначение**: Создание задания на сборку товара из лотка хранения **Назначение**: Создание задания на сборку товара из лотка хранения **Формат**: XML **Таблица**: RESERVE_LINES_OW
**Формат**: XML
**Таблица**: RESERVE_LINES_OW
**Структура сообщения**: **Структура сообщения**:
```xml ```xml
<record_type="disp-add" TRANSFERID="12900129" tub_number="110002556"> <record_type="disp-add" TRANSFERID="12900129" tub_number="110002556">
<disp-add-line order_id="1877865" <disp-add-line
order_id="1877865"
order_line_id="1" order_line_id="1"
station_id="PTL001" station_id="PTL001"
geo_code="001.01.01.01" geo_code="001.01.01.01"
compartment_id="1" compartment_id="1"
ordered="5" ordered="5"
host_order_line_id="1863829413" print="true" host_order_line_id="1863829413"
print="true"
SGTIN="true" SGTIN="true"
LEN="20" marker="scan"> </disp-add-line></disp-add> LEN="20"
marker="scan">
</disp-add-line>
</disp-add>
``` ```
**Ключевые поля**: **Ключевые поля**:
- `TRANSFERID`: Уникальный идентификатор сообщения - `TRANSFERID`: Уникальный идентификатор сообщения
- `print`: Флаг необходимости печати этикетки (true/false) - `print`: Флаг необходимости печати этикетки (true/false)
- `SGTIN`: Наличие SGTIN кодов у товара (true/false) - `SGTIN`: Наличие SGTIN кодов у товара (true/false)
@@ -284,17 +459,26 @@ graph LR
```mermaid ```mermaid
graph LR graph LR
subgraph "HOST System" A[Define Tub Type] end subgraph "XML Message" subgraph "HOST System"
B[tub-type<br/>TRANSFERID<br/>box_number<br/>tu_type=TUB1/TUB2/TUB4/TUB8] end subgraph "WAMAS Database" A[Define Tub Type]
C[TUB_TYPE_OW<br/>Table] end A --> B end
subgraph "XML Message"
B[tub-type<br/>TRANSFERID<br/>box_number<br/>tu_type=TUB1/TUB2/TUB4/TUB8]
end
subgraph "WAMAS Database"
C[TUB_TYPE_OW<br/>Table]
end
A --> B
B --> C B --> C
``` ```
**Назначение**: Сообщение о типе лотка для валидации операций **Назначение**: Сообщение о типе лотка для валидации операций **Формат**: XML **Таблица**: TUB_TYPE_OW
**Формат**: XML
**Таблица**: TUB_TYPE_OW
**Структура сообщения**: **Структура сообщения**:
```xml ```xml
<tub-type TRANSFERID="12900130" box_number="110002556" tu_type="TUB4"/> <tub-type TRANSFERID="12900130" box_number="110002556" tu_type="TUB4"/>
``` ```
@@ -303,20 +487,31 @@ graph LR
```mermaid ```mermaid
graph LR graph LR
subgraph "HOST System" A[Create Inventory Task] end subgraph "XML Message" subgraph "HOST System"
B[inventory-new-add<br/>TRANSFERID<br/>box_number<br/>tu_type<br/>station_id<br/>sku_names] end subgraph "WAMAS Database" A[Create Inventory Task]
C[INVENTORY_OW<br/>Table] end A --> B end
subgraph "XML Message"
B[inventory-new-add<br/>TRANSFERID<br/>box_number<br/>tu_type<br/>station_id<br/>sku_names]
end
subgraph "WAMAS Database"
C[INVENTORY_OW<br/>Table]
end
A --> B
B --> C B --> C
``` ```
**Назначение**: Создание задания на инвентаризацию лотка **Назначение**: Создание задания на инвентаризацию лотка **Формат**: XML **Таблица**: INVENTORY_OW
**Формат**: XML
**Таблица**: INVENTORY_OW
**Структура сообщения**: **Структура сообщения**:
```xml ```xml
<inventory-new-add TRANSFERID="12900131" box_number="110002556" tu_type="TUB2" station_id="PTL001"> <inventory-new-add TRANSFERID="12900131" box_number="110002556" tu_type="TUB2" station_id="PTL001">
<inventory-line compartment_id="1" sku_name="Товар 1"/> <inventory-line compartment_id="2" sku_name="Товар 2"/></inventory-new-add> <inventory-line compartment_id="1" sku_name="Товар 1"/>
<inventory-line compartment_id="2" sku_name="Товар 2"/>
</inventory-new-add>
``` ```
### Обмен данными WAMAS → HOST ### Обмен данными WAMAS → HOST
@@ -325,45 +520,70 @@ graph LR
```mermaid ```mermaid
graph LR graph LR
subgraph "WAMAS Database" A[PICK_WO<br/>Table] B[PICK_CODE_WO<br/>Table] end subgraph "XML Message" subgraph "WAMAS Database"
C[pick-response<br/>TRANSFERID<br/>picked quantity<br/>pick_status<br/>item_codes array] end subgraph "HOST System" A[PICK_WO<br/>Table]
D[Process Results] end A --> C B[PICK_CODE_WO<br/>Table]
B --> C C --> D end
subgraph "XML Message"
C[pick-response<br/>TRANSFERID<br/>picked quantity<br/>pick_status<br/>item_codes array]
end
subgraph "HOST System"
D[Process Results]
end
A --> C
B --> C
C --> D
``` ```
**Назначение**: Подтверждение выполнения операции сборки с деталями **Назначение**: Подтверждение выполнения операции сборки с деталями **Формат**: XML **Таблицы**: PICK_WO, PICK_CODE_WO
**Формат**: XML
**Таблицы**: PICK_WO, PICK_CODE_WO
**Структура сообщения**: **Структура сообщения**:
```xml ```xml
<pick-response <pick-response
TRANSFERID="12900141" TRANSFERID="12900141"
tote_number="40009681" tote_number="40009681"
geo_code="001.01.01.01" geo_code="001.01.01.01"
customer_code="448359" host_order_id="1280449" customer_code="448359"
host_order_id="1280449"
station_id="PTL001" station_id="PTL001"
tub_number="110002964" pick_status="1" tub_number="110002964"
pick_status="1"
compartment_id="1" compartment_id="1"
picked="2"> picked="2">
<pick-response-line item_code="SGTIN:123456789012345"/> <pick-response-line item_code="SGTIN:123456789012346"/></pick-response> <pick-response-line item_code="SGTIN:123456789012345"/>
<pick-response-line item_code="SGTIN:123456789012346"/>
</pick-response>
``` ```
#### MSG-102: print-response (Отчет о печати) #### MSG-102: print-response (Отчет о печати)
```mermaid ```mermaid
graph LR graph LR
subgraph "WAMAS Database" A[PRINT_WO<br/>Table] end subgraph "XML Message" subgraph "WAMAS Database"
B[print-response<br/>TRANSFERID<br/>print_status=1/2<br/>station_id<br/>order_id] end subgraph "HOST System" A[PRINT_WO<br/>Table]
C[Update Print Status] end A --> B end
subgraph "XML Message"
B[print-response<br/>TRANSFERID<br/>print_status=1/2<br/>station_id<br/>order_id]
end
subgraph "HOST System"
C[Update Print Status]
end
A --> B
B --> C B --> C
``` ```
**Назначение**: Подтверждение статуса печати этикетки **Назначение**: Подтверждение статуса печати этикетки **Формат**: XML
**Формат**: XML
**Таблица**: PRINT_WO **Таблица**: PRINT_WO
**Структура сообщения**: **Структура сообщения**:
```xml ```xml
<print-response <print-response
TRANSFERID="169954915" TRANSFERID="169954915"
@@ -373,6 +593,7 @@ graph LR
``` ```
**Статусы печати**: **Статусы печати**:
- `1`: Печать выполнена успешно - `1`: Печать выполнена успешно
- `2`: Ошибка печати - `2`: Ошибка печати
@@ -380,22 +601,34 @@ graph LR
```mermaid ```mermaid
graph LR graph LR
subgraph "WAMAS Database" A[INVENTORY_WO<br/>Table] end subgraph "XML Message" subgraph "WAMAS Database"
B[inventory-response<br/>TRANSFERID<br/>box_number<br/>station_id<br/>actual quantities] end subgraph "HOST System" A[INVENTORY_WO<br/>Table]
C[Update Inventory] end A --> B end
subgraph "XML Message"
B[inventory-response<br/>TRANSFERID<br/>box_number<br/>station_id<br/>actual quantities]
end
subgraph "HOST System"
C[Update Inventory]
end
A --> B
B --> C B --> C
``` ```
**Назначение**: Передача результатов инвентаризации лотка **Назначение**: Передача результатов инвентаризации лотка **Формат**: XML
**Формат**: XML
**Структура сообщения**: **Структура сообщения**:
```xml ```xml
<inventory-response <inventory-response
TRANSFERID="12900131" TRANSFERID="12900131"
box_number="110002556" box_number="110002556"
station_id="PTL001"> station_id="PTL001">
<inventory-line compartment_id="1" actual_qty="15"/> <inventory-line compartment_id="2" actual_qty="0"/></inventory-response> <inventory-line compartment_id="1" actual_qty="15"/>
<inventory-line compartment_id="2" actual_qty="0"/>
</inventory-response>
``` ```
### Процессы интеграции ### Процессы интеграции
@@ -404,32 +637,98 @@ graph LR
```mermaid ```mermaid
sequenceDiagram sequenceDiagram
participant HOST as HOST System participant WAMAS as WAMAS-C participant PTL as PTL Station participant OP as Operator HOST->>WAMAS: tub-type (определение типа лотка) participant HOST as HOST System
WAMAS->>WAMAS: Сохранение типа лотка HOST->>WAMAS: disp-add (задание на сборку) WAMAS->>WAMAS: Валидация tu_type vs compartment_id alt Валидация успешна participant WAMAS as WAMAS-C
WAMAS->>PTL: Активация станции PTL->>OP: Отображение задания alt Требуется печать (print=true) participant PTL as PTL Station
PTL->>OP: "УПАК" + подсветка принтера OP->>PTL: Нажатие кнопки принтера PTL->>PTL: Печать этикетки PTL->>WAMAS: Статус печати WAMAS->>HOST: print-response (status=1) end PTL->>OP: Отображение товара + подсветка ячейки participant OP as Operator
OP->>PTL: Сборка товара (с/без сканирования) PTL->>WAMAS: Результат операции WAMAS->>HOST: pick-response (с item_code если было сканирование) else Ошибка валидации
WAMAS->>WAMAS: Запись в таблицу со статусом error end HOST->>WAMAS: tub-type (определение типа лотка)
WAMAS->>WAMAS: Сохранение типа лотка
HOST->>WAMAS: disp-add (задание на сборку)
WAMAS->>WAMAS: Валидация tu_type vs compartment_id
alt Валидация успешна
WAMAS->>PTL: Активация станции
PTL->>OP: Отображение задания
alt Требуется печать (print=true)
PTL->>OP: "УПАК" + подсветка принтера
OP->>PTL: Нажатие кнопки принтера
PTL->>PTL: Печать этикетки
PTL->>WAMAS: Статус печати
WAMAS->>HOST: print-response (status=1)
end
PTL->>OP: Отображение товара + подсветка ячейки
OP->>PTL: Сборка товара (с/без сканирования)
PTL->>WAMAS: Результат операции
WAMAS->>HOST: pick-response (с item_code если было сканирование)
else Ошибка валидации
WAMAS->>WAMAS: Запись в таблицу со статусом error
end
``` ```
#### INT-002: Обработка ошибок #### INT-002: Обработка ошибок
```mermaid ```mermaid
flowchart TD flowchart TD
A[Получение сообщения] --> B{Валидация OK?} B -->|Нет| C[Запись в таблицу с error] B -->|Да| D[Обработка на PTL] D --> E{Принтер доступен?} E -->|Нет| F[print-response status=2] E -->|Да| G[Печать OK] G --> H[print-response status=1] F --> I[Продолжение без печати] H --> I I --> J{Сканирование OK?} J -->|Ошибка| K[Эталонный код или режим исключения] J -->|OK| L[pick-response с кодами] K --> M[pick-response без кодов] L --> N[Завершение] M --> N A["Получение сообщения"] --> B{"Валидация OK?"}
style C fill:#ffcccc style F fill:#ffffcc style K fill:#ffffcc B -->|"Нет"| C["Запись в таблицу с error"]
B -->|"Да"| D["Обработка на PTL"]
D --> E{"Принтер доступен?"}
E -->|"Нет"| F["print-response status=2"]
E -->|"Да"| G["Печать OK"]
G --> H["print-response status=1"]
F --> I["Продолжение без печати"]
H --> I
I --> J{"Сканирование OK?"}
J -->|"Ошибка"| K["Эталонный код или режим исключения"]
J -->|"OK"| L["pick-response с кодами"]
K --> M["pick-response без кодов"]
L --> N["Завершение"]
M --> N
style C fill:#ffcccc
style F fill:#ffffcc
style K fill:#ffffcc
``` ```
#### INT-003: Мониторинг и логирование #### INT-003: Мониторинг и логирование
```mermaid ```mermaid
graph TB graph TB
subgraph "Входящие события" A[XML Messages] B[Scan Operations] C[Print Events] subgraph "Входящие события"
D[Validation Results] end subgraph "Система логирования" A[XML Messages]
E[Message Logger] F[Operation Logger] G[Error Logger] H[Performance Monitor] end subgraph "Метрики и отчеты" B[Scan Operations]
I[Response Time] J[Success Rate] K[Station Load] L[Error Statistics] end A --> E C[Print Events]
B --> F C --> F D[Validation Results]
D --> G E --> I end
F --> J F --> K G --> L style G fill:#ffcccc
subgraph "Система логирования"
E[Message Logger]
F[Operation Logger]
G[Error Logger]
H[Performance Monitor]
end
subgraph "Метрики и отчеты"
I[Response Time]
J[Success Rate]
K[Station Load]
L[Error Statistics]
end
A --> E
B --> F
C --> F
D --> G
E --> I
F --> J
F --> K
G --> L
style G fill:#ffcccc
style L fill:#ffcccc style L fill:#ffcccc
``` ```