Files
makemd/docs/TASKS/AD_TODO.md
wurenzhi 2748456d8a refactor(services): 重构服务文件结构,将服务按功能分类到不同目录
- 将服务文件按功能分类到core、ai、analytics、security等目录
- 修复logger导入路径问题,统一使用相对路径
- 更新相关文件的导入路径引用
- 添加新的批量操作组件导出文件
- 修复dashboard页面中的类型错误
- 添加dotenv依赖到package.json
2026-03-25 13:46:26 +08:00

8.4 KiB
Raw Blame History

广告系统批量操作 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

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