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