Your Name d52509d630 docs: 完善 TDD 计划与项目名称统一
主要变更:
- 项目名称统一为"秒思智能审核平台"(替换 SmartAudit)
- 完善 TDD 实施评估与计划 (featuredoc/tdd_plan.md V2.0)
  - 新增项目现状诊断与可行性分析
  - 新增前后端测试策略与工具链配置模板
  - 新增 CI/CD 集成方案与 Codecov 配置说明
  - 标注所有待创建模板文件
- 新增 GitHub 配置脚本 (scripts/setup-github.sh)
  - 自动配置分支保护规则
  - 验证 GitHub CLI 登录状态
- 更新 TASK-005-C 包含分支保护与 Codecov 配置
- 同步更新 F-51/F-52 功能至所有相关文档
- UI 设计 Logo 统一为"秒思"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 11:08:59 +08:00

2709 lines
67 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# tasks.md - 秒思智能审核平台 开发任务清单
| 文档类型 | **Development Tasks (开发任务清单)** |
| --- | --- |
| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.7 |
| **发布日期** | 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 |
| V1.5 | 2026-02-03 | Claude | **新增 F-51/F-52 相关任务**TASK-069~073终审配置+审核流程进度) |
| V1.6 | 2026-02-03 | Claude | **F-52 扩展为全角色可见**TASK-073 新增代理商端/品牌方端进度条验收标准 |
| V1.7 | 2026-02-04 | Claude | **新增 GitHub 配置脚本**TASK-005-C 扩展为包含分支保护规则配置,新增 `scripts/setup-github.sh` |
---
## 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)** | 23 | 必须实现(含 F-51 品牌方终审开关、F-52 审核流程进度可视化) |
| **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-51 | TASK-069, TASK-070, TASK-071 |
| F-52 | TASK-072, TASK-073 |
> 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
- audit_logs 增加 prev_hash/hash 字段,支持 append-only + hash chain
- 配置 pgvector 扩展(向量检索)
- 配置 Alembic 数据库迁移
- 创建种子数据
**数据模型参考:** DevelopmentPlan.md 第 7 章
**验收标准:**
- [ ] 所有核心表创建成功
- [ ] pgvector 扩展可用
- [ ] 迁移脚本可正常执行
- [ ] audit_logs hash chain 字段可用
---
#### 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 流水线与 GitHub 配置
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | P0 |
| **预估工时** | 1.5d |
| **依赖** | TASK-001, TASK-006 |
| **功能编号** | 基础设施 |
**任务描述:**
- 配置 GitHub Actions 工作流
- `.github/workflows/frontend-test.yml` (Vitest + Playwright)
- `.github/workflows/backend-test.yml` (pytest)
- 实现代码提交后自动 Lint + 测试
- **配置 Codecov 覆盖率报告**(见下方步骤)
- 实现 Docker 镜像自动构建
- 配置 Dev 环境自动部署
- **运行 GitHub 配置脚本配置分支保护规则**
**执行命令:**
```bash
# 1. 配置 Codecov必须先完成否则 CI 会失败)
# - 访问 https://codecov.io 用 GitHub 登录
# - 添加仓库并获取 Upload Token
# - 配置 GitHub Secret:
gh secret set CODECOV_TOKEN --body "<your-codecov-token>"
# 2. 配置 GitHub 分支保护规则
./scripts/setup-github.sh
```
**验收标准:**
- [ ] 代码提交后自动触发构建和测试
- [ ] Lint/测试错误阻断 PR 合并
- [ ] **Codecov 覆盖率报告正常上传**验证https://codecov.io/gh/{owner}/{repo}
- [ ] **分支保护规则已生效**(验证:`gh api repos/{owner}/{repo}/branches/main/protection`
- [ ] 直接 push 到 main 被拒绝
- [ ] 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 章
**验收标准:**
- [ ] 日志列表正常展示
- [ ] 筛选功能正常
- [ ] 导出入口可用
---
#### TASK-069: 审核流程配置后端
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | **P0** |
| **预估工时** | 2d |
| **依赖** | TASK-002, TASK-034 |
| **功能编号** | F-51 |
**任务描述:**
- 实现审核流程配置表(终审开关、终审范围、超时时间、超时处理)
- 实现审核流程配置 CRUD API
- 修改审核通过逻辑:根据配置决定是否进入终审队列
- 实现终审超时自动处理(定时任务)
- 实现待终审列表查询 API
**数据模型:**
```sql
CREATE TABLE review_flow_configs (
id UUID PRIMARY KEY,
tenant_id UUID NOT NULL UNIQUE,
final_review_enabled BOOLEAN DEFAULT false,
final_review_scope VARCHAR(50) DEFAULT 'all', -- all/risk_only/specified_agencies
specified_agency_ids JSONB DEFAULT '[]',
timeout_hours INT DEFAULT 48,
timeout_action VARCHAR(20) DEFAULT 'auto_pass', -- auto_pass/remind_only
created_at TIMESTAMPTZ DEFAULT NOW(),
updated_at TIMESTAMPTZ DEFAULT NOW()
);
```
**验收标准:**
- [ ] 配置 CRUD API 正常
- [ ] 代理商通过后根据配置正确进入终审队列或直接通过
- [ ] 超时自动处理正常
---
#### TASK-070: 品牌方终审台 PC 端
| 属性 | 内容 |
| --- | --- |
| **负责人** | Frontend |
| **优先级** | **P0** |
| **预估工时** | 3d |
| **依赖** | TASK-032, TASK-069 |
| **功能编号** | F-51 |
**任务描述:**
- 实现终审台入口(仅当终审开启时显示)
- 实现待终审列表(筛选、搜索、超时提醒)
- 实现终审详情页(复用审核决策台布局)
- 显示代理商初审意见和通过理由
- 实现终审通过/驳回操作
- 实现审核流程配置界面
**界面参考:** User_Role_Interfaces.md 第 4.5 章
**验收标准:**
- [ ] 终审列表正常展示
- [ ] 超时提醒正常显示
- [ ] 终审操作正常
- [ ] 配置界面正常
---
#### TASK-071: 品牌方终审台移动端
| 属性 | 内容 |
| --- | --- |
| **负责人** | Frontend |
| **优先级** | P1 |
| **预估工时** | 2d |
| **依赖** | TASK-070, TASK-037F |
| **功能编号** | F-51 |
**任务描述:**
- 实现移动端待终审列表
- 实现移动端终审详情页(视频预览+问题列表)
- 实现终审通过/驳回操作
- 复杂配置引导至桌面端
**界面参考:** User_Role_Interfaces.md 第 4.5 章(移动端适配)
**验收标准:**
- [ ] 待终审列表正常展示
- [ ] 终审操作正常
- [ ] 视频预览正常
---
### 4.6.2 审核流程进度可视化 (F-52)
#### TASK-072: 审核流程进度后端 API
| 属性 | 内容 |
| --- | --- |
| **负责人** | Backend |
| **优先级** | **P0** |
| **预估工时** | 2d |
| **依赖** | TASK-002, TASK-022, TASK-069 |
| **功能编号** | F-52 |
**任务描述:**
- 扩展任务状态模型,增加审核流程阶段字段
- 实现审核流程状态查询 API`GET /api/v1/tasks/{task_id}/review-progress`
- 记录每个阶段的完成时间和处理人
- 支持 WebSocket 推送状态变更通知
**数据模型:**
```sql
-- 审核流程状态记录
ALTER TABLE tasks ADD COLUMN review_stage VARCHAR(50) DEFAULT 'submitted';
ALTER TABLE tasks ADD COLUMN review_stage_updated_at TIMESTAMP;
CREATE TABLE review_stage_logs (
id UUID PRIMARY KEY,
task_id UUID NOT NULL REFERENCES tasks(id),
stage VARCHAR(50) NOT NULL, -- submitted, ai_reviewing, ai_passed, ai_rejected, agency_reviewing, agency_passed, agency_rejected, brand_reviewing, brand_passed, brand_rejected, final_passed
operator_id UUID, -- 处理人AI阶段为空
operator_type VARCHAR(20), -- system, agency, brand
result VARCHAR(20), -- passed, rejected, pending
comment TEXT,
created_at TIMESTAMP DEFAULT NOW()
);
```
**API 响应示例:**
```json
{
"task_id": "xxx",
"current_stage": "agency_reviewing",
"stages": [
{"stage": "submitted", "status": "completed", "completed_at": "2026-02-03T10:30:00Z"},
{"stage": "ai_review", "status": "completed", "result": "passed", "completed_at": "2026-02-03T10:35:00Z"},
{"stage": "agency_review", "status": "in_progress", "started_at": "2026-02-03T10:35:00Z"},
{"stage": "brand_review", "status": "pending", "enabled": true},
{"stage": "final", "status": "pending"}
],
"estimated_wait_time": "2-4小时"
}
```
**验收标准:**
- [ ] API 返回完整审核流程状态
- [ ] 状态变更时触发 WebSocket 推送
- [ ] 历史记录可追溯
---
#### TASK-073: 审核流程进度前端 UI
| 属性 | 内容 |
| --- | --- |
| **负责人** | Frontend |
| **优先级** | **P0** |
| **预估工时** | 2d |
| **依赖** | TASK-026, TASK-027, TASK-028, TASK-072 |
| **功能编号** | F-52 |
**任务描述:**
- 实现审核流程进度条组件 `<ReviewProgressBar />`
- **全角色适配(达人/代理商/品牌方,移动端/桌面端)**
- 达人端:任务列表卡片 + 审核结果页顶部
- 代理商端:审核决策台顶部 + 移动端快捷审核页
- 品牌方端:终审台顶部 + 移动端审批中心审批项
- 根据终审配置动态显示/隐藏品牌终审节点
- 支持 WebSocket 实时更新状态
**组件设计:**
```tsx
// 进度条组件
<ReviewProgressBar
stages={stages} // 流程阶段数组
currentStage="agency_reviewing"
showBrandReview={true} // 是否显示品牌终审节点
onStageClick={handleStageClick} // 点击节点查看详情
compact={false} // 紧凑模式(移动端)
/>
// 状态标签组件
<ReviewStageTag
stage="agency_reviewing"
icon={<Users />}
color="purple"
label="等待代理商审核"
/>
```
**界面参考:** User_Role_Interfaces.md 第 2.1.1、2.3.1、3.3.1、3.8.2、4.5.2、4.7.3 章
**验收标准:**
- [ ] 达人端任务卡片正确显示当前审核阶段
- [ ] 达人端审核结果页进度条正确显示
- [ ] 代理商端审核决策台/快捷审核页进度条正确显示
- [ ] 品牌方端终审台/审批中心进度条正确显示
- [ ] 终审开启/关闭时进度条节点正确增减
- [ ] WebSocket 状态更新实时反映
---
### 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+500Logo 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 |
**任务描述:**
- 实现审核记录查询
- 实现完整审核链路查看
- 审计日志采用 append-only + hash chain前序哈希 + 当前内容),禁止更新/删除
**验收标准:**
- [ ] 审计日志链式校验通过
- [ ] 不支持对历史审计日志的更新/删除
---
#### 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 任务与第 4 章功能任务的关系**
>
> - **功能任务TASK-026~037等**:定义"实现什么功能"和"如何验收"
> - **UI任务TASK-UI-xxx**:提供"视觉参考"关联设计稿节点ID
> - **开发流程**功能任务和UI任务应**同时参考**先看UI任务获取视觉规范再按功能任务完成开发
> - **任务编号映射**每个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-073 |
| **关联任务** | TASK-026, TASK-073 |
**实现要点:**
- 使用 `MobileLayout` 组件
- 任务卡片使用 `Card` 组件
- 状态标签使用 `Tag` 组件
- 底部导航:工作台/任务/审核/消息/我的
-**审核流程进度条**F-52
- 任务卡片内嵌审核进度条组件 `<ReviewProgressBar />`
- 进度条节点ID`V5Vrv`AI审核中状态示例`r3pZG`(需修改状态示例)
- 状态流转:已提交 → AI审核 → 代理商审核 → [品牌终审] → 通过
---
#### TASK-UI-C02: 达人端 - 智能上传 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `ZelCS` |
| **优先级** | P0 |
| **依赖** | TASK-015, TASK-027 |
| **关联任务** | TASK-027 |
**实现要点:**
- 脚本输入文本区域
- 视频上传区域(拖拽/点击)
- 上传进度条使用 `ProgressBar` 组件
---
#### TASK-UI-C03: 达人端 - 审核结果 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `Vn3VU` |
| **优先级** | P0 |
| **依赖** | TASK-028, TASK-073 |
| **关联任务** | TASK-028, TASK-073 |
**实现要点:**
-**审核流程进度卡片**F-52
- 进度卡片节点ID`GNZKG`
- 显示完整流程:已提交 → AI审核 → 代理商审核 → 最终结果
- 每个节点显示时间戳和状态
- 结果横幅(通过/警告/驳回)
- 视频播放器带时间戳标注
- 修改清单组件
---
#### 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 |
| **关联任务** | TASK-026复用移动端逻辑适配桌面布局 |
**实现要点:**
- 使用 `DesktopLayout` 组件
- 侧边栏导航使用 `Sidebar` 组件
---
#### TASK-UI-C09: 达人端 - 智能上传 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `N79bL` |
| **优先级** | P0 |
| **关联任务** | TASK-027复用移动端逻辑适配桌面布局 |
---
#### TASK-UI-C10: 达人端 - 审核结果 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `3niUa` |
| **优先级** | P0 |
| **关联任务** | TASK-028复用移动端逻辑适配桌面布局 |
---
#### TASK-UI-C11: 达人端 - AI审核中 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `bxAKT` |
| **优先级** | P0 |
| **关联任务** | TASK-024复用移动端逻辑适配桌面布局 |
---
#### TASK-UI-C12: 达人端 - 消息中心 (Desktop)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `8XKLP` |
| **优先级** | P1 |
| **关联任务** | TASK-030复用移动端逻辑适配桌面布局 |
---
### 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实现达人列表CRUD |
---
#### 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-030复用消息中心逻辑 |
---
#### TASK-UI-B12: 品牌方端 - 我的 (Mobile)
| 属性 | 内容 |
| --- | --- |
| **设计稿节点ID** | `OJBbT` |
| **优先级** | P2 |
| **关联任务** | 无独立功能任务,展示用户信息与桌面端操作提示 |
---
### 10.6 UI 任务优先级汇总
| 优先级 | 任务数量 | 任务列表 |
| --- | --- | --- |
| **P0** | 17 | TASK-UI-C01~C04 (4), C08~C11 (4), A01~A03 (3), A07~A08 (2), B01~B03 (3), B08 (1) |
| **P1** | 10 | TASK-UI-C05 (1), C12 (1), A04~A05 (2), A09~A10 (2), B04~B05 (2), B09~B10 (2) |
| **P2** | 8 | TASK-UI-C06~C07 (2), A06 (1), A11 (1), B06~B07 (2), B11~B12 (2) |
| **总计** | **35** | 达人端12个 + 代理商端11个 + 品牌方端12个 |
---
## 11. 相关文档
| 文档 | 说明 |
| --- | --- |
| PRD.md | 产品需求文档 |
| FeatureSummary.md | 功能清单与优先级 |
| DevelopmentPlan.md | 开发计划与技术架构 |
| UIDesign.md | UI 设计规范 |
| UIDesignSpec.md | UI 设计规范(详细版) |
| User_Role_Interfaces.md | 用户角色与界面规范 |
| AIProviderConfig.md | AI 服务配置架构设计 |
| pencil-new.pen | 设计稿文件Pencil 格式) |