# 广告系统批量操作 TODO

> **创建日期**: 2026-03-24
> **状态**: ✅ 已归档
> **归档日期**: 2026-03-24
> **优先级**: P1

---

## 🔒 当前占用状态

| Agent | 占用模块 | 涉及任务 | 主要文件 | 开始时间 | 状态 |
|-------|----------|----------|----------|----------|------|
| - | - | - | - | - | - |

---

## 📊 任务统计

| 类型 | 数量 | 状态 |
|------|------|------|
| 后端服务 | 4 | pending |
| 前端组件 | 5 | pending |
| 数据模型 | 2 | pending |
| API接口 | 3 | pending |
| **总计** | **14** | **pending** |

---

## 📦 后端任务包

### AD-TODO-001 批量操作类型定义与枚举

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-001 |
| **模块** | 后端 - 类型定义 |
| **状态** | pending |
| **依赖** | 无 |
| **预计耗时** | 2h |

**验收标准**:
- [ ] 定义 BatchOperationType 枚举（12种操作类型）
- [ ] 定义 BatchOperationStatus 枚举
- [ ] 定义 BatchOperationRecord 类型
- [ ] 在 shared/types 目录创建 batch-operation.ts

**文件位置**:
- `server/src/shared/types/batch-operation.ts`

---

### AD-TODO-002 批量操作数据库表

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-002 |
| **模块** | 后端 - 数据库 |
| **状态** | pending |
| **依赖** | AD-TODO-001 |
| **预计耗时** | 2h |

**验收标准**:
- [ ] 创建 cf_batch_operation 表
- [ ] 创建 cf_batch_operation_item 表
- [ ] 实现表初始化方法

**文件位置**:
- `server/src/database/DatabaseSchema.ts`

---

### AD-TODO-003 BatchOperationService 批量操作服务

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-003 |
| **模块** | 后端 - Service |
| **状态** | pending |
| **依赖** | AD-TODO-001, AD-TODO-002 |
| **预计耗时** | 8h |

**验收标准**:
- [ ] 实现 batchEditPrice 批量修改价格
- [ ] 实现 batchEditInventory 批量修改库存
- [ ] 实现 batchEditTitle 批量修改标题
- [ ] 实现 batchListing 批量上架
- [ ] 实现 batchDelist 批量下架
- [ ] 实现 getBatchOperationHistory 获取操作历史

**文件位置**:
- `server/src/services/core/BatchOperationService.ts`

---

### AD-TODO-004 AI批量操作接管中间件

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-004 |
| **模块** | 后端 - 中间件 |
| **状态** | pending |
| **依赖** | AD-TODO-001, AD-TODO-003 |
| **预计耗时** | 6h |

**验收标准**:
- [ ] 实现 BatchOperationAIMiddleware
- [ ] 根据订阅等级判断是否AI接管
- [ ] 实现置信度校验
- [ ] 实现风险等级校验
- [ ] 实现人工确认流程

**文件位置**:
- `server/src/api/middleware/BatchOperationAIMiddleware.ts`

---

## 📦 前端任务包

### AD-TODO-005 OperationAgent 页面结构调整

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-005 |
| **模块** | 前端 - 页面结构 |
| **状态** | pending |
| **依赖** | AD-TODO-003 |
| **预计耗时** | 4h |

**验收标准**:
- [ ] 创建 OperationAgent/components/ProductBatch 目录
- [ ] 创建 OperationAgent/components/AdBatch 目录
- [ ] 实现组件目录结构

**文件位置**:
- `dashboard/src/pages/OperationAgent/components/ProductBatch/`
- `dashboard/src/pages/OperationAgent/components/AdBatch/`

---

### AD-TODO-006 BatchEditModal 批量编辑弹窗

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-006 |
| **模块** | 前端 - 组件 |
| **状态** | pending |
| **依赖** | AD-TODO-005 |
| **预计耗时** | 6h |

**验收标准**:
- [ ] 实现多选产品功能
- [ ] 实现编辑字段选择（价格/库存/标题/类目等）
- [ ] 实现预览变更功能
- [ ] 实现确认执行功能
- [ ] 实现结果反馈功能

**文件位置**:
- `dashboard/src/pages/OperationAgent/components/ProductBatch/BatchEditModal.tsx`

---

### AD-TODO-007 BatchListingModal 批量上架弹窗

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-007 |
| **模块** | 前端 - 组件 |
| **状态** | pending |
| **依赖** | AD-TODO-006 |
| **预计耗时** | 6h |

**验收标准**:
- [ ] 实现选择目标平台/店铺
- [ ] 实现AI分析（显示AI建议）
- [ ] 实现人工确认流程
- [ ] 实现执行进度显示
- [ ] 实现结果反馈

**文件位置**:
- `dashboard/src/pages/OperationAgent/components/ProductBatch/BatchListingModal.tsx`

---

### AD-TODO-008 AISuggestionList AI建议列表组件

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-008 |
| **模块** | 前端 - 组件 |
| **状态** | pending |
| **依赖** | AD-TODO-004 |
| **预计耗时** | 4h |

**验收标准**:
- [ ] 实现AI建议列表展示
- [ ] 实现按状态筛选（待处理/已批准/已拒绝）
- [ ] 实现批准/拒绝操作
- [ ] 实现执行结果展示

**文件位置**:
- `dashboard/src/pages/OperationAgent/components/AISuggestionList.tsx`

---

### AD-TODO-009 HumanOperationLog 人工操作记录组件

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-009 |
| **模块** | 前端 - 组件 |
| **状态** | pending |
| **依赖** | AD-TODO-004 |
| **预计耗时** | 4h |

**验收标准**:
- [ ] 实现操作记录列表展示
- [ ] 实现按操作类型筛选
- [ ] 实现按时间范围筛选
- [ ] 实现操作详情查看
- [ ] 实现效果评估展示

**文件位置**:
- `dashboard/src/pages/OperationAgent/components/HumanOperationLog.tsx`

---

## 📦 API接口任务包

### AD-TODO-010 BatchOperationController 批量操作API

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-010 |
| **模块** | 后端 - API |
| **状态** | pending |
| **依赖** | AD-TODO-003 |
| **预计耗时** | 4h |

**验收标准**:
- [ ] POST /api/v1/batch/edit - 批量编辑
- [ ] POST /api/v1/batch/listing - 批量上架
- [ ] POST /api/v1/batch/delist - 批量下架
- [ ] GET /api/v1/batch/history - 获取历史
- [ ] GET /api/v1/batch/:id/status - 获取执行状态

**文件位置**:
- `server/src/api/controllers/BatchOperationController.ts`

---

### AD-TODO-011 AI批量操作建议API

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-011 |
| **模块** | 后端 - API |
| **状态** | pending |
| **依赖** | AD-TODO-004 |
| **预计耗时** | 3h |

**验收标准**:
- [ ] GET /api/v1/ai/batch-suggestions - 获取AI批量操作建议
- [ ] POST /api/v1/ai/batch-suggestions/:id/approve - 批准AI建议
- [ ] POST /api/v1/ai/batch-suggestions/:id/reject - 拒绝AI建议

**文件位置**:
- `server/src/api/controllers/AIBatchController.ts`

---

## 📦 DataSource抽象层任务包

### AD-TODO-012 batchOperationDataSource 批量操作数据源

| 属性 | 值 |
|------|-----|
| **任务ID** | AD-TODO-012 |
| **模块** | 前端 - DataSource |
| **状态** | pending |
| **依赖** | AD-TODO-010, AD-TODO-011 |
| **预计耗时** | 4h |

**验收标准**:
- [ ] 定义 IBatchOperationDataSource 接口
- [ ] 实现 ApiBatchOperationDataSource
- [ ] 实现 MockBatchOperationDataSource
- [ ] 导出统一数据源实例

**文件位置**:
- `dashboard/src/services/batchOperationDataSource.ts`

---

## 📋 执行顺序

```
第一阶段（可并行）
├── AD-TODO-001 类型定义
├── AD-TODO-002 数据库表
└── AD-TODO-005 前端目录结构

第二阶段（依赖第一阶段）
├── AD-TODO-003 BatchOperationService
├── AD-TODO-004 AI接管中间件
└── AD-TODO-006 BatchEditModal

第三阶段（依赖第二阶段）
├── AD-TODO-007 BatchListingModal
├── AD-TODO-008 AISuggestionList
├── AD-TODO-009 HumanOperationLog
├── AD-TODO-010 BatchOperationController
└── AD-TODO-011 AI批量操作API

第四阶段（收尾）
└── AD-TODO-012 DataSource抽象层
```

---

## 📊 进度追踪

| 任务ID | 名称 | 状态 | 完成时间 |
|--------|------|------|---------|
| AD-TODO-001 | 类型定义 | ✅ completed | 2026-03-24 |
| AD-TODO-002 | 数据库表 | ✅ completed | 2026-03-24 |
| AD-TODO-003 | BatchOperationService | ✅ completed | 2026-03-24 |
| AD-TODO-004 | AI接管中间件 | ✅ completed | 2026-03-24 |
| AD-TODO-005 | 前端目录结构 | ✅ completed | 2026-03-24 |
| AD-TODO-006 | BatchEditModal | ✅ completed | 2026-03-24 |
| AD-TODO-007 | BatchListingModal | ✅ completed | 2026-03-24 |
| AD-TODO-008 | BatchAdModal | ✅ completed | 2026-03-24 |
| AD-TODO-009 | batchOperationDataSource | ✅ completed | 2026-03-24 |
| AD-TODO-010 | BatchOperationController | ✅ completed | 2026-03-24 |
| AD-TODO-011 | AI批量操作API | ✅ completed | 2026-03-24 |
| AD-TODO-012 | 路由注册 | ✅ completed | 2026-03-24 |

---

*本文档为广告系统批量操作任务清单*