Your Name 2f2f7e0f61 docs: 完善文档体系与一致性修复

- 新增 AI 厂商动态配置架构文档 (AIProviderConfig V2.0)
- 新增 TDD 实施计划 (featuredoc/tdd_plan.md)
- 新增文档矛盾追踪记录 (DocumentContradictions.md)
- 统一所有文档的技术指标与优先级定义
- 完善功能清单 (F-47~F-50 AI 配置功能)
- 更新任务清单支持 AI 服务配置任务

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-03 15:49:57 +08:00

48 KiB

Raw Blame History

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 核心原则

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

🔴 RED - 先写一个失败的测试
🟢 GREEN - 写最少的代码让测试通过
🔄 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

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. 任务依赖关系图

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. 相关文档

文档	说明
PRD.md	产品需求文档
FeatureSummary.md	功能清单与优先级
DevelopmentPlan.md	开发计划与技术架构
UIDesign.md	UI 设计规范
User_Role_Interfaces.md	用户角色与界面规范
AIProviderConfig.md	AI 服务配置架构设计

48 KiB Raw Blame History Unescape Escape

tasks.md - SmartAudit 开发任务清单

版本历史 (Version History)

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

0.1 TDD 核心原则

0.2 每个任务的 TDD 要求

0.3 任务完成标准（DoD）

0.4 TDD 详细实施计划

1. 任务总览

1.1 开发阶段划分

1.2 团队配置

1.3 功能优先级统计

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

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

2.1 基础设施搭建

TASK-001: 后端框架搭建

TASK-002: 数据库设计与初始化

TASK-003: 对象存储接入

TASK-004: Redis 缓存与队列配置

TASK-005: 认证与权限系统

TASK-005-B: API Mock 与文档定义

TASK-005-C: CI/CD 流水线配置

TASK-005-D: AI 服务配置数据库设计

TASK-005-E: AI 服务配置 API 接口

TASK-005-F: AI 服务配置前端页面

2.2 前端框架搭建

TASK-006: PC 端框架搭建

TASK-007: H5 端框架搭建

2.3 Brief 解析模块

TASK-008: Brief 文档上传接口

TASK-009: Brief 解析 AI 服务

TASK-010: 在线文档链接导入

TASK-011: 平台规则库管理

TASK-012: Brief 配置中心 UI

TASK-013: 竞品 Logo 向量库搭建

3. Phase 2: 核心 AI 流水线 (Week 3-6)

3.1 视频上传模块

TASK-014: Tus 断点续传服务

TASK-015: 视频上传前端组件

3.2 多模态 AI 流水线

TASK-016: ASR 语音识别服务

TASK-017: OCR 字幕识别服务

TASK-018: CV 画面检测服务

TASK-019: 多模态时间戳对齐算法

TASK-020: 语义分析与语境理解

TASK-021: 时长与频次校验

TASK-022: 视频审核流水线编排

3.3 实时进度推送

TASK-023: WebSocket 进度推送服务

TASK-024: 透明思考 UI 组件

3.4 弹性 GPU 集群

TASK-025: 弹性 GPU 服务接入

4. Phase 3: 达人端 H5 与审核台 (Week 7-9)

4.1 达人端 H5 页面

TASK-026: 达人端任务列表页

TASK-027: 达人端智能上传页

TASK-028: 达人端审核结果页

TASK-029: 达人端申诉弹窗

TASK-030: 达人端消息中心

TASK-030-B: 消息中心后端接口

4.2 代理商端 PC 页面

TASK-031: 代理商端工作台

TASK-032: 审核决策台 - 视频播放器

TASK-033: 审核决策台 - AI 检查单

TASK-034: 审核决策台 - 决策操作

4.3 申诉与仲裁

TASK-035: 申诉后端接口

TASK-036: 代理商端申诉仲裁页

4.4 数据看板

TASK-037: 核心指标卡片

4.5 代理商端移动端页面

TASK-037A: 代理商移动端工作台

TASK-037B: 代理商移动端快捷审核

TASK-037C: 代理商移动端任务列表与消息

4.6 品牌方端页面

TASK-037D: 品牌方 PC 端数据看板

TASK-037E: 品牌方 PC 端规则配置

TASK-037F: 品牌方移动端数据看板

TASK-037G: 品牌方移动端舆情预警

TASK-037H: 品牌方移动端审批中心

48 KiB

Raw Blame History