feat: 实现服务层核心功能与文档更新
refactor(ProductService): 修复createProduct方法和其他方法错误 fix(InventoryAgingService): 修复AGING_THRESHOLD_DAYS引用问题 fix(InventoryService): 修复predictSKUDemand方法 refactor(ChatBotController): 从tsoa风格改为Express风格 fix(CommandCenterController): 修复类型问题 fix(AdAutoService): 修复stock可能为undefined的问题 docs: 更新SERVICE_MAP、DOMAIN_MODEL等架构文档 chore: 启动前端服务(运行在http://localhost:8000)
This commit is contained in:
127
docs/01_Architecture/SERVICE_MAP.md
Normal file
127
docs/01_Architecture/SERVICE_MAP.md
Normal file
@@ -0,0 +1,127 @@
|
||||
# SERVICE_MAP(服务编排总图)
|
||||
|
||||
## 设计原则
|
||||
- 所有业务必须通过 Service 层
|
||||
- Controller 不允许直接操作数据库
|
||||
- 一个业务 = 一条 Service Flow
|
||||
- 服务调用必须遵循 STATE_MACHINE 定义的状态流转
|
||||
- 涉及收费的业务必须接入 BILLING 系统
|
||||
- 所有接口必须经过权限校验
|
||||
|
||||
---
|
||||
|
||||
## 1. 功能开通闭环(收费核心)
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ FeatureController.openFeature
|
||||
→ FeatureService.checkAccess
|
||||
→ PaymentService.createPayment
|
||||
→ PaymentCallbackService.confirm
|
||||
→ FeatureService.activateFeature
|
||||
→ PermissionService.grant
|
||||
→ BillingService.record
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 2. 多商户订单闭环
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ OrderController.create
|
||||
→ OrderService.createOrder
|
||||
→ OrderService.splitByMerchant
|
||||
→ InventoryService.lockStock
|
||||
→ OrderRepository.save
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 3. 订单履约闭环
|
||||
|
||||
Flow:
|
||||
OrderService.confirm
|
||||
→ ShipmentService.createShipment
|
||||
→ OrderService.updateStatus
|
||||
→ NotificationService.send
|
||||
|
||||
---
|
||||
|
||||
## 4. 结算闭环
|
||||
|
||||
Flow:
|
||||
Scheduler / Manual Trigger
|
||||
→ SettlementService.calculate
|
||||
→ SettlementService.generateBill
|
||||
→ PaymentService.payout
|
||||
→ BillingService.record
|
||||
|
||||
---
|
||||
|
||||
## 5. 权限校验闭环(所有接口必须经过)
|
||||
|
||||
Flow:
|
||||
Request
|
||||
→ AuthMiddleware
|
||||
→ PermissionService.check
|
||||
→ Controller
|
||||
|
||||
---
|
||||
|
||||
## 6. 商户管理闭环
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ MerchantController.create
|
||||
→ MerchantService.register
|
||||
→ VerificationService.verify
|
||||
→ RBACService.assignRole
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 7. 店铺管理闭环
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ StoreController.create
|
||||
→ StoreService.createStore
|
||||
→ ProductService.setupProducts
|
||||
→ InventoryService.initializeInventory
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 8. 商户数据与分析闭环
|
||||
|
||||
Flow:
|
||||
Scheduler / Manual Trigger
|
||||
→ AnalyticsService.collectData
|
||||
→ ReportService.generateReport
|
||||
→ NotificationService.sendReport
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 9. 多商户库存同步闭环
|
||||
|
||||
Flow:
|
||||
Merchant Portal
|
||||
→ InventoryController.sync
|
||||
→ InventorySyncService.syncMerchantInventory
|
||||
→ InventoryService.updateStock
|
||||
→ ProductService.updateProductStatus
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 10. 异常处理闭环
|
||||
|
||||
Flow:
|
||||
Frontend / System
|
||||
→ ExceptionController.handle
|
||||
→ ExceptionService.process
|
||||
→ NotificationService.alert
|
||||
→ SettlementService.adjust
|
||||
→ Response
|
||||
Reference in New Issue
Block a user