wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
22308fe0422d81261ccc95fe314e12c264a45d91
makemd/docs/TASKS/AD_TODO.md

341 lines
8.4 KiB
Markdown
Raw Normal View History

refactor(services): 重构服务文件结构，将服务按功能分类到不同目录 - 将服务文件按功能分类到core、ai、analytics、security等目录 - 修复logger导入路径问题，统一使用相对路径 - 更新相关文件的导入路径引用 - 添加新的批量操作组件导出文件 - 修复dashboard页面中的类型错误 - 添加dotenv依赖到package.json
2026-03-25 13:46:26 +08:00
# 广告系统批量操作 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 |
---
*本文档为广告系统批量操作任务清单*
Reference in New Issue Copy Permalink