# Frontend Integration: OMS Workbench (统一订单工作台)

## 🎨 UI Layout Sketch
- **Page Path**: `/erp/oms/workbench`
- **Component Structure**:
  - `OrderStats`: Top metrics (Total Orders, Pending Audit, Waiting Shipment, Exceptions).
  - `OrderFilter`: Multi-dimensional filtering (Platform, Site, Status, Date, Amount, Customer).
  - `OrderTable`: Detailed list of orders with:
    - Status badges (e.g., `PENDING_AUDIT` in orange, `WAITING_SHIPMENT` in blue).
    - Platform/Site icons.
    - Items summary.
    - Total Amount & Currency.
    - Action column: "Audit", "Ship", "Mark Exception", "Reroute".
  - `BatchActionPanel`: "Batch Audit", "Batch Ship", "Batch Export".
  - `OrderDetailDrawer`: Full details on click, including Health Check results and Auto-Heal logs.

## 🔄 Interaction State Machine
- `INITIAL`: Fetching multi-platform orders.
- `FILTERING`: User applying criteria.
- `AUDITING`: `ConsumerOrderService.batchAudit` processing.
- `SHIPPING`: `ConsumerOrderService.batchShip` processing.
- `EXCEPTION_HANDLING`: User resolving exception reason.

## 🔗 API Mapping
- `GET /api/v1/orders/list`: Fetches `cf_consumer_orders`.
- `POST /api/v1/orders/batch-audit`: Triggers `ConsumerOrderService.batchAudit`.
- `POST /api/v1/orders/batch-ship`: Triggers `ConsumerOrderService.batchShip`.
- `POST /api/v1/orders/reroute`: Triggers `ConsumerOrderService.autoReroute`.

## 📈 ROI Visualization
- "OMS Efficiency": Orders processed per minute compared to manual.
- "Error Reduction": Exception rate before and after AI Health Check.