Архитектура

Основные архитектурные подсистемы WMS.

Раздел	Описание
Конвейер обработки документов	Ядро системы: 14-шаговый pipeline сохранения документов
Система движений и регистров	Складской учёт: движения, регистры, координаты
Конструктор форм	Декларативное описание UI-форм (ListTemplate/EditTemplate)
Event-driven архитектура	Событийная модель, типы событий, подписки

Общие принципы

Многослойная архитектура

Controller → Service → Repository → Database
     ↓           ↓
    DTO      DocManager → MovementManager → Registry
                  ↓
              Events → Listeners

Ключевые паттерны

1. Template Method — BaseDocManager и BaseDocItemManager определяют конвейер обработки, наследники переопределяют hook-методы
2. Registry — DocManager, EntityServiceManager — реестры менеджеров/сервисов, автоматическая регистрация при старте
3. Event-driven — документы публикуют события, слушатели распространяют изменения
4. Soft Delete — все документы поддерживают мягкое удаление через isDeleted + Hibernate @Filter
5. Multi-tenancy — изоляция данных мерчантов через @Filter(name = "merchantFilter") + MerchantFilterAspect
6. Optimistic Locking + Retry — @RetryIfOptimisticLock для автоматического повтора при конфликтах
7. State Machine — Spring Statemachine 4.0.0 для workflow документов с персистенцией состояний