wurenzhi
48a78137c5
- 将B2B统一为TOB术语 - 将状态值统一为大写格式 - 优化类型声明，避免使用any - 将float类型替换为decimal以提高精度 - 新增术语标准化文档 - 优化路由结构和菜单分类 - 添加TypeORM实体类 - 增强加密模块安全性 - 重构前端路由结构 - 完善任务模板和验收标准
127 lines
5.6 KiB
Markdown
127 lines
5.6 KiB
Markdown
# 广告计划与营销后端任务
|
||
|
||
## 任务列表
|
||
|
||
| 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角色可访问广告和营销数据
|
||
- 审计日志：所有广告和营销操作需记录详细日志
|
||
- 输入验证：严格验证所有广告和营销相关输入
|
||
- 数据一致性：确保广告和营销数据的准确性和一致性 |