Регистры складского учёта

Обзор

Регистры — числовые накопители, хранящие актуальное состояние склада. Каждый регистр идентифицируется координатой (набор полей) и содержит числовые значения.

Регистр	Таблица	Назначение	Координата
StorageRegistry	wms_storage_registry	Остатки товара на складских местах	SKU упаковка + партия + кондиция + место + документ-источник
WorkflowRegistry	wms_workflow_registry	Товары в рабочих процессах	Контейнер + упаковка + партия + кондиция + место + задача
ControlRegistry	wms_control_registry	Блокировки операций	Широкая координата (товар, место, зона, склад, операция)
ShipmentControlRegistry	wms_shipment_control_registry	Контроль этапов отгрузки	Заказ + товар + партия + контейнер + этап

StorageRegistry (основной регистр)

Главный регистр складского учёта. Хранит количество и резерв товара в разрезе:

Поле координаты	Описание
skuPackagingId	Упаковка товара (штука, коробка и т.п.)
skuBatchId	Партия (дата, номер)
condition	Кондиция (годный, брак, карантин)
warehouseSpace	Складское место (ячейка)
sourceDocumentId	Документ, по которому товар поступил

Поле значения	Описание
quantity	Фактическое количество
reserved	Зарезервированное количество

Особенности:

• Поддержка splitter для конкурентного доступа
• Исторические снимки на начало каждого месяца (dateTime поле)
• Групповая валидация: quantity >= reserved

WorkflowRegistry

Учёт товаров/контейнеров, находящихся "в работе" по задачам workflow.

Работает как +/- (приход/расход). Используется для отслеживания товара на каждом этапе обработки.

Особенности:

• Поддержка splitter
• Координата включает workflowTaskId — привязка к конкретной задаче

ControlRegistry

Блокировка складских операций. Хранит флаг blocked (не количество).

Максимально гибкая координата — можно заблокировать:

• Конкретный товар
• Категорию товаров
• Партию
• Контейнер
• Складское место
• Зону склада
• Склад целиком
• Тип операции

Проверяется перед каждым движением (checkMovementIsNotBlocked).

ShipmentControlRegistry

Контроль прохождения товаров через этапы отгрузки (ShipmentStage):

• Отбор
• Сортировка
• Упаковка
• Погрузка

Работает как +/- в разрезе заказа, товара, партии и контейнера.

Перемещаемые объекты

В отличие от регистров (числовые значения), объекты перемещаются целиком:

Объект	Описание
BaseContainer	Контейнер. Координата: место + резерв + привязка к документу
SerialNumber	Серийный номер. Координата: кондиция + место

Запросы остатков (StockService)

StockService формирует нативные SQL-запросы к wms_storage_registry:

• Гибкая группировка через StockRequestGroupBy
• Фильтрация по складам, местам, товарам, кондициям
• Используется для проверки достаточности остатков и бизнес-логики