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

194 lines
6.7 KiB
Markdown

# 领域模型
> **入口**: [_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*