# 领域模型

> **入口**: [_index.md](_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*