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:
132
docs/01_Architecture/STATE_MACHINE.md
Normal file
132
docs/01_Architecture/STATE_MACHINE.md
Normal file
@@ -0,0 +1,132 @@
|
||||
# STATE_MACHINE
|
||||
|
||||
## Merchant(商户)状态
|
||||
|
||||
pending
|
||||
→ active
|
||||
→ inactive
|
||||
→ suspended
|
||||
|
||||
---
|
||||
|
||||
## User(用户)状态
|
||||
|
||||
pending
|
||||
→ active
|
||||
→ inactive
|
||||
→ locked
|
||||
|
||||
---
|
||||
|
||||
## Store(店铺)状态
|
||||
|
||||
pending
|
||||
→ active
|
||||
→ inactive
|
||||
→ suspended
|
||||
|
||||
---
|
||||
|
||||
## Feature(功能)状态
|
||||
|
||||
inactive
|
||||
→ pending_payment
|
||||
→ active
|
||||
→ expired
|
||||
→ suspended
|
||||
|
||||
---
|
||||
|
||||
## Order(订单)状态
|
||||
|
||||
pending
|
||||
→ paid
|
||||
→ split
|
||||
→ processing
|
||||
→ shipped
|
||||
→ completed
|
||||
→ refunded
|
||||
→ cancelled
|
||||
|
||||
---
|
||||
|
||||
## SubOrder(子订单)状态
|
||||
|
||||
pending
|
||||
→ processing
|
||||
→ shipped
|
||||
→ completed
|
||||
→ refunded
|
||||
→ cancelled
|
||||
|
||||
---
|
||||
|
||||
## Product(商品)状态
|
||||
|
||||
draft
|
||||
→ pending_approval
|
||||
→ active
|
||||
→ inactive
|
||||
→ discontinued
|
||||
|
||||
---
|
||||
|
||||
## Inventory(库存)状态
|
||||
|
||||
normal
|
||||
→ low
|
||||
→ out_of_stock
|
||||
→ overstock
|
||||
|
||||
---
|
||||
|
||||
## Payment(支付)状态
|
||||
|
||||
created
|
||||
→ processing
|
||||
→ paid
|
||||
→ failed
|
||||
→ refunded
|
||||
|
||||
---
|
||||
|
||||
## Bill(账单)状态
|
||||
|
||||
pending
|
||||
→ confirmed
|
||||
→ settled
|
||||
→ disputed
|
||||
|
||||
---
|
||||
|
||||
## Settlement(结算)状态
|
||||
|
||||
pending
|
||||
→ processing
|
||||
→ completed
|
||||
→ failed
|
||||
|
||||
---
|
||||
|
||||
## 状态变更原则
|
||||
|
||||
- 所有状态变更必须通过 Service
|
||||
- 禁止前端直接控制状态
|
||||
- 状态变更必须记录操作日志
|
||||
- 状态变更必须遵循预定义的流转路径
|
||||
- 状态变更可能触发相关业务逻辑(如通知、计费等)
|
||||
|
||||
---
|
||||
|
||||
## 状态变更触发条件
|
||||
|
||||
- 商户状态:审核结果、逾期未付费、违规行为
|
||||
- 用户状态:登录异常、权限变更、账号管理
|
||||
- 店铺状态:平台审核、违规行为、商户操作
|
||||
- 功能状态:支付结果、订阅到期、手动操作
|
||||
- 订单状态:支付结果、商户操作、物流状态
|
||||
- 商品状态:审核结果、库存状态、商户操作
|
||||
- 库存状态:库存数量变化、库存同步
|
||||
- 支付状态:支付渠道反馈、人工处理
|
||||
- 账单状态:系统确认、支付结果、人工处理
|
||||
- 结算状态:系统处理、支付结果、人工处理
|
||||
Reference in New Issue
Block a user