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

6.7 KiB

领域模型

入口: _index.md


1. 核心领域

领域 英文 说明
商品 Product 商品主数据、SKU、Listing
订单 Order 订单、履约、售后
库存 Inventory 库存、仓储、补货
财务 Finance 对账、结算、利润
营销 Marketing 广告、投放、推广
客户 Customer 客户、用户、资产

2. 商品领域模型

2.1 实体关系

┌─────────────┐     1:N      ┌─────────────┐     1:N      ┌─────────────┐
│     SPU     │─────────────→│     SKU     │─────────────→│  Listing    │
│  (商品主数据) │              │   (变体)    │              │ (平台刊登)   │
└─────────────┘              └─────────────┘              └─────────────┘
      │                            │                            │
      │ 1:N                        │ 1:N                        │ 1:1
      ↓                            ↓                            ↓
┌─────────────┐              ┌─────────────┐              ┌─────────────┐
│   图片库    │              │   库存      │              │   价格      │
└─────────────┘              └─────────────┘              └─────────────┘

2.2 商品状态机

DRAFT → PENDING_REVIEW → ACTIVE → INACTIVE
                              ↓
                         ARCHIVED
状态 说明
DRAFT 草稿
PENDING_REVIEW 待审核
ACTIVE 活跃
INACTIVE 停用
ARCHIVED 归档

3. 订单领域模型

3.1 实体关系

┌─────────────┐     1:N      ┌─────────────┐     1:N      ┌─────────────┐
│    Order    │─────────────→│  OrderItem  │─────────────→│   SKU       │
│   (订单)    │              │  (订单项)   │              │  (商品)     │
└─────────────┘              └─────────────┘              └─────────────┘
      │
      │ 1:1
      ↓
┌─────────────┐     1:N      ┌─────────────┐
│  履约记录   │─────────────→│  物流信息   │
└─────────────┘              └─────────────┘

3.2 订单状态机

PENDING → CONFIRMED → PROCESSING → SHIPPED → DELIVERED → COMPLETED
    ↓          ↓           ↓           ↓
CANCELLED  CANCELLED   CANCELLED   RETURNED
状态 说明
PENDING 待处理
CONFIRMED 已确认
PROCESSING 处理中
SHIPPED 已发货
DELIVERED 已送达
COMPLETED 已完成
CANCELLED 已取消
RETURNED 已退货

4. 库存领域模型

4.1 实体关系

┌─────────────┐     1:N      ┌─────────────┐
│   Warehouse │─────────────→│  Inventory  │
│   (仓库)    │              │   (库存)    │
└─────────────┘              └─────────────┘
                                   │
                                   │ 1:N
                                   ↓
                             ┌─────────────┐
                             │ 库存变动记录 │
                             └─────────────┘

4.2 库存状态

状态 说明
IN_STOCK 有库存
LOW_STOCK 低库存
OUT_OF_STOCK 缺货
RESERVED 预留

5. 财务领域模型

5.1 实体关系

┌─────────────┐     1:N      ┌─────────────┐     1:N      ┌─────────────┐
│ Settlement  │─────────────→│ Settlement  │─────────────→│   Order     │
│  (结算单)   │              │   Item      │              │  (订单)     │
└─────────────┘              └─────────────┘              └─────────────┘
      │
      │ 1:1
      ↓
┌─────────────┐
│   对账记录   │
└─────────────┘

5.2 结算状态

状态 说明
PENDING 待结算
PROCESSING 处理中
COMPLETED 已完成
FAILED 失败

6. 营销领域模型

6.1 实体关系

┌─────────────┐     1:N      ┌─────────────┐     1:N      ┌─────────────┐
│  Campaign   │─────────────→│     Ad      │─────────────→│ AdCreative  │
│  (广告计划) │              │   (广告)    │              │  (广告素材) │
└─────────────┘              └─────────────┘              └─────────────┘

6.2 广告状态

状态 说明
DRAFT 草稿
PENDING_REVIEW 待审核
ACTIVE 投放中
PAUSED 已暂停
COMPLETED 已完成

7. 客户领域模型

7.1 实体关系

┌─────────────┐     1:N      ┌─────────────┐     1:N      ┌─────────────┐
│   Customer  │─────────────→│   Order     │─────────────→│   Address   │
│   (客户)    │              │  (订单)     │              │  (地址)     │
└─────────────┘              └─────────────┘              └─────────────┘

7.2 客户状态

状态 说明
ACTIVE 活跃
INACTIVE 非活跃
BLACKLISTED 黑名单

最后更新: 2026-03-22