docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档 补充前端集成蓝图、多租户实施清单、上线红线检查清单 添加质量保障文档与早期业务规格书
This commit is contained in:
32
docs/blueprints/frontend-integration/oms-workbench.md
Normal file
32
docs/blueprints/frontend-integration/oms-workbench.md
Normal file
@@ -0,0 +1,32 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user