新增 3 个关键工程任务: - TASK-005-B: API Mock 与文档定义 (解决前后端并行开发瓶颈) - TASK-005-C: CI/CD 流水线配置 (自动化构建部署) - TASK-030-B: 消息中心后端接口 (补全后端 API) improve.md: Gemini 审阅建议文档 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
40 KiB
tasks.md - SmartAudit 开发任务清单
| 文档类型 | Development Tasks (开发任务清单) |
|---|---|
| 项目名称 | SmartAudit (AI 营销内容合规审核平台) |
| 版本号 | V1.2 |
| 发布日期 | 2026-02-02 |
| 依据文档 | PRD.md, FeatureSummary.md, DevelopmentPlan.md, UIDesign.md, User_Role_Interfaces.md |
| 总周期 | 11 周 (2.75 个月) |
版本历史 (Version History)
| 版本 | 日期 | 作者 | 变更说明 |
|---|---|---|---|
| V1.0 | 2026-02-02 | Claude | 初稿:基于功能清单和开发计划拆解任务 |
| V1.1 | 2026-02-02 | Claude | 补充:代理商/品牌方移动端任务、响应式与无障碍设计任务 |
| V1.2 | 2026-02-02 | Claude | Gemini 审阅优化:新增 API Mock、CI/CD、消息中心后端接口任务 |
1. 任务总览
1.1 开发阶段划分
| 阶段 | 周期 | 核心目标 | 交付物 |
|---|---|---|---|
| Phase 1 | Week 1-2 | 基础设施与 Brief 引擎 | 能上传 PDF 并提取 JSON 规则 |
| Phase 2 | Week 3-6 | 核心 AI 流水线 | 视频输入 → 审核报告输出 |
| Phase 3 | Week 7-9 | 达人端 H5 与审核台 | 达人可上传,代理商可审核 |
| Phase 4 | Week 10-11 | 联调与验收 | v1.0 上线 |
1.2 团队配置
| 角色 | 人数 | 主要职责 |
|---|---|---|
| PM | 1 | 需求管理、进度跟踪 |
| UI/UX | 1 | 界面设计、交互原型 |
| Frontend | 2 | PC 端 + H5 端开发 |
| Backend | 2 | API + 异步任务 + 数据库 |
| AI Engineer | 1 | 模型集成、Prompt 调优 |
| QA | 1 | 测试、验收 |
1.3 功能优先级统计
| 优先级 | 功能数量 | 说明 |
|---|---|---|
| P0 (MVP) | 18 | 必须实现 |
| P1 | 16 | 首版后快速迭代 |
| P2 | 12 | 中长期规划 |
2. Phase 1: 基础设施与 Brief 引擎 (Week 1-2)
2.1 基础设施搭建
TASK-001: 后端框架搭建
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | - |
| 功能编号 | 基础设施 |
任务描述:
- 搭建 FastAPI 项目框架
- 配置项目结构(routes / services / models / utils)
- 配置环境变量管理 (.env)
- 配置日志系统
- 配置 CORS 跨域
验收标准:
- 项目可启动,访问
/health返回 200 - 日志可正常输出到文件和控制台
TASK-002: 数据库设计与初始化
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-001 |
| 功能编号 | 基础设施 |
任务描述:
- PostgreSQL 数据库设计
- 核心表创建:brands, agencies, creators, tasks, briefs, videos, reports, risk_items, rule_sets, audit_logs
- 配置 pgvector 扩展(向量检索)
- 配置 Alembic 数据库迁移
- 创建种子数据
数据模型参考: DevelopmentPlan.md 第 7 章
验收标准:
- 所有核心表创建成功
- pgvector 扩展可用
- 迁移脚本可正常执行
TASK-003: 对象存储接入
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 1d |
| 依赖 | TASK-001 |
| 功能编号 | F-10 |
任务描述:
- 接入阿里云 OSS / AWS S3
- 实现文件上传签名接口(前端直传)
- 实现文件下载签名接口
- 配置 CDN 加速
验收标准:
- 前端可通过签名直传文件到 OSS
- 文件可通过 CDN 访问
TASK-004: Redis 缓存与队列配置
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 1d |
| 依赖 | TASK-001 |
| 功能编号 | F-17 |
任务描述:
- 配置 Redis 连接
- 配置 Celery 异步任务队列
- 实现任务状态存储(用于进度推送)
- 配置任务优先级队列
验收标准:
- Celery Worker 可正常启动
- 异步任务可正常执行
- 任务状态可写入 Redis
TASK-005: 认证与权限系统
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-002 |
| 功能编号 | 基础设施 |
任务描述:
- 实现 JWT 认证
- 实现角色权限控制(品牌方 / 代理商 / 达人)
- 实现多租户数据隔离
- 实现登录/登出接口
权限矩阵参考: User_Role_Interfaces.md 第 1 章
验收标准:
- 用户可正常登录获取 token
- 不同角色访问权限隔离
- 品牌方数据与其他品牌隔离
TASK-005-B: API Mock 与文档定义
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-001 |
| 功能编号 | 基础设施 |
任务描述:
- 定义 OpenAPI (Swagger) 接口文档
- 搭建 Mock Server (YApi/Apifox)
- 生成前端 TypeScript 接口类型定义
- 建立 API 变更通知机制
收益说明: 前端可在 Phase 2 同步开发 Phase 3 的界面,无需等待后端真实接口。
验收标准:
- OpenAPI 文档覆盖核心接口
- 前端可调用 Mock 接口进行 UI 开发
- TypeScript 类型自动生成
TASK-005-C: CI/CD 流水线配置
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 1d |
| 依赖 | TASK-001, TASK-006 |
| 功能编号 | 基础设施 |
任务描述:
- 配置 GitLab CI / GitHub Actions
- 实现代码提交后自动 Lint 检查
- 实现 Docker 镜像自动构建
- 配置 Dev 环境自动部署
验收标准:
- 代码提交后自动触发构建
- Lint 错误阻断合并
- Dev 环境自动更新
2.2 前端框架搭建
TASK-006: PC 端框架搭建
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | - |
| 功能编号 | 基础设施 |
任务描述:
- 搭建 Next.js 项目框架
- 配置 Tailwind CSS
- 配置路由结构(代理商端 / 品牌方端)
- 配置全局状态管理 (Zustand)
- 配置 API 请求封装 (Axios)
- 配置 UI 组件库基础
设计规范参考: UIDesign.md
验收标准:
- 项目可启动访问
- 代理商/品牌方路由可切换
- 全局样式符合设计规范
TASK-007: H5 端框架搭建
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-006 |
| 功能编号 | 基础设施 |
任务描述:
- 在 Next.js 中配置达人端 H5 路由
- 配置响应式布局 (Mobile-First)
- 配置底部导航栏组件
- 配置微信内嵌浏览器适配
设计规范参考: UIDesign.md 第 7 章
验收标准:
- H5 页面在手机浏览器正常显示
- 底部导航栏正常工作
- 微信内置浏览器兼容
2.3 Brief 解析模块
TASK-008: Brief 文档上传接口
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 1d |
| 依赖 | TASK-003 |
| 功能编号 | F-01 |
任务描述:
- 实现 Brief 文档上传接口
- 支持 PDF/Word/Excel/PPT/图片格式
- 文件格式校验
- 触发异步解析任务
验收标准:
- 支持的格式可正常上传
- 不支持的格式返回明确错误
- 上传后触发解析任务
TASK-009: Brief 解析 AI 服务
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-004 |
| 功能编号 | F-01 |
任务描述:
- 集成版面分析模型 (PaddleOCR Layout / LayoutLMv3)
- 集成视觉理解模型 (Qwen-VL / 豆包视觉) 提取 Brief 图片
- 集成 LLM (豆包 Pro / Qwen-Max) 提取结构化规则
- 实现 Prompt 模板:提取卖点、禁忌词、调性要求
- 输出 JSON 格式规则
技术方案参考: DevelopmentPlan.md 第 1.3 章
验收标准:
- PDF Brief 可解析出卖点、禁忌词
- 图文混排 Brief 解析准确率 > 90%
- 输出结构化 JSON
TASK-010: 在线文档链接导入
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-009 |
| 功能编号 | F-02 |
任务描述:
- 实现飞书文档 API 接入
- 实现 Notion API 接入
- 提取在线文档内容
- 触发 Brief 解析流程
约束条件:
- 仅支持用户授权的分享链接
- 不得绕过权限抓取
验收标准:
- 飞书分享链接可导入
- Notion 分享链接可导入
- 无权限链接返回明确错误
TASK-011: 平台规则库管理
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-002 |
| 功能编号 | F-03, F-04 |
任务描述:
- 设计规则库数据结构
- 实现平台规则 CRUD (抖音/小红书/B站/快手)
- 实现区域合规规则切换 (中国大陆/港澳台/海外)
- 实现规则冲突检测
- 实现规则版本管理
验收标准:
- 可按平台加载规则
- 可按区域切换规则
- Brief 与平台规则冲突时提示
TASK-012: Brief 配置中心 UI
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-006, TASK-008, TASK-011 |
| 功能编号 | F-01, F-02, F-03, F-04 |
任务描述:
- 实现拖拽上传组件
- 实现在线文档链接输入
- 实现投放平台选择
- 实现区域合规选择
- 实现 Brief 解析结果展示(Split View)
- 实现规则编辑功能
界面参考: UIDesign.md 第 8.4 章
验收标准:
- 文件可拖拽上传
- 平台/区域可选择
- 解析结果可查看和编辑
TASK-013: 竞品 Logo 向量库搭建
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-002 |
| 功能编号 | F-05-A, F-12 |
任务描述:
- 集成 Grounding DINO 提取 Logo 区域
- 集成 CLIP/DINOv2 生成 Logo Embedding
- 配置 pgvector 存储向量
- 实现 Logo 上传与入库接口
- 实现向量相似度检索接口
技术方案参考: DevelopmentPlan.md 第 1.3 章 Logo 检测架构
验收标准:
- Logo 上传后可生成 Embedding
- 相似 Logo 检索召回率 ≥ 95%
- 新 Logo 上传即刻生效
3. Phase 2: 核心 AI 流水线 (Week 3-6)
3.1 视频上传模块
TASK-014: Tus 断点续传服务
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-003 |
| 功能编号 | F-10, F-30 |
任务描述:
- 部署 Tus 服务端 (tusd)
- 配置分片大小 (5MB)
- 配置 OSS 直传集成
- 实现上传完成回调
技术方案参考: DevelopmentPlan.md 第 2.1 章
验收标准:
- 100MB 视频可分片上传
- 断网后可断点续传
- 上传完成触发回调
TASK-015: 视频上传前端组件
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-007, TASK-014 |
| 功能编号 | F-10 |
任务描述:
- 集成 Uppy.js Tus 插件
- 实现上传进度条
- 实现文件格式/大小校验 (≤100MB, MP4/MOV)
- 实现 Wake Lock API 防锁屏
- 实现断点续传 UI
技术方案参考: DevelopmentPlan.md 第 2.1.1 章
验收标准:
- 视频可正常上传
- 进度条实时更新
- iOS 上传时防锁屏提示
3.2 多模态 AI 流水线
TASK-016: ASR 语音识别服务
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-004 |
| 功能编号 | F-11, F-13 |
任务描述:
- 接入阿里云 Paraformer / SenseVoice
- 实现音频提取 (ffmpeg)
- 实现语音转文字
- 输出带时间戳的逐字文本
验收标准:
- ASR 字错率 ≤ 10%(普通话)
- 输出包含时间戳
TASK-017: OCR 字幕识别服务
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-004 |
| 功能编号 | F-11 |
任务描述:
- 集成 PaddleOCR v4
- 实现关键帧提取 (2fps)
- 实现字幕区域检测
- 输出带时间戳的字幕文本
验收标准:
- OCR 准确率 ≥ 95%(含复杂背景)
- 输出包含时间戳
TASK-018: CV 画面检测服务
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-013 |
| 功能编号 | F-12, F-45 |
任务描述:
- 实现逐帧 Logo 检测 (Grounding DINO)
- 实现 Logo 向量匹配 (pgvector)
- 实现产品出现检测
- 输出带时间戳的检测结果
验收标准:
- 竞品 Logo F1 ≥ 0.85(含遮挡 30% 场景)
- 输出包含时间戳
TASK-019: 多模态时间戳对齐算法
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-016, TASK-017, TASK-018 |
| 功能编号 | F-14, F-45 |
任务描述:
- 实现时间轴归一化(毫秒 → 秒)
- 实现模糊匹配窗口(±0.5s 容差)
- 实现事件合并(同一时间窗口的多模态事件)
- 输出统一的结构化时间轴数据
技术方案参考: DevelopmentPlan.md 第 2.5 章
验收标准:
- 时长统计误差 ≤ 0.5秒
- 频次统计准确率 ≥ 95%
TASK-020: 语义分析与语境理解
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-016, TASK-017 |
| 功能编号 | F-09, F-08 |
任务描述:
- 实现内容分段(剧情段 vs 广告段)
- 实现语境理解 Prompt(区分广告语境与日常语境)
- 实现违禁词检测(结合语境)
- 实现卖点覆盖检测
- 输出修改建议
技术方案参考: DevelopmentPlan.md 第 2.3 章
验收标准:
- 广告极限词误报率 ≤ 5%(样本量 ≥ 1,000)
- "最开心的一天"不误判为违规
TASK-021: 时长与频次校验
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-019 |
| 功能编号 | F-45 |
任务描述:
- 实现产品同框时长统计
- 实现品牌词提及频次统计
- 实现与 Brief 要求的对比
- 输出时长/频次校验报告
验收标准:
- 时长统计误差 ≤ 0.5秒
- 频次统计准确率 ≥ 95%
TASK-022: 视频审核流水线编排
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-016-021 |
| 功能编号 | F-11 |
任务描述:
- 实现 Celery 任务链编排
- 并行执行 ASR/OCR/CV
- 汇总多模态结果
- 生成审核报告
- 存储到数据库
验收标准:
- 100MB 视频审核 ≤ 5 分钟
- 审核报告包含所有检测结果
3.3 实时进度推送
TASK-023: WebSocket 进度推送服务
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-004, TASK-022 |
| 功能编号 | F-17 |
任务描述:
- 部署 Socket.io 服务
- 订阅 Redis 任务状态
- 实现进度推送协议
- 实现断线重连
验收标准:
- 每个子步骤完成后推送进度
- 断线后可自动重连
TASK-024: 透明思考 UI 组件
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-007, TASK-023 |
| 功能编号 | F-17 |
任务描述:
- 实现环形进度组件
- 实现步骤列表组件
- 实现 WebSocket 连接
- 实现进度实时更新
- 实现"离开并稍后查看"功能
界面参考: UIDesign.md 第 7.4 章
验收标准:
- 进度实时更新
- 显示当前步骤描述
- 用户可离开页面
3.4 弹性 GPU 集群
TASK-025: 弹性 GPU 服务接入
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-016-021 |
| 功能编号 | 基础设施 |
任务描述:
- 接入阿里云 PAI-EAS / 火山引擎 veFaaS
- 配置自动扩缩容策略
- 配置 GPU 资源监控
- 实现负载均衡
技术方案参考: DevelopmentPlan.md 第 5 章
验收标准:
- 高并发时自动扩容
- 空闲时缩容至 0
- GPU 利用率可监控
4. Phase 3: 达人端 H5 与审核台 (Week 7-9)
4.1 达人端 H5 页面
TASK-026: 达人端任务列表页
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-007 |
| 功能编号 | - |
任务描述:
- 实现任务卡片组件
- 实现状态筛选 Tab(全部/待提交/审核中/已完成)
- 实现任务状态标签
- 实现下拉刷新
界面参考: UIDesign.md 第 7.3 章
验收标准:
- 任务列表正常展示
- 状态筛选正常工作
- 下拉刷新正常
TASK-027: 达人端智能上传页
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-015, TASK-024 |
| 功能编号 | F-07, F-10, F-17 |
任务描述:
- 实现文本脚本输入
- 实现视频上传(复用 TASK-015)
- 实现透明思考 UI(复用 TASK-024)
- 实现防锁屏提示
界面参考: UIDesign.md 第 7.4 章
验收标准:
- 脚本可提交预审
- 视频可上传
- 进度实时展示
TASK-028: 达人端审核结果页
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-027 |
| 功能编号 | F-08, F-14 |
任务描述:
- 实现结果横幅(通过/警告/驳回)
- 实现视频播放器(带时间戳标注)
- 实现修改清单组件
- 实现时间点跳转
- 实现申诉入口
界面参考: UIDesign.md 第 7.5 章
验收标准:
- 审核结果正常展示
- 点击时间戳可跳转视频
- 申诉入口可用
TASK-029: 达人端申诉弹窗
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 1d |
| 依赖 | TASK-028 |
| 功能编号 | F-24, F-25 |
任务描述:
- 实现申诉弹窗 UI
- 实现理由输入(≥10字校验)
- 实现证据上传
- 显示剩余令牌数
界面参考: UIDesign.md 第 7.6 章
验收标准:
- 申诉弹窗正常弹出
- 输入校验正常
- 令牌数正确显示
TASK-030: 达人端消息中心
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-007 |
| 功能编号 | F-27 |
任务描述:
- 实现消息列表
- 实现消息类型图标
- 实现左滑标记已读
- 实现点击跳转
界面参考: User_Role_Interfaces.md 第 2.4 章
验收标准:
- 消息列表正常展示
- 左滑操作正常
- 点击可跳转
TASK-030-B: 消息中心后端接口
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P1 |
| 预估工时 | 1d |
| 依赖 | TASK-002, TASK-023 |
| 功能编号 | F-27 |
任务描述:
- 实现消息列表 API (分页/类型筛选)
- 实现未读数查询 API
- 实现"全部已读/单条已读" API
- 实现消息过期清理策略
验收标准:
- 可拉取历史消息(分页)
- 未读数同步准确
- 已读状态更新正常
4.2 代理商端 PC 页面
TASK-031: 代理商端工作台
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-006 |
| 功能编号 | - |
任务描述:
- 实现侧边栏导航
- 实现待办事项卡片
- 实现项目进度条
- 实现最近活动列表
界面参考: UIDesign.md 第 8.3 章
验收标准:
- 侧边栏导航正常
- 待办数量正确
- 活动列表实时更新
TASK-032: 审核决策台 - 视频播放器
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-006 |
| 功能编号 | F-19 |
任务描述:
- 实现视频播放器组件
- 实现智能进度条(红/黄/绿点)
- 实现点击跳转
- 实现 Brief 参考图悬浮
界面参考: UIDesign.md 第 8.5 章
验收标准:
- 视频正常播放
- 进度条标注正确
- 点击可跳转
TASK-033: 审核决策台 - AI 检查单
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-032 |
| 功能编号 | F-19, F-23 |
任务描述:
- 实现硬性合规区块
- 实现 Brief 完成度区块
- 实现舆情雷达区块
- 实现展开详情
- 实现规则依据查看
界面参考: UIDesign.md 第 8.5 章
验收标准:
- 三个区块正常展示
- 详情可展开
- 规则依据可查看
TASK-034: 审核决策台 - 决策操作
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend + Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-033 |
| 功能编号 | F-20, F-21 |
任务描述:
- 实现驳回按钮(自动打包问题)
- 实现通过按钮
- 实现强制通过按钮(需填原因)
- 实现记录特例按钮
- 实现审核状态流转 API
验收标准:
- 驳回后达人收到通知
- 强制通过需填写原因
- 审计日志记录操作
4.3 申诉与仲裁
TASK-035: 申诉后端接口
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-002 |
| 功能编号 | F-24, F-25, F-26 |
任务描述:
- 实现申诉提交接口
- 实现令牌扣除/返还逻辑
- 实现仲裁接口
- 实现申诉结果通知
验收标准:
- 申诉可正常提交
- 令牌正确扣除/返还
- 仲裁后通知达人
TASK-036: 代理商端申诉仲裁页
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-031, TASK-035 |
| 功能编号 | F-26 |
任务描述:
- 实现申诉列表
- 实现申诉详情查看
- 实现仲裁操作(通过/拒绝)
验收标准:
- 申诉列表正常展示
- 仲裁操作正常
4.4 数据看板
TASK-037: 核心指标卡片
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend + Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-006 |
| 功能编号 | F-33 |
任务描述:
- 实现指标统计 API
- 实现指标卡片组件
- 展示:审核总量、通过率、召回率、舆情拦截、平均周期
界面参考: UIDesign.md 第 9.2 章
验收标准:
- 指标数据正确
- 卡片样式符合设计
4.5 代理商端移动端页面
界面参考:User_Role_Interfaces.md 第 3.8 章
TASK-037A: 代理商移动端工作台
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-031 |
| 功能编号 | - |
任务描述:
- 实现移动端待办事项卡片(待审核/待仲裁/今日通过/进行中)
- 实现紧急待办列表
- 实现移动端底部导航栏
- 实现响应式布局适配
界面参考: User_Role_Interfaces.md 第 3.8.1 章
验收标准:
- 核心指标卡片正常展示
- 紧急待办可点击跳转
- 底部导航正常工作
TASK-037B: 代理商移动端快捷审核
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 3d |
| 依赖 | TASK-032, TASK-037A |
| 功能编号 | F-19, F-20 |
任务描述:
- 实现移动端视频播放器(支持横屏全屏)
- 实现问题列表折叠展开
- 实现点击问题跳转视频时间点
- 实现驳回/通过/强制通过操作
- 复杂操作引导至桌面端
界面参考: User_Role_Interfaces.md 第 3.8.2 章
验收标准:
- 视频播放器横屏模式正常
- 问题点击跳转正常
- 审核操作正常提交
TASK-037C: 代理商移动端任务列表与消息
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-037A |
| 功能编号 | - |
任务描述:
- 实现移动端任务列表页(筛选、状态标签)
- 实现移动端消息中心(通知类型图标、左滑操作)
- 实现点击跳转详情
界面参考: User_Role_Interfaces.md 第 3.8.3-3.8.4 章
验收标准:
- 任务列表筛选正常
- 消息中心左滑标记已读正常
- 点击通知跳转正常
4.6 品牌方端页面
TASK-037D: 品牌方 PC 端数据看板
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend + Backend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-006, TASK-037 |
| 功能编号 | F-33, F-34, F-35 |
任务描述:
- 实现顶部指标卡片(审核总量/通过率/召回率/舆情拦截/周期)
- 实现趋势图与问题分布饼图
- 实现代理商对比柱状图
- 实现风险预警区
界面参考: User_Role_Interfaces.md 第 4.1 章
验收标准:
- 指标数据正确
- 图表交互正常
- 预警列表实时更新
TASK-037E: 品牌方 PC 端规则配置
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend + Backend |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | TASK-011 |
| 功能编号 | F-03, F-04, F-05 |
任务描述:
- 实现黑白名单管理界面
- 实现竞品 Logo 上传与阈值设置
- 实现区域合规配置切换
- 实现舆情阈值设置(High/Medium/Low)
- 实现规则版本管理界面
界面参考: User_Role_Interfaces.md 第 4.2 章
验收标准:
- 规则 CRUD 正常
- 区域切换正常
- 版本回滚正常
TASK-037F: 品牌方移动端数据看板
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-037D |
| 功能编号 | F-33 |
任务描述:
- 实现移动端指标卡片
- 实现简化趋势图
- 实现移动端底部导航栏
- 日期筛选下拉
界面参考: User_Role_Interfaces.md 第 4.6.1 章
验收标准:
- 指标卡片正常展示
- 趋势图简化版正常
- 日期筛选正常
TASK-037G: 品牌方移动端舆情预警
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-037F |
| 功能编号 | F-35, F-41 |
任务描述:
- 实现预警列表(紧急/关注分类)
- 实现预警详情卡片
- 实现点击跳转查看
界面参考: User_Role_Interfaces.md 第 4.6.2 章
验收标准:
- 预警分类展示正常
- 点击跳转正常
TASK-037H: 品牌方移动端审批中心
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend + Backend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | TASK-034, TASK-037F |
| 功能编号 | F-21 |
任务描述:
- 实现待审批列表
- 实现强制通过审批卡片(含视频预览)
- 实现批准/拒绝操作
- 审批记录同步至审计日志
界面参考: User_Role_Interfaces.md 第 4.6.3 章
验收标准:
- 审批列表正常展示
- 视频片段预览正常
- 审批操作正常
TASK-037I: 品牌方移动端审计日志
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 1d |
| 依赖 | TASK-037F |
| 功能编号 | F-38, F-40 |
任务描述:
- 实现审计日志列表
- 实现筛选(时间/代理商/状态)
- 实现证据链导出入口
界面参考: User_Role_Interfaces.md 第 4.6.4 章
验收标准:
- 日志列表正常展示
- 筛选功能正常
- 导出入口可用
4.7 响应式设计与无障碍
规范参考:User_Role_Interfaces.md 第 7-8 章
TASK-037J: 响应式布局适配
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-006, TASK-007 |
| 功能编号 | 基础设施 |
任务描述:
- 配置响应式断点(Mobile < 768px / Tablet 768-1024px / Desktop > 1024px)
- 达人端 Mobile-First 布局
- 代理商端侧边栏折叠适配(Tablet 下收起为图标模式)
- 品牌方端最小宽度 1280px 处理
规范参考: User_Role_Interfaces.md 第 7 章
验收标准:
- 三端断点切换正常
- 侧边栏折叠动画流畅
- 移动端底部导航栏正常
TASK-037K: 无障碍设计实现
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 预估工时 | 2d |
| 依赖 | Phase 3 全部 UI 任务 |
| 功能编号 | 基础设施 |
任务描述:
- 确保颜色对比度 ≥ 4.5:1
- 实现键盘导航(Tab 键访问所有交互元素)
- 添加 ARIA 标签
- 红/黄/绿状态增加图标和文字区分
- 视频播放器支持字幕轨道和键盘控制
- 实现"减少动态效果"选项
规范参考: User_Role_Interfaces.md 第 8 章(WCAG 2.1 AA 级)
验收标准:
- 颜色对比度检测通过
- 键盘导航覆盖所有交互
- 屏幕阅读器兼容性测试通过
4.8 错误处理与边界情况
规范参考:User_Role_Interfaces.md 第 9 章
TASK-037L: 错误处理与空状态
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-006, TASK-007 |
| 功能编号 | 基础设施 |
任务描述:
- 实现网络错误重试机制(自动重试 3 次,指数退避)
- 实现上传失败提示与校验
- 实现空状态设计(任务列表/审核队列/搜索结果/数据看板)
- 实现加载状态规范(骨架屏/进度条/Spinner)
- 实现并发冲突提示
规范参考: User_Role_Interfaces.md 第 9 章
验收标准:
- 错误提示用户友好
- 空状态有引导动作
- 加载状态符合规范
5. Phase 4: 联调与验收 (Week 10-11)
5.1 测试任务
TASK-038: 单元测试
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | Phase 1-3 |
| 功能编号 | 测试 |
任务描述:
- 编写后端业务逻辑单元测试
- 编写工具函数测试
- 测试覆盖率 ≥ 70%
验收标准:
- 单元测试全部通过
- 覆盖率 ≥ 70%
TASK-039: E2E 测试
| 属性 | 内容 |
|---|---|
| 负责人 | QA |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | Phase 1-3 |
| 功能编号 | 测试 |
任务描述:
- 编写核心用户流程 E2E 测试(Playwright)
- 达人:上传 → 等待 → 查看结果 → 申诉
- 代理商:配置 Brief → 审核 → 驳回/通过
- 品牌方:查看数据 → 配置规则
验收标准:
- 核心流程 E2E 测试通过
TASK-040: AI 模型测试
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer + QA |
| 优先级 | P0 |
| 预估工时 | 3d |
| 依赖 | Phase 2 |
| 功能编号 | 测试 |
任务描述:
- 准备测试集(违禁词 500+500,Logo 200张,Brief 50份,语境 1000句)
- 执行模型评估
- 记录指标:召回率、误报率、F1、准确率
验收标准:
- 违禁词召回率 ≥ 95%,误报率 ≤ 5%
- Logo F1 ≥ 0.85
- 语境理解误报率 ≤ 5%
- Brief 解析准确率 > 90%
TASK-041: 性能测试
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + QA |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | Phase 1-3 |
| 功能编号 | 测试 |
任务描述:
- 使用 Locust 进行并发测试
- 测试 100 并发下系统表现
- 测试队列积压处理能力
验收标准:
- 100 并发无异常
- 视频审核 ≤ 5 分钟
TASK-042: H5 兼容性测试
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend + QA |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | Phase 3 |
| 功能编号 | 测试 |
任务描述:
- 使用 BrowserStack 测试
- 测试 iOS Safari / Android Chrome / 微信内置浏览器
- 测试文件上传、进度展示、播放器
验收标准:
- iOS Safari 正常
- Android Chrome 正常
- 微信内置浏览器正常
5.2 部署与上线
TASK-043: 生产环境部署
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P0 |
| 预估工时 | 2d |
| 依赖 | TASK-038-042 |
| 功能编号 | 部署 |
任务描述:
- 部署生产环境服务
- 配置 CDN
- 配置 HTTPS
- 配置监控告警
验收标准:
- 生产环境可访问
- HTTPS 正常
- 监控告警配置完成
TASK-044: 灰度发布
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + PM |
| 优先级 | P0 |
| 预估工时 | 1d |
| 依赖 | TASK-043 |
| 功能编号 | 部署 |
任务描述:
- 配置灰度发布策略
- 邀请种子用户测试
- 收集反馈
验收标准:
- 灰度用户可正常使用
- 收集到有效反馈
6. P1 功能任务 (V1.1 迭代)
以下任务在 MVP 上线后快速迭代
6.1 高级规则配置
TASK-045: 高级豁免规则配置
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + Frontend |
| 优先级 | P1 |
| 功能编号 | F-05-B |
任务描述:
- 实现特定达人豁免规则
- 实现特定场景豁免规则
- 实现条件组合逻辑
TASK-046: 规则版本管理
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + Frontend |
| 优先级 | P1 |
| 功能编号 | F-06 |
任务描述:
- 实现规则变更历史
- 实现版本回滚
- 实现变更审批流程
6.2 Brand Safety 与舆情
TASK-047: Brand Safety 软性风险检测
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P1 |
| 功能编号 | F-15 |
任务描述:
- 实现油腻检测 Prompt
- 实现爹味说教检测 Prompt
- 实现性别偏见检测 Prompt
- 输出为软性提示(不强制拦截)
TASK-048: 分区审核规则
| 属性 | 内容 |
|---|---|
| 负责人 | AI Engineer |
| 优先级 | P1 |
| 功能编号 | F-16 |
任务描述:
- 实现广告段 vs 剧情段分类
- 实现不同审核尺度
TASK-049: 舆情阈值设置
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + Frontend |
| 优先级 | P1 |
| 功能编号 | F-43 |
任务描述:
- 实现舆情敏感度配置(High/Medium/Low)
- 支持按平台差异化配置
6.3 审计与证据
TASK-050: 审计日志
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + Frontend |
| 优先级 | P1 |
| 功能编号 | F-38, F-39 |
任务描述:
- 实现审核记录查询
- 实现完整审核链路查看
TASK-051: 证据链 PDF 导出
| 属性 | 内容 |
|---|---|
| 负责人 | Backend |
| 优先级 | P1 |
| 功能编号 | F-40 |
任务描述:
- 实现 PDF 报告生成
- 包含时间戳、截图、规则依据、审核人、版本号
6.4 数据看板增强
TASK-052: 趋势图表
| 属性 | 内容 |
|---|---|
| 负责人 | Frontend |
| 优先级 | P1 |
| 功能编号 | F-34 |
任务描述:
- 实现审核量趋势图
- 实现问题分布饼图
- 实现热力图
TASK-053: 风险预警
| 属性 | 内容 |
|---|---|
| 负责人 | Backend + Frontend |
| 优先级 | P1 |
| 功能编号 | F-35 |
任务描述:
- 实现异常检测算法
- 实现预警卡片展示
- 实现通知推送
7. P2 功能任务 (V2 规划)
以下任务在中长期规划中实现
| 任务编号 | 功能 | 功能编号 |
|---|---|---|
| TASK-054 | 版本差异报告 | F-28 |
| TASK-055 | 双屏同步播放 | F-29 |
| TASK-056 | 批量上传(多文件拖拽) | F-30 |
| TASK-057 | 批量审核 | F-31 |
| TASK-058 | 批量导出 | F-32 |
| TASK-059 | 达人排行榜 | F-37 |
| TASK-060 | 舆情风险视频监控 | F-41 |
| TASK-061 | 舆情案例库 | F-42 |
| TASK-062 | 负样本清洗与回流 | F-46 |
8. 任务依赖关系图
graph TD
subgraph Phase1 [Phase 1: 基础设施]
T001[TASK-001 后端框架]
T002[TASK-002 数据库]
T003[TASK-003 OSS]
T004[TASK-004 Redis]
T005[TASK-005 认证]
T005B[TASK-005-B API Mock]
T005C[TASK-005-C CI/CD]
T006[TASK-006 PC前端]
T007[TASK-007 H5前端]
T009[TASK-009 Brief解析AI]
T013[TASK-013 Logo向量库]
T001 --> T002
T001 --> T003
T001 --> T004
T001 --> T005B
T002 --> T005
T001 --> T005C
T006 --> T005C
T006 --> T007
end
subgraph Phase2 [Phase 2: AI流水线]
T014[TASK-014 Tus上传]
T016[TASK-016 ASR]
T017[TASK-017 OCR]
T018[TASK-018 CV]
T019[TASK-019 时间戳对齐]
T020[TASK-020 语义分析]
T022[TASK-022 流水线编排]
T023[TASK-023 WebSocket]
T003 --> T014
T004 --> T016
T004 --> T017
T013 --> T018
T016 --> T019
T017 --> T019
T018 --> T019
T019 --> T022
T020 --> T022
T004 --> T023
end
subgraph Phase3 [Phase 3: 界面开发]
T027[TASK-027 达人上传页]
T028[TASK-028 达人结果页]
T030[TASK-030 消息中心前端]
T030B[TASK-030-B 消息中心后端]
T032[TASK-032 审核台播放器]
T033[TASK-033 AI检查单]
T034[TASK-034 决策操作]
T037[TASK-037 数据看板]
T037A[TASK-037A 代理商移动工作台]
T037B[TASK-037B 代理商移动审核]
T037D[TASK-037D 品牌方数据看板]
T037E[TASK-037E 品牌方规则配置]
T037F[TASK-037F 品牌方移动看板]
T037J[TASK-037J 响应式布局]
T037L[TASK-037L 错误处理]
T014 --> T027
T023 --> T027
T027 --> T028
T023 --> T030B
T030B --> T030
T032 --> T033
T033 --> T034
T032 --> T037A
T037A --> T037B
T037 --> T037D
T037D --> T037F
T006 --> T037J
T007 --> T037J
T006 --> T037L
end
Phase1 --> Phase2
Phase2 --> Phase3
9. 验收标准汇总
| 验收项 | 标准 | 对应任务 |
|---|---|---|
| Brief 解析准确率 | > 90% | TASK-009 |
| 竞品 Logo F1 | ≥ 0.85 | TASK-018 |
| 语境理解误报率 | ≤ 5% | TASK-020 |
| ASR 字错率 | ≤ 10% | TASK-016 |
| OCR 准确率 | ≥ 95% | TASK-017 |
| 时长统计误差 | ≤ 0.5秒 | TASK-021 |
| 频次统计准确率 | ≥ 95% | TASK-021 |
| 审核报告产出时间 | ≤ 5 分钟 | TASK-022 |
| 并发支持 | 100 并发 | TASK-041 |
| H5 兼容性 | iOS/Android/微信 | TASK-042 |
| 响应式断点适配 | Mobile/Tablet/Desktop | TASK-037J |
| 无障碍 WCAG 2.1 AA | 颜色对比度 ≥ 4.5:1 | TASK-037K |
| 移动端审核功能 | 代理商/品牌方移动端可用 | TASK-037A-I |
10. 相关文档
| 文档 | 说明 |
|---|---|
| PRD.md | 产品需求文档 |
| FeatureSummary.md | 功能清单与优先级 |
| DevelopmentPlan.md | 开发计划与技术架构 |
| UIDesign.md | UI 设计规范 |
| User_Role_Interfaces.md | 用户角色与界面规范 |