refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
127
docs/ARCHIVE/00_Business/tasks/backend/08_advertisement.md
Normal file
127
docs/ARCHIVE/00_Business/tasks/backend/08_advertisement.md
Normal file
@@ -0,0 +1,127 @@
|
||||
# 广告计划与营销后端任务
|
||||
|
||||
## 任务列表
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
|
||||
| -------- | --------- | -------- | ---------- | ----- | ---- | ----------- | --- | -------- | ---- | ------------ | -------- |
|
||||
| BE-AD001 | 广告计划与营销闭环 | 广告计划创建接口 | 广告参数 | 广告ID | 前端提交 | ✅ completed | P0 | - | 12h | AI-Backend-4 | 2026-03-20 |
|
||||
| BE-AD002 | 广告计划与营销闭环 | 广告投放引擎 | 广告ID, 投放参数 | 投放状态 | 定时任务 | ✅ completed | P0 | BE-AD001 | 16h | AI-Backend-4 | 2026-03-20 |
|
||||
| BE-AD003 | 广告计划与营销闭环 | ROI计算接口 | 广告ID, 时间范围 | ROI数据 | 定时任务 | ✅ completed | P0 | BE-AD001 | 10h | AI-Backend-4 | 2026-03-20 |
|
||||
| BE-AD004 | 全渠道营销整合闭环 | 多渠道整合接口 | 渠道列表, 营销参数 | 整合结果 | 前端提交 | ✅ completed | P1 | BE-AD001 | 8h | AI-Backend-1 | 2026-03-20 |
|
||||
| BE-AD005 | 全渠道营销整合闭环 | 智能营销自动化接口 | 用户行为, 触发规则 | 自动化任务 | 行为触发 | ✅ completed | P1 | BE-AD004 | 10h | AI-Backend-1 | 2026-03-20 |
|
||||
| BE-AD006 | 全渠道营销整合闭环 | 营销效果分析接口 | 营销活动, 时间范围 | 分析报告 | 定时任务 | ✅ completed | P1 | BE-AD004 | 6h | AI-Backend-1 | 2026-03-20 |
|
||||
| BE-AD007 | 全渠道营销整合闭环 | A/B测试自动化接口 | 测试参数, 变体列表 | 测试结果 | 前端提交 | ✅ completed | P1 | BE-AD004 | 8h | AI-Backend-1 | 2026-03-20 |
|
||||
|
||||
## 相关闭环
|
||||
|
||||
- 广告计划与营销闭环
|
||||
- 全渠道营销整合闭环
|
||||
|
||||
## 依赖关系
|
||||
|
||||
```
|
||||
BE-AD001 ─┬─► BE-AD002
|
||||
├─► BE-AD003
|
||||
└─► BE-AD004 ─┬─► BE-AD005
|
||||
├─► BE-AD006
|
||||
└─► BE-AD007
|
||||
```
|
||||
|
||||
## 数据库表结构
|
||||
|
||||
### cf_ad_campaign
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 广告计划ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| name | string | 广告名称 |
|
||||
| type | string | 广告类型 |
|
||||
| budget | decimal(10,2) | 预算 |
|
||||
| start_date | datetime | 开始日期 |
|
||||
| end_date | datetime | 结束日期 |
|
||||
| status | enum | DRAFT/ACTIVE/PAUSED/ENDED |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
### cf_ad_performance
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 性能记录ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| campaign_id | string | 广告计划ID |
|
||||
| date | date | 日期 |
|
||||
| impressions | integer | 展示量 |
|
||||
| clicks | integer | 点击量 |
|
||||
| conversions | integer | 转化量 |
|
||||
| spend | decimal(10,2) | 花费 |
|
||||
| revenue | decimal(10,2) | 收入 |
|
||||
| roi | decimal(5,2) | 投资回报率 |
|
||||
|
||||
### cf_marketing_activity
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| id | string | 营销活动ID |
|
||||
| tenant_id | string | 租户ID |
|
||||
| name | string | 活动名称 |
|
||||
| channels | json | 渠道列表 |
|
||||
| start_date | datetime | 开始日期 |
|
||||
| end_date | datetime | 结束日期 |
|
||||
| status | enum | PLANNING/ACTIVE/ENDED |
|
||||
| created_at | datetime | 创建时间 |
|
||||
| updated_at | datetime | 更新时间 |
|
||||
|
||||
## API端点
|
||||
|
||||
### 广告管理API
|
||||
- `GET /api/advertisement/campaigns` - 获取广告计划列表
|
||||
- `POST /api/advertisement/campaigns` - 创建广告计划
|
||||
- `GET /api/advertisement/campaigns/:id` - 获取广告计划详情
|
||||
- `PUT /api/advertisement/campaigns/:id` - 更新广告计划
|
||||
- `POST /api/advertisement/campaigns/:id/activate` - 激活广告
|
||||
- `POST /api/advertisement/campaigns/:id/pause` - 暂停广告
|
||||
- `GET /api/advertisement/performance/:campaignId` - 获取广告性能
|
||||
- `GET /api/advertisement/roi/:campaignId` - 获取ROI数据
|
||||
|
||||
### 营销管理API
|
||||
- `GET /api/marketing/activities` - 获取营销活动列表
|
||||
- `POST /api/marketing/activities` - 创建营销活动
|
||||
- `GET /api/marketing/activities/:id` - 获取营销活动详情
|
||||
- `GET /api/marketing/analysis/:activityId` - 获取营销效果分析
|
||||
- `POST /api/marketing/ab-test` - 创建A/B测试
|
||||
- `GET /api/marketing/ab-test/:id/results` - 获取A/B测试结果
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [ ] 广告计划创建接口能正确创建和配置广告计划
|
||||
- [ ] 广告投放引擎能准确执行广告投放
|
||||
- [ ] ROI计算接口能正确计算广告投资回报率
|
||||
- [ ] 多渠道整合接口能整合不同渠道的营销活动
|
||||
- [ ] 智能营销自动化接口能根据用户行为触发自动化任务
|
||||
- [ ] 所有接口响应时间不超过2秒
|
||||
- [ ] 数据一致性得到保证
|
||||
|
||||
## 测试要求
|
||||
|
||||
- [ ] 单元测试：覆盖广告投放和ROI计算逻辑
|
||||
- [ ] 集成测试：验证与其他系统的交互
|
||||
- [ ] 端到端测试：模拟完整的广告和营销流程
|
||||
- [ ] 性能测试：验证高并发下的性能
|
||||
|
||||
## 风险提示
|
||||
|
||||
- **风险点1**：广告投放成本超预算 - 应对措施：实现预算监控和自动暂停机制
|
||||
- **风险点2**：ROI计算不准确 - 应对措施：优化数据采集和计算算法
|
||||
- **风险点3**：多渠道整合复杂度高 - 应对措施：建立统一的渠道管理框架
|
||||
|
||||
## 性能要求
|
||||
|
||||
- 响应时间：平均响应时间 < 2秒
|
||||
- 并发处理：支持300个并发请求
|
||||
- 数据处理：能处理10000条广告数据/小时
|
||||
|
||||
## 安全要求
|
||||
|
||||
- 权限控制：只有ADMIN和MARKETING角色可访问广告和营销数据
|
||||
- 审计日志：所有广告和营销操作需记录详细日志
|
||||
- 输入验证：严格验证所有广告和营销相关输入
|
||||
- 数据一致性：确保广告和营销数据的准确性和一致性
|
||||
Reference in New Issue
Block a user