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:
2026-03-18 12:35:52 +08:00
parent 2ad40da777
commit 5cfd0c4c89
55 changed files with 6077 additions and 1733 deletions

View 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
- 禁止前端直接控制状态
- 状态变更必须记录操作日志
- 状态变更必须遵循预定义的流转路径
- 状态变更可能触发相关业务逻辑(如通知、计费等)
---
## 状态变更触发条件
- 商户状态:审核结果、逾期未付费、违规行为
- 用户状态:登录异常、权限变更、账号管理
- 店铺状态:平台审核、违规行为、商户操作
- 功能状态:支付结果、订阅到期、手动操作
- 订单状态:支付结果、商户操作、物流状态
- 商品状态:审核结果、库存状态、商户操作
- 库存状态:库存数量变化、库存同步
- 支付状态:支付渠道反馈、人工处理
- 账单状态:系统确认、支付结果、人工处理
- 结算状态:系统处理、支付结果、人工处理