Files
makemd/docs/ARCHIVE/01_Architecture/06_State_Machine.md
wurenzhi 2b86715c09 refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件
- 修复类型定义和导入方式
- 优化mock数据源的环境变量判断逻辑
- 更新文档结构并归档旧文件
- 添加新的UI组件和Memo组件
- 调整API路径和响应处理
2026-03-23 12:41:35 +08:00

7.0 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


商品中心状态机Product Center State Machine

SPU标准产品单元状态

DRAFT → PENDING_REVIEW → ACTIVE → INACTIVE → ARCHIVED

  ┌─────────┐
  │  DRAFT  │ ← 创建时初始状态
  └────┬────┘
       │ 提交审核
       ▼
  ┌─────────────┐
  │PENDING_REVIEW│
  └──────┬──────┘
       │
    ┌──┴──┐
    │     │
    ▼     ▼
┌───────┐ ┌────────┐
│ACTIVE │ │INACTIVE│
└───┬───┘ └───┬────┘
    │         │
    └────┬────┘
         │
         ▼
    ┌─────────┐
    │ ARCHIVED│
    └─────────┘

SKU库存单元状态

ACTIVE → INACTIVE → DISCONTINUED

  ┌─────────┐
  │ ACTIVE  │ ← 可销售
  └────┬────┘
       │ 停用
       ▼
  ┌──────────┐
  │ INACTIVE │ ← 暂停销售
  └────┬─────┘
       │ 永久停售
       ▼
  ┌─────────────┐
  │DISCONTINUED │ ← 已停产
  └─────────────┘

PlatformListing平台商品状态

DRAFT → PENDING → ACTIVE → INACTIVE → REJECTED → DELISTED

  ┌─────────┐
  │  DRAFT  │ ← 本地草稿
  └────┬────┘
       │ 提交发布
       ▼
  ┌─────────┐
  │ PENDING │ ← 等待平台审核
  └────┬────┘
       │
    ┌──┴──┐
    │     │
    ▼     ▼
┌───────┐ ┌──────────┐
│ACTIVE │ │ REJECTED │ ← 平台拒绝
└───┬───┘ └──────────┘
    │
    ├── 下架 ──→ ┌─────────┐
    │            │DELISTED │ ← 已下架
    │            └─────────┘
    │
    └── 停用 ──→ ┌──────────┐
                 │ INACTIVE │ ← 暂停销售
                 └──────────┘

PriceStrategy价格策略状态

DRAFT → ACTIVE → INACTIVE → ARCHIVED

  ┌─────────┐
  │  DRAFT  │ ← 策略草稿
  └────┬────┘
       │ 启用
       ▼
  ┌─────────┐
  │ ACTIVE  │ ← 策略生效中
  └────┬────┘
       │
    ┌──┴──┐
    │     │
    ▼     ▼
┌──────────┐ ┌─────────┐
│ INACTIVE │ │ ARCHIVED│
└──────────┘ └─────────┘

SKUMappingSKU映射状态

PENDING → ACTIVE → INACTIVE → INVALID

  ┌─────────┐
  │ PENDING │ ← 待确认映射
  └────┬────┘
       │ 确认映射
       ▼
  ┌─────────┐
  │ ACTIVE  │ ← 映射有效
  └────┬────┘
       │
    ┌──┴──┐
    │     │
    ▼     ▼
┌──────────┐ ┌─────────┐
│ INACTIVE │ │ INVALID │ ← 映射失效
└──────────┘ └─────────┘

ShopAuthorization店铺授权状态

PENDING → ACTIVE → EXPIRED → INVALID → ERROR

  ┌─────────┐
  │ PENDING │ ← 授权中
  └────┬────┘
       │ 授权成功
       ▼
  ┌─────────┐
  │ ACTIVE  │ ← 授权有效
  └────┬────┘
       │
    ┌──┼──┬───────┐
    │  │  │       │
    ▼  ▼  ▼       ▼
┌────────┐┌─────────┐┌───────┐
│EXPIRED ││ INVALID ││ ERROR │
└────────┘└─────────┘└───────┘
   │           │
   │ 刷新令牌   │ 重新授权
   ▼           ▼
┌─────────┐ ┌─────────┐
│ ACTIVE  │ │ ACTIVE  │
└─────────┘ └─────────┘

Organization组织架构状态

ACTIVE → INACTIVE → ARCHIVED

  ┌─────────┐
  │ ACTIVE  │ ← 组织活跃
  └────┬────┘
       │ 停用
       ▼
  ┌──────────┐
  │ INACTIVE │ ← 组织停用
  └────┬─────┘
       │ 归档
       ▼
  ┌─────────┐
  │ ARCHIVED│ ← 已归档
  └─────────┘

状态变更原则

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

状态变更触发条件

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