wurenzhi
2748456d8a
- 将服务文件按功能分类到core、ai、analytics、security等目录 - 修复logger导入路径问题，统一使用相对路径 - 更新相关文件的导入路径引用 - 添加新的批量操作组件导出文件 - 修复dashboard页面中的类型错误 - 添加dotenv依赖到package.json
341 lines
8.4 KiB
Markdown
341 lines
8.4 KiB
Markdown
# 广告系统批量操作 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 |
|
||
|
||
---
|
||
|
||
*本文档为广告系统批量操作任务清单*
|