# tasks.md - SmartAudit 开发任务清单

| 文档类型 | **Development Tasks (开发任务清单)** |
| --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) |
| **版本号** | V1.4 |
| **发布日期** | 2026-02-03 |
| **依据文档** | PRD.md, FeatureSummary.md, DevelopmentPlan.md, UIDesign.md, User_Role_Interfaces.md, AIProviderConfig.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、消息中心后端接口任务 |
| V1.3 | 2026-02-02 | Claude | 确立 TDD 为核心开发规范 |
| V1.4 | 2026-02-02 | Claude | 新增 AI 服务配置任务（TASK-005-D/E/F） |

---

## 0. 开发规范：TDD（测试驱动开发）

> ⭐ **重要声明：本项目全程遵循 TDD 开发模式**

### 0.1 TDD 核心原则

**所有功能代码必须遵循「红-绿-重构」循环：**

1. 🔴 **RED** - 先写一个失败的测试
2. 🟢 **GREEN** - 写最少的代码让测试通过
3. 🔄 **REFACTOR** - 重构代码，保持测试通过

### 0.2 每个任务的 TDD 要求

| 任务类型 | TDD 要求 | 测试工具 |
| --- | --- | --- |
| 后端业务逻辑 | 严格 TDD（先写测试） | pytest |
| API 接口 | 契约优先 + 测试验证 | pytest + httpx |
| AI 模型封装 | 接口测试 + 标注集验证 | pytest + 标注数据 |
| 前端组件 | 组件级 TDD | Vitest + RTL |
| 前端 Hooks/Store | 先写测试 | Vitest |
| E2E 流程 | BDD 场景覆盖 | Playwright |

### 0.3 任务完成标准（DoD）

每个任务标记为「完成」前，必须满足：

- [ ] 功能代码已实现
- [ ] **单元测试已编写并通过**
- [ ] **覆盖率达到要求**（后端 ≥80%，前端 ≥70%）
- [ ] CI/CD 流水线绿灯
- [ ] 代码已通过 Review

### 0.4 TDD 详细实施计划

> 参见：[featuredoc/tdd_plan.md](./featuredoc/tdd_plan.md)

---

## 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)** | 21 | 必须实现 |
| **P1** | 22 | 首版后快速迭代（以 FeatureSummary 的 P1 清单为准） |
| **P2** | 8 | 中长期规划 |

---

### 1.4 功能编号 ↔ 任务编号映射表

| 功能编号 | 对应任务 |
| --- | --- |
| F-01 | TASK-008, TASK-009, TASK-012 |
| F-02 | TASK-010, TASK-012 |
| F-03 | TASK-011, TASK-012, TASK-037E |
| F-04 | TASK-011, TASK-012, TASK-037E |
| F-05 | TASK-037E |
| F-05-A | TASK-013 |
| F-05-B | TASK-045 |
| F-06 | TASK-046 |
| F-07 | TASK-027 |
| F-08 | TASK-020, TASK-028 |
| F-09 | TASK-020 |
| F-10 | TASK-003, TASK-014, TASK-015, TASK-027 |
| F-11 | TASK-016, TASK-017, TASK-022 |
| F-12 | TASK-013, TASK-018 |
| F-13 | TASK-016 |
| F-14 | TASK-019, TASK-028 |
| F-15 | TASK-047 |
| F-16 | TASK-048 |
| F-17 | TASK-004, TASK-023, TASK-024, TASK-027 |
| F-18 | TASK-063 |
| F-19 | TASK-032, TASK-033, TASK-037B |
| F-20 | TASK-034, TASK-037B |
| F-21 | TASK-037H, TASK-064 |
| F-22 | TASK-064 |
| F-23 | TASK-065 |
| F-24 | TASK-029, TASK-035 |
| F-25 | TASK-029, TASK-035 |
| F-26 | TASK-035, TASK-036 |
| F-27 | TASK-030, TASK-030-B |
| F-28 | TASK-054 |
| F-29 | TASK-055 |
| F-30 | TASK-014, TASK-056 |
| F-31 | TASK-057 |
| F-32 | TASK-058 |
| F-33 | TASK-037, TASK-037F |
| F-34 | TASK-037D |
| F-35 | TASK-037D, TASK-037G |
| F-36 | TASK-037D |
| F-37 | TASK-059 |
| F-38 | TASK-037I, TASK-050 |
| F-39 | TASK-050 |
| F-40 | TASK-037I, TASK-051 |
| F-41 | TASK-037G, TASK-060 |
| F-42 | TASK-061 |
| F-43 | TASK-049 |
| F-44 | TASK-068 |
| F-45 | TASK-018, TASK-019, TASK-021 |
| F-46 | TASK-062 |
| F-47 | TASK-005-D, TASK-005-E, TASK-005-F |
| F-48 | TASK-005-E |
| F-49 | TASK-066 |
| F-50 | TASK-067 |

> 注：F-05 已拆分为 F-05-A/B，历史任务中仍可能出现 F-05 标记。

---

## 2. Phase 1: 基础设施与 Brief 引擎 (Week 1-2)

### 2.1 基础设施搭建

#### TASK-001: 后端框架搭建
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | P1 |
| **预估工时** | 2d |
| **依赖** | - |
| **功能编号** | 基础设施 |

**任务描述：**
- 搭建 FastAPI 项目框架
- 配置项目结构（routes / services / models / utils）
- 配置环境变量管理 (.env)
- 配置日志系统
- 配置 CORS 跨域

**验收标准：**
- [ ] 项目可启动，访问 `/health` 返回 200
- [ ] 日志可正常输出到文件和控制台

---

#### TASK-002: 数据库设计与初始化
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | P1 |
| **预估工时** | 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 环境自动更新

---

#### TASK-005-D: AI 服务配置数据库设计
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | P0 |
| **预估工时** | 1d |
| **依赖** | TASK-002 |
| **功能编号** | 基础设施 |

**任务描述：**
- 设计 ai_configs 表结构（租户级 AI 配置）
- 字段：tenant_id, provider, base_url, api_key_encrypted, text_model, vision_model, audio_model, temperature, max_tokens
- 实现 AES-256-GCM API Key 加密存储
- 实现配置版本管理

**数据模型参考：** AIProviderConfig.md 第 3 章

**验收标准：**
- [ ] ai_configs 表创建成功
- [ ] API Key 加密存储正常
- [ ] 每个租户独立配置

---

#### TASK-005-E: AI 服务配置 API 接口
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | P0 |
| **预估工时** | 2d |
| **依赖** | TASK-005, TASK-005-D |
| **功能编号** | 基础设施 |

**任务描述：**
- 实现 GET /api/v1/ai-config（获取当前租户 AI 配置）
- 实现 PUT /api/v1/ai-config（更新 AI 配置）
- 实现 POST /api/v1/ai-config/models（获取可用模型列表）
- 实现 POST /api/v1/ai-config/test（测试三个模型连通性）
- 实现 AI 服务路由（根据租户配置自动选择提供商）

**API 规范参考：** AIProviderConfig.md 第 4 章

**验收标准：**
- [ ] 模型列表可动态获取
- [ ] 测试连接并行执行三个模型
- [ ] 仅品牌管理员可访问配置接口
- [ ] 代理商/达人请求自动继承品牌方配置
- [ ] 未配置时返回明确错误并引导品牌方完成配置

---

#### TASK-005-F: AI 服务配置前端页面
| 属性 | 内容 |
| --- | --- |
| **负责人** | Frontend |
| **优先级** | P0 |
| **预估工时** | 2d |
| **依赖** | TASK-006, TASK-005-E |
| **功能编号** | 基础设施 |

**任务描述：**
- 实现 AI 提供商下拉选择（OneAPI/Anthropic/OpenAI/DeepSeek/自定义）
- 实现三个模型下拉选择（动态获取模型列表）
- 实现 Base URL 和 API Key 输入（带显示/隐藏切换）
- 实现 Temperature 滑块和 Max Tokens 输入
- 实现测试连接按钮（弹窗显示三个模型测试结果）
- 实现保存配置功能

**界面参考：** UIDesign.md 第 10 章, User_Role_Interfaces.md 第 4.6 章

**验收标准：**
- [ ] 切换 AI 提供商自动填充默认 Base URL
- [ ] 模型列表动态获取
- [ ] 测试连接结果正确显示
- [ ] 配置保存成功后 Toast 提示

---

### 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 |

**任务描述：**
- 实现飞书文档分享链接解析
- 实现 Notion 分享链接解析
- 提取在线文档内容
- 触发 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 章

**验收标准：**
- [ ] 时长统计误差 ≤ 1秒
- [ ] 频次统计准确率 ≥ 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 要求的对比
- 输出时长/频次校验报告

**验收标准：**
- [ ] 时长统计误差 ≤ 1秒
- [ ] 频次统计准确率 ≥ 95%

---

#### TASK-022: 视频审核流水线编排
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | P0 |
| **预估工时** | 3d |
| **依赖** | TASK-016-021 |
| **功能编号** | F-11 |

**任务描述：**
- 实现 Celery 任务链编排
- 并行执行 ASR/OCR/CV
- 汇总多模态结果
- 生成审核报告
- 存储到数据库

**验收标准：**
- [ ] ≤ 100MB 视频审核 ≤ 5 分钟（含排队 ≤ 2 分钟）
- [ ] 审核报告包含所有检测结果

---

### 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 |

**任务描述：**
- 实现硬性合规区块
- 实现 Brief 完成度区块
- 实现舆情雷达区块
- 实现展开详情

**界面参考：** UIDesign.md 第 8.5 章

**验收标准：**
- [ ] 三个区块正常展示
- [ ] 详情可展开

---

#### TASK-034: 审核决策台 - 决策操作
| 属性 | 内容 |
| --- | --- |
| **负责人** | Frontend + Backend |
| **优先级** | P0 |
| **预估工时** | 2d |
| **依赖** | TASK-033 |
| **功能编号** | F-20 |

**任务描述：**
- 实现驳回按钮（自动打包问题）
- 实现通过按钮
- 实现审核状态流转 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-34, F-35, F-36 |

**任务描述：**
- 实现趋势图与问题分布饼图
- 实现代理商对比柱状图
- 实现风险预警区

**界面参考：** 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 并发无异常
- [ ] ≤ 100MB 视频审核 ≤ 5 分钟（含排队 ≤ 2 分钟）

---

#### 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-059: 达人排行榜（数据报表）
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend + Frontend |
| **优先级** | P1 |
| **功能编号** | F-37 |
| **依赖** | TASK-031, TASK-002 |

**任务描述：**
- 实现达人排行榜（通过率/响应速度/问题率）
- 支持按平台/时间范围筛选
- 标记问题达人并支持跳转详情

**验收标准：**
- [ ] 排行榜排序正确
- [ ] 筛选生效
- [ ] 问题达人标记清晰可用

---

### 6.5 代理商管理

#### TASK-068: 代理商管理
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend + Frontend |
| **优先级** | P1 |
| **功能编号** | F-44 |

**任务描述：**
- 实现代理商列表与绑定项目展示
- 支持配置可见 Brief 范围与仲裁权限
- 支持强制通过授权开关（**按代理商配置**，默认开启，可关闭）
- 绩效评分卡指标展示

**验收标准：**
- [ ] 代理商列表与详情可查看
- [ ] 权限配置可保存并生效

---

### 6.6 审核台与视频审核增强

#### TASK-063: 时间戳修改清单
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend + Frontend |
| **优先级** | P1 |
| **功能编号** | F-18 |
| **依赖** | TASK-022, TASK-028 |

**任务描述：**
- 生成带时间戳的修改清单（问题点 + 建议）
- 支持按时间点跳转并高亮
- 与审核报告联动展示

**验收标准：**
- [ ] 清单内容与审核报告一致
- [ ] 时间戳跳转准确

---

#### TASK-064: 强制通过与特例记录
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend + Frontend |
| **优先级** | P1 |
| **功能编号** | F-21, F-22 |
| **依赖** | TASK-034, TASK-037E |

**任务描述：**
- 实现强制通过逻辑（默认授权，支持品牌方**按代理商**关闭授权）
- 关闭授权后，代理商需提交审批
- 强制通过弹窗提供“保存为特例”勾选项（默认不勾选）
- 实现特例记录并写入白名单/豁免条款（品牌方确认后生效）

**验收标准：**
- [ ] 强制通过需填写原因并写入审计日志
- [ ] 授权开关生效（关闭后进入审批流程）
- [ ] 特例记录可落地并可追溯

---

#### TASK-065: 规则依据与证据查看
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend + Frontend |
| **优先级** | P1 |
| **功能编号** | F-23 |
| **依赖** | TASK-033, TASK-022 |

**任务描述：**
- 展示每条结论的规则依据与证据片段
- 支持截图/片段预览与跳转

**验收标准：**
- [ ] 规则依据可查看
- [ ] 证据片段可预览并定位

---

### 6.7 AI 配置增强

#### TASK-066: 多租户 AI 配置隔离
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | P0 |
| **功能编号** | F-49 |
| **依赖** | TASK-005-D, TASK-005-E |

**任务描述：**
- 不同品牌方租户配置完全隔离
- 配置读取严格按租户鉴权
- 支持审计与变更记录

**验收标准：**
- [ ] 跨租户访问被拒绝
- [ ] 租户配置读取正确

---

#### TASK-067: API Key 轮换管理
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend + Frontend |
| **优先级** | P1 |
| **功能编号** | F-50 |
| **依赖** | TASK-005-D, TASK-005-F |

**任务描述：**
- 支持轮换 API Key（不影响现有服务）
- 记录轮换时间与操作人
- 提供轮换后连通性验证

**验收标准：**
- [ ] 轮换后调用可用
- [ ] 轮换记录可追溯

---

---

## 7. P2 功能任务 (V2 规划)

> 以下任务在中长期规划中实现

| 任务编号 | 功能 | 功能编号 |
| --- | --- | --- |
| TASK-054 | 版本差异报告 | F-28 |
| TASK-055 | 双屏同步播放 | F-29 |
| TASK-056 | 批量上传（多文件拖拽） | F-30 |
| TASK-057 | 批量审核 | F-31 |
| TASK-058 | 批量导出 | F-32 |
| TASK-060 | 舆情风险视频监控 | F-41 |
| TASK-061 | 舆情案例库 | F-42 |
| TASK-062 | 负样本清洗与回流 | F-46 |

---

## 8. 任务依赖关系图

```mermaid
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]
        T005D[TASK-005-D AI配置数据库]
        T005E[TASK-005-E AI配置API]
        T005F[TASK-005-F AI配置前端]
        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
        T002 --> T005D
        T005 --> T005E
        T005D --> T005E
        T006 --> T005F
        T005E --> T005F
        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 |
| 时长统计误差 | ≤ 1秒 | TASK-021 |
| 频次统计准确率 | ≥ 95% | TASK-021 |
| 审核报告产出时间 | ≤ 5 分钟（含排队 ≤ 2 分钟） | 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. UI 开发任务 (关联设计稿)

> 所有 UI 开发任务必须严格对照设计稿 `pencil-new.pen` 实现，使用 Pencil MCP 工具访问设计稿节点

### 10.1 设计稿与组件库

| 资源 | 路径 | 说明 |
| --- | --- | --- |
| 设计稿文件 | `pencil-new.pen` | Pencil 格式设计稿 |
| 设计规范文档 | `UIDesignSpec.md` | 颜色、字体、间距、组件规范 |
| Tailwind 配置 | `frontend/tailwind.config.js` | 设计令牌 Tailwind 映射 |
| 全局样式 | `frontend/styles/globals.css` | CSS Variables 与组件样式 |
| 组件库 | `frontend/components/` | React 基础组件 |
| 常量定义 | `frontend/constants/` | 颜色、图标、布局常量 |

### 10.2 UI 开发检查清单

开发每个页面时，必须对照以下检查项：

- [ ] 背景色使用 `bg-bg-page` (#0B0B0E)
- [ ] 卡片使用 `bg-bg-card` (#16161A) + `rounded-card` (12px)
- [ ] 字体统一使用 DM Sans (`font-sans`)
- [ ] 图标使用 Lucide，按照 `constants/icons.ts` 映射表选择
- [ ] 移动端底部导航高度 83px，渐变背景
- [ ] 桌面端侧边栏宽度 260px
- [ ] 状态标签使用 `<Tag>` 组件（通过=绿色，处理中=紫色，错误=红色）
- [ ] 按钮使用 `<Button>` 组件（主要=紫色，次要=深灰色）
- [ ] 卡片使用 `<Card>` 组件
- [ ] 布局使用 `<MobileLayout>` 或 `<DesktopLayout>` 组件

### 10.3 达人端 UI 任务

#### TASK-UI-C01: 达人端 - 任务列表 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `PjBJD` |
| **优先级** | P0 |
| **依赖** | TASK-007, TASK-026 |
| **关联任务** | TASK-026 |

**实现要点：**
- 使用 `MobileLayout` 组件
- 任务卡片使用 `Card` 组件
- 状态标签使用 `Tag` 组件
- 底部导航：工作台/任务/审核/消息/我的

---

#### TASK-UI-C02: 达人端 - 智能上传 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `ZelCS` |
| **优先级** | P0 |
| **依赖** | TASK-015, TASK-027 |
| **关联任务** | TASK-027 |

**实现要点：**
- 脚本输入文本区域
- 视频上传区域（拖拽/点击）
- 上传进度条使用 `ProgressBar` 组件

---

#### TASK-UI-C03: 达人端 - 审核结果 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `Vn3VU` |
| **优先级** | P0 |
| **依赖** | TASK-028 |
| **关联任务** | TASK-028 |

**实现要点：**
- 结果横幅（通过/警告/驳回）
- 视频播放器带时间戳标注
- 修改清单组件

---

#### TASK-UI-C04: 达人端 - AI审核中 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `lzdm4` |
| **优先级** | P0 |
| **依赖** | TASK-024 |
| **关联任务** | TASK-024 |

**实现要点：**
- 使用 `CircularProgress` 环形进度组件
- 步骤列表展示当前处理阶段
- "离开并稍后查看"按钮

---

#### TASK-UI-C05: 达人端 - 消息中心 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `pF15t` |
| **优先级** | P1 |
| **依赖** | TASK-030 |
| **关联任务** | TASK-030 |

---

#### TASK-UI-C06: 达人端 - 历史记录 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `ZKEFl` |
| **优先级** | P2 |

---

#### TASK-UI-C07: 达人端 - 个人中心 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `zCdM1` |
| **优先级** | P2 |

---

#### TASK-UI-C08: 达人端 - 任务列表 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `HD3eK` |
| **优先级** | P0 |
| **依赖** | TASK-006 |

**实现要点：**
- 使用 `DesktopLayout` 组件
- 侧边栏导航使用 `Sidebar` 组件

---

#### TASK-UI-C09: 达人端 - 智能上传 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `N79bL` |
| **优先级** | P0 |

---

#### TASK-UI-C10: 达人端 - 审核结果 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `3niUa` |
| **优先级** | P0 |

---

#### TASK-UI-C11: 达人端 - AI审核中 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `bxAKT` |
| **优先级** | P0 |

---

#### TASK-UI-C12: 达人端 - 消息中心 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `8XKLP` |
| **优先级** | P1 |

---

### 10.4 代理商端 UI 任务

#### TASK-UI-A01: 代理商端 - 工作台 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `RX8V9` |
| **优先级** | P0 |
| **依赖** | TASK-031 |
| **关联任务** | TASK-031 |

**实现要点：**
- 使用 `DesktopLayout` 组件
- 待办事项卡片、项目进度条、最近活动列表

---

#### TASK-UI-A02: 代理商端 - 审核决策台 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `2u8Bq` |
| **优先级** | P0 |
| **依赖** | TASK-032, TASK-033, TASK-034 |
| **关联任务** | TASK-032, TASK-033, TASK-034 |

**实现要点：**
- 视频播放器带智能进度条（红/黄/绿点）
- AI 检查单区块
- 驳回/通过操作按钮

---

#### TASK-UI-A03: 代理商端 - Brief配置中心 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `djd2K` |
| **优先级** | P0 |
| **依赖** | TASK-012 |
| **关联任务** | TASK-012 |

---

#### TASK-UI-A04: 代理商端 - 达人管理 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `5cFMX` |
| **优先级** | P1 |

---

#### TASK-UI-A05: 代理商端 - 数据报表 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `An8gw` |
| **优先级** | P1 |
| **关联任务** | TASK-059 |

---

#### TASK-UI-A06: 代理商端 - 版本比对 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `NDmYh` |
| **优先级** | P2 |
| **关联任务** | TASK-054, TASK-055 |

---

#### TASK-UI-A07: 代理商端 - 工作台 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `VuH3F` |
| **优先级** | P0 |
| **依赖** | TASK-037A |
| **关联任务** | TASK-037A |

---

#### TASK-UI-A08: 代理商端 - 快捷审核 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `lrHaj` |
| **优先级** | P0 |
| **依赖** | TASK-037B |
| **关联任务** | TASK-037B |

---

#### TASK-UI-A09: 代理商端 - 任务列表 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `c6SPa` |
| **优先级** | P1 |
| **关联任务** | TASK-037C |

---

#### TASK-UI-A10: 代理商端 - 消息中心 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `9Us9g` |
| **优先级** | P1 |
| **关联任务** | TASK-037C |

---

#### TASK-UI-A11: 代理商端 - 个人中心 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `8OCZ3` |
| **优先级** | P2 |

---

### 10.5 品牌方端 UI 任务

#### TASK-UI-B01: 品牌方端 - 数据看板 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `xUM9m` |
| **优先级** | P0 |
| **依赖** | TASK-037D |
| **关联任务** | TASK-037D |

**实现要点：**
- 趋势图与问题分布饼图
- 代理商对比柱状图
- 风险预警区

---

#### TASK-UI-B02: 品牌方端 - AI服务配置 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `4ppiJ` |
| **优先级** | P0 |
| **依赖** | TASK-005-F |
| **关联任务** | TASK-005-F |

**实现要点：**
- AI 提供商下拉选择
- 模型配置（文本/视觉/音频）
- API Key 输入与测试连接

---

#### TASK-UI-B03: 品牌方端 - 规则配置 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `nhHSF` |
| **优先级** | P0 |
| **依赖** | TASK-037E |
| **关联任务** | TASK-037E |

---

#### TASK-UI-B04: 品牌方端 - 审计日志 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `jELTK` |
| **优先级** | P1 |
| **关联任务** | TASK-050 |

---

#### TASK-UI-B05: 品牌方端 - 代理商管理 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `2jnnO` |
| **优先级** | P1 |
| **关联任务** | TASK-068 |

---

#### TASK-UI-B06: 品牌方端 - 舆情预警 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `NjCe7` |
| **优先级** | P2 |
| **关联任务** | TASK-060 |

---

#### TASK-UI-B07: 品牌方端 - 系统设置 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `4nVj4` |
| **优先级** | P2 |

---

#### TASK-UI-B08: 品牌方端 - 数据看板 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `lpVdV` |
| **优先级** | P0 |
| **依赖** | TASK-037F |
| **关联任务** | TASK-037F |

---

#### TASK-UI-B09: 品牌方端 - 舆情预警 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `wWAel` |
| **优先级** | P1 |
| **关联任务** | TASK-037G |

---

#### TASK-UI-B10: 品牌方端 - 审批中心 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `OueOe` |
| **优先级** | P1 |
| **关联任务** | TASK-037H |

---

#### TASK-UI-B11: 品牌方端 - 消息中心 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `1w9xC` |
| **优先级** | P2 |

---

#### TASK-UI-B12: 品牌方端 - 我的 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `OJBbT` |
| **优先级** | P2 |

---

### 10.6 UI 任务优先级汇总

| 优先级 | 任务数量 | 任务列表 |
| --- | --- | --- |
| **P0** | 14 | TASK-UI-C01~C04, C08~C11, A01~A03, A07~A08, B01~B03, B08 |
| **P1** | 9 | TASK-UI-C05, C12, A04~A05, A09~A10, B04~B05, B09~B10 |
| **P2** | 8 | TASK-UI-C06~C07, A06, A11, B06~B07, B11~B12 |

---

## 11. 相关文档

| 文档 | 说明 |
| --- | --- |
| PRD.md | 产品需求文档 |
| FeatureSummary.md | 功能清单与优先级 |
| DevelopmentPlan.md | 开发计划与技术架构 |
| UIDesign.md | UI 设计规范 |
| UIDesignSpec.md | UI 设计规范（详细版） |
| User_Role_Interfaces.md | 用户角色与界面规范 |
| AIProviderConfig.md | AI 服务配置架构设计 |
| pencil-new.pen | 设计稿文件（Pencil 格式） |