Files
makemd/docs/01_Architecture/06_State_Machine.md
wurenzhi 48a78137c5 refactor(terminology): 统一术语标准并优化代码类型安全
- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明,避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准
2026-03-20 09:43:50 +08:00

2.1 KiB
Raw Blame History

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


Cross-Border E-Commerce跨境电商状态

PENDING → PROCESSING → CLEARANCE → SHIPPING → DELIVERED


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


Task任务状态

PENDING → RUNNING → SUCCESS → FAILED → CANCELLED


状态变更原则

  • 所有状态变更必须通过 Service
  • 禁止前端直接控制状态
  • 状态变更必须记录操作日志
  • 状态变更必须遵循预定义的流转路径
  • 状态变更可能触发相关业务逻辑(如通知、计费等)

状态变更触发条件

  • 商户状态:审核结果、逾期未付费、违规行为
  • 用户状态:登录异常、权限变更、账号管理
  • 店铺状态:平台审核、违规行为、商户操作
  • 功能状态:支付结果、订阅到期、手动操作
  • 订单状态:支付结果、商户操作、物流状态
  • 商品状态:审核结果、库存状态、商户操作
  • 库存状态:库存数量变化、库存同步
  • 支付状态:支付渠道反馈、人工处理
  • 账单状态:系统确认、支付结果、人工处理
  • 结算状态:系统处理、支付结果、人工处理
  • 任务状态:任务触发、执行结果、人工取消