# 营销域服务

> **入口**: [_index.md](_index.md)

---

## 服务列表

| 服务 | 文件 | 职责 |
|------|------|------|
| CampaignService | services/CampaignService.ts | 广告计划管理 |
| AdService | services/AdService.ts | 广告管理 |
| AnalyticsService | services/AnalyticsService.ts | 数据分析 |

---

## 核心流程

```
创建计划 → 创建广告 → 投放 → 监控 → 优化
```

---

## CampaignService

### 方法列表

| 方法 | 说明 | 参数 | 返回 |
|------|------|------|------|
| list | 计划列表 | params | Campaign[] |
| get | 计划详情 | id | Campaign |
| create | 创建计划 | CreateRequest | Campaign |
| update | 更新计划 | id, UpdateRequest | Campaign |
| start | 启动计划 | id | Campaign |
| pause | 暂停计划 | id | Campaign |

---

## AdService

### 方法列表

| 方法 | 说明 | 参数 | 返回 |
|------|------|------|------|
| list | 广告列表 | campaignId | Ad[] |
| get | 广告详情 | id | Ad |
| create | 创建广告 | CreateRequest | Ad |
| update | 更新广告 | id, UpdateRequest | Ad |
| getPerformance | 获取表现 | id | Performance |

---

## AnalyticsService

### 方法列表

| 方法 | 说明 | 参数 | 返回 |
|------|------|------|------|
| getDashboard | 获取仪表盘 | params | Dashboard |
| getMetrics | 获取指标 | params | Metrics |
| getReport | 获取报告 | params | Report |

---

## 状态机

```
DRAFT → PENDING_REVIEW → ACTIVE → PAUSED → COMPLETED
                              ↓
                         ARCHIVED
```

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

---

## API端点

| 端点 | 方法 | 服务方法 |
|------|------|----------|
| /api/v1/campaigns | GET | CampaignService.list |
| /api/v1/campaigns | POST | CampaignService.create |
| /api/v1/campaigns/:id | GET | CampaignService.get |
| /api/v1/campaigns/:id/start | POST | CampaignService.start |
| /api/v1/campaigns/:id/pause | POST | CampaignService.pause |
| /api/v1/campaigns/:id/ads | GET | AdService.list |
| /api/v1/ads | POST | AdService.create |
| /api/v1/analytics/dashboard | GET | AnalyticsService.getDashboard |

---

*最后更新: 2026-03-22*
