liyanyu/video-compliance-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 完善 TDD 计划与项目名称统一

Browse Source 
主要变更：
- 项目名称统一为"秒思智能审核平台"（替换 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>
This commit is contained in:
Your Name 2026-02-04 11:08:59 +08:00
parent 6ca52c87d1
commit d52509d630
17 changed files with 6118 additions and 291 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
AIProviderConfig.md
View File

@ -2,9 +2,9 @@
| 文档类型 | **Technical Design (技术设计文档)** | | 文档类型 | **Technical Design (技术设计文档)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V2.0 | | **版本号** | V2.1 |
| **日期** | 2026-02-02 | | **日期** | 2026-02-03 |
| **侧重** | AI 服务动态配置、多租户隔离、模型选择 | | **侧重** | AI 服务动态配置、多租户隔离、模型选择 |
--- ---
@ -15,6 +15,7 @@
| --- | --- | --- | --- | | --- | --- | --- | --- |
| V1.0 | 2026-02-02 | Claude | 初稿：AI 厂商动态配置架构设计 | | V1.0 | 2026-02-02 | Claude | 初稿：AI 厂商动态配置架构设计 |
| V2.0 | 2026-02-02 | Claude | 重构：简化为统一提供商+三模型配置方案 | | V2.0 | 2026-02-02 | Claude | 重构：简化为统一提供商+三模型配置方案 |
| V2.1 | 2026-02-03 | Claude | 文档一致性修订：明确单提供商模式与可切换原则 |
--- ---
@ -22,7 +23,7 @@
### 1.1 业务需求 ### 1.1 业务需求
SmartAudit 系统需要调用三类 AI 服务完成视频审核： 秒思智能审核平台 系统需要调用三类 AI 服务完成视频审核：
| 服务类型 | 用途 | 示例模型 | | 服务类型 | 用途 | 示例模型 |
| --- | --- | --- | | --- | --- | --- |
@ -35,6 +36,7 @@ SmartAudit 系统需要调用三类 AI 服务完成视频审核：
| 目标 | 描述 | | 目标 | 描述 |
| --- | --- | | --- | --- |
| **灵活配置** | 品牌方可在后台自由选择 AI 提供商和模型 | | **灵活配置** | 品牌方可在后台自由选择 AI 提供商和模型 |
| **单一提供商** | 每租户仅保留一套提供商配置，必要时手动切换 |
| **统一接入** | 支持 OneAPI/OpenRouter 中转，一套配置调用多种模型 | | **统一接入** | 支持 OneAPI/OpenRouter 中转，一套配置调用多种模型 |
| **直连支持** | 也支持直连 Anthropic、OpenAI、DeepSeek 等厂商 | | **直连支持** | 也支持直连 Anthropic、OpenAI、DeepSeek 等厂商 |
| **多租户隔离** | 不同品牌方使用独立的 AI 配置和配额 | | **多租户隔离** | 不同品牌方使用独立的 AI 配置和配额 |
@ -693,7 +695,7 @@ def mask_api_key(api_key: str) -> str:
## 7. 界面设计 ## 7. 界面设计
> 详见 UIDesign.md 第 10 章「AI 服务配置界面」 > 详见 User_Role_Interfaces.md 第 4.6 章「AI 服务配置」
### 7.1 界面入口 ### 7.1 界面入口

29
DevelopmentPlan.md
View File

@ -1,4 +1,4 @@
这是一个基于 `RequirementsDoc.md`、`FeatureSummary.md` (V1.3) 和 `User_Role_Interfaces.md` 编写的开发计划文档。 这是一个基于 `RequirementsDoc.md`、`FeatureSummary.md` (V1.4) 和 `User_Role_Interfaces.md` 编写的开发计划文档。
这份文档旨在指导技术团队进行架构设计、选型和排期，重点在于解决**视频处理的高并发/高延迟**、**多模态 AI 的集成**以及**移动端适配**等工程难点。 这份文档旨在指导技术团队进行架构设计、选型和排期，重点在于解决**视频处理的高并发/高延迟**、**多模态 AI 的集成**以及**移动端适配**等工程难点。
@ -10,10 +10,10 @@
| 文档类型 | **Development Plan (技术架构与实施计划)** | | 文档类型 | **Development Plan (技术架构与实施计划)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.5 | | **版本号** | V1.6 |
| **日期** | 2026-02-03 | | **日期** | 2026-02-03 |
| **依据** | FeatureSummary V1.3, PRD V1.0, RequirementsDoc V1.0 | | **依据** | FeatureSummary V1.4, PRD V1.0, RequirementsDoc V1.0 |
| **侧重** | 技术选型、架构设计、MVP 范围、开发排期、验收标准 | | **侧重** | 技术选型、架构设计、MVP 范围、开发排期、验收标准 |
--- ---
@ -29,6 +29,7 @@
| V1.3 | 2026-02-03 | Claude | **确立 TDD 为项目核心开发规范**，关联 tdd_plan.md | | V1.3 | 2026-02-03 | Claude | **确立 TDD 为项目核心开发规范**，关联 tdd_plan.md |
| V1.4 | 2026-02-03 | Claude | **新增 AI 厂商动态配置架构**，支持数据库配置、运行时热更新、多租户隔离 | | V1.4 | 2026-02-03 | Claude | **新增 AI 厂商动态配置架构**，支持数据库配置、运行时热更新、多租户隔离 |
| V1.5 | 2026-02-03 | Claude | 文档一致性修复：统一加密方案、采样精度、处理时间、选型决策、P0 范围、排期等 | | V1.5 | 2026-02-03 | Claude | 文档一致性修复：统一加密方案、采样精度、处理时间、选型决策、P0 范围、排期等 |
| V1.6 | 2026-02-03 | Claude | 文档一致性修订：AI 配置单提供商模式、审计日志不可篡改方案、FeatureSummary 版本对齐 |
--- ---
@ -108,7 +109,7 @@ graph TD
| --- | --- | --- | | --- | --- | --- |
| **通用语义 (NLP)** | **豆包 Pro / Qwen-Max / DeepSeek** | 处理 Brief 解析、反讽识别、情感分析 | | **通用语义 (NLP)** | **豆包 Pro / Qwen-Max / DeepSeek** | 处理 Brief 解析、反讽识别、情感分析 |
| **视觉理解 (VLM)** | **Qwen-VL / 豆包视觉** | 处理复杂场景理解（如：环境脏乱差、具体动作判定）；**Brief 图片解析** | | **视觉理解 (VLM)** | **Qwen-VL / 豆包视觉** | 处理复杂场景理解（如：环境脏乱差、具体动作判定）；**Brief 图片解析** |
| **语音识别 (ASR)** | **Paraformer (阿里) / SenseVoice** | 高精度中文语音转写，支持时间戳对齐 | | **语音识别 (ASR)** | **Whisper / Paraformer / SenseVoice** | 通过 AIProviderConfig 配置音频模型，支持时间戳对齐 |
| **文字识别 (OCR)** | **PaddleOCR v4** | 针对中文视频字幕优化，开源免费，轻量级 | | **文字识别 (OCR)** | **PaddleOCR v4** | 针对中文视频字幕优化，开源免费，轻量级 |
| **版面分析 (Layout)** | **PaddleOCR Layout / LayoutLMv3** | Brief PDF 版面分析，提取图文混排结构 | | **版面分析 (Layout)** | **PaddleOCR Layout / LayoutLMv3** | Brief PDF 版面分析，提取图文混排结构 |
| **竞品 Logo 检测** | **Grounding DINO + Vector DB** | ⭐ V1.2 修正：改为向量检索方案，见下方说明 | | **竞品 Logo 检测** | **Grounding DINO + Vector DB** | ⭐ V1.2 修正：改为向量检索方案，见下方说明 |
@ -119,11 +120,11 @@ graph TD
> >
> **核心特性：** > **核心特性：**
> - **数据库存储配置：** AI 厂商的 API Key、Base URL 等配置存储在数据库中，而非环境变量 > - **数据库存储配置：** AI 厂商的 API Key、Base URL 等配置存储在数据库中，而非环境变量
> - **运行时动态加载：** 管理员可在后台配置 AI 厂商，系统运行时动态读取配置初始化客户端 > - **运行时动态加载：** 管理员可在后台配置**单一 AI 提供商**，系统运行时动态读取配置初始化客户端
> - **多租户隔离：** 不同品牌方可配置独立的 AI 厂商和配额 > - **多租户隔离：** 不同品牌方可配置独立的 AI 提供商配置和配额
> - **热更新：** 配置变更即时生效，无需重启服务 > - **热更新：** 配置变更即时生效，无需重启服务
> - **故障转移：** 主厂商不可用时自动切换到备用厂商
> - **API Key 加密：** 使用 AES-256-GCM 加密存储敏感信息 > - **API Key 加密：** 使用 AES-256-GCM 加密存储敏感信息
> - **可切换：** 管理员可随时更换提供商（OneAPI/OpenRouter 或直连厂商）
> >
> **支持的厂商类型：** > **支持的厂商类型：**
> - 国内厂商：DeepSeek、通义千问、豆包、智谱、Moonshot > - 国内厂商：DeepSeek、通义千问、豆包、智谱、Moonshot
@ -252,11 +253,11 @@ sequenceDiagram
## 3. MVP (P0) 开发范围定义 ## 3. MVP (P0) 开发范围定义
基于 `FeatureSummary.md V1.3`，MVP 阶段必须包含的功能： 基于 `FeatureSummary.md V1.4`，MVP 阶段必须包含的功能：
### ✅ MVP 包含 (Must Have) - 共 21 个 P0 功能 ### ✅ MVP 包含 (Must Have) - 共 21 个 P0 功能
基于 `FeatureSummary.md V1.3` 第 4.1 章定义： 基于 `FeatureSummary.md V1.4` 第 4.1 章定义：
| 模块 | 功能编号 | 功能名称 | 备注 | | 模块 | 功能编号 | 功能名称 | 备注 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
@ -406,13 +407,15 @@ sequenceDiagram
| `reports` | 审核报告 | id, video_id, ai_result_json, human_decision, created_at | | `reports` | 审核报告 | id, video_id, ai_result_json, human_decision, created_at |
| `risk_items` | 风险项 | id, report_id, type, level, timestamp_start, timestamp_end, evidence_json | | `risk_items` | 风险项 | id, report_id, type, level, timestamp_start, timestamp_end, evidence_json |
| `rule_sets` | 规则库 | id, brand_id, platform, version, rules_json | | `rule_sets` | 规则库 | id, brand_id, platform, version, rules_json |
| `audit_logs` | 审计日志 | id, task_id, operator_id, action, detail_json, created_at | | `audit_logs` | 审计日志 | id, task_id, operator_id, action, detail_json, created_at, prev_hash, hash |
> **审计日志不可篡改策略：** `audit_logs` 采用 append-only 写入 + hash chain（前序哈希 + 当前内容），禁止更新/删除，支持链式校验。
--- ---
## 8. 验收标准 (Acceptance Criteria) ## 8. 验收标准 (Acceptance Criteria)
引用自 `FeatureSummary.md V1.3` 第 9 章，MVP 上线前必须满足： 引用自 `FeatureSummary.md V1.4` 第 9 章，MVP 上线前必须满足：
| 验收项 | 标准 | 测量方式 | 责任方 | | 验收项 | 标准 | 测量方式 | 责任方 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
@ -518,6 +521,6 @@ sequenceDiagram
| User_Role_Interfaces.md | 界面规范 | | User_Role_Interfaces.md | 界面规范 |
| tasks.md | 开发任务清单 | | tasks.md | 开发任务清单 |
| **featuredoc/tdd_plan.md** | **TDD 实施计划（核心规范）** | | **featuredoc/tdd_plan.md** | **TDD 实施计划（核心规范）** |
| **AIProviderConfig.md** | **AI 厂商动态配置架构设计（V2.0）** | | **AIProviderConfig.md** | **AI 厂商动态配置架构设计（V2.1）** |
| 数据字典 | 待编写 | | 数据字典 | 待编写 |
| API 接口规范 | 待编写 | | API 接口规范 | 待编写 |

139
DocumentContradictions.md
View File

@ -1,6 +1,9 @@
# 设计文档矛盾与模糊点分析 (V1.2) # 设计文档矛盾与模糊点分析 (V1.7)
本文档用于记录并跟踪 `SmartAudit` 项目各设计文档之间的矛盾点与模糊点。以下条目均已对齐并给出统一结论。 本文档用于记录并跟踪 `秒思智能审核平台` 项目各设计文档之间的矛盾点与模糊点。
**最后检查时间：** 2026-02-03
**检查版本：** PRD V1.0, RequirementsDoc V1.0, FeatureSummary V1.6, DevelopmentPlan V1.6, tasks.md V1.6, UIDesignSpec V1.0, UIDesign V1.1, User_Role_Interfaces V1.5, AIProviderConfig V2.1, tdd_plan V1.0
--- ---
@ -11,28 +14,32 @@
- **对齐文档：** `DevelopmentPlan.md`、`User_Role_Interfaces.md` - **对齐文档：** `DevelopmentPlan.md`、`User_Role_Interfaces.md`
### 1.2 Logo 检测职责边界 (已澄清) ### 1.2 Logo 检测职责边界 (已澄清)
- **结论：** 视觉模型仅用于画面语义/场景风险分析；竞品 Logo 检测由内置 CV 模型处理，不受配置影响。 - **结论：** 视觉模型仅用于画面语义/场景风险分析；竞品 Logo 检测由内置 CV 模型（Grounding DINO + Vector DB）处理，不受配置影响。
- **对齐文档：** `AIProviderConfig.md`、`UIDesign.md`、`User_Role_Interfaces.md` - **对齐文档：** `AIProviderConfig.md`、`UIDesign.md`、`User_Role_Interfaces.md`、`DevelopmentPlan.md`
### 1.3 文件上传方案 (已同步) ### 1.3 文件上传方案 (已同步)
- **结论：** 批量上传采用 **多文件拖拽并发上传 + Tus 断点续传**，弃用 ZIP。 - **结论：** 批量上传采用 **多文件拖拽并发上传 + Tus 断点续传**，弃用 ZIP。
- **对齐文档：** `PRD.md`、`RequirementsDoc.md`、`FeatureSummary.md`、`DevelopmentPlan.md` - **对齐文档：** `PRD.md`、`RequirementsDoc.md`、`FeatureSummary.md`、`DevelopmentPlan.md`
### 1.4 AI 厂商配置范围 (已统一)
- **结论：** 每租户仅配置**单一 AI 提供商**（OneAPI/OpenRouter 中转或直连厂商），不做自动故障转移；需要切换由管理员手动更新配置。
- **对齐文档：** `AIProviderConfig.md`、`PRD.md`、`RequirementsDoc.md`、`FeatureSummary.md`、`DevelopmentPlan.md`
--- ---
## 2. 权限与工作流 ## 2. 权限与工作流
### 2.1 强制通过与特例关系 (已统一) ### 2.1 强制通过与特例关系 (已统一)
- **结论：** “强制通过”弹窗内提供 **保存为特例** 勾选项（默认不勾选）；勾选后生成豁免条款并等待品牌方确认生效。 - **结论：** "强制通过"弹窗内提供 **保存为特例** 勾选项（默认不勾选）；勾选后生成豁免条款并等待品牌方确认生效。
- **对齐文档：** `PRD.md`、`UIDesign.md`、`User_Role_Interfaces.md` - **对齐文档：** `PRD.md`、`UIDesign.md`、`User_Role_Interfaces.md`
### 2.2 强制通过禁用后的流程 (已统一) ### 2.2 强制通过禁用后的流程 (已统一)
- **结论：** 品牌方关闭授权后，代理商端按钮文案变为“申请强制通过”，填写理由并提交品牌方审批。 - **结论：** 品牌方关闭授权后，代理商端按钮文案变为"申请强制通过"，填写理由并提交品牌方审批。
- **对齐文档：** `PRD.md`、`UIDesign.md`、`User_Role_Interfaces.md` - **对齐文档：** `PRD.md`、`UIDesign.md`、`User_Role_Interfaces.md`
### 2.3 AI 配置可见性 (已统一) ### 2.3 AI 配置可见性 (已统一)
- **结论：** 代理商/达人 **不可见** AI 配置，仅品牌方管理员可查看与修改。 - **结论：** 代理商/达人 **不可见** AI 配置，仅品牌方管理员可查看与修改。
- **对齐文档：** `UIDesign.md`、`User_Role_Interfaces.md` - **对齐文档：** `UIDesign.md`、`User_Role_Interfaces.md`、`AIProviderConfig.md`
--- ---
@ -50,14 +57,124 @@
## 4. 文档一致性 ## 4. 文档一致性
### 4.1 TDD 计划文档缺失 (已补齐) ### 4.1 TDD 计划文档 (已补齐)
- **结论：** 新增 `featuredoc/tdd_plan.md`，作为 `tasks.md` 中 TDD 引用的正式文档。 - **结论：** 新增 `featuredoc/tdd_plan.md`，作为 `tasks.md` 中 TDD 引用的正式文档。
- **对齐文档：** `tasks.md` - **对齐文档：** `tasks.md`、`DevelopmentPlan.md`
### 4.2 视频采样率假设 (已同步) ### 4.2 视频采样率假设 (已同步)
- **结论：** CV 采样率默认 **2fps**，并在该采样率下验证时长统计准确性。 - **结论：** CV 采样率默认 **2fps**，并在该采样率下验证时长统计准确性。
- **对齐文档：** `PRD.md`、`FeatureSummary.md` - **对齐文档：** `PRD.md`、`FeatureSummary.md`、`DevelopmentPlan.md`
### 4.3 UI 设计风格 (已统一)
- **问题：** 存在两份 UI 设计文档，风格不一致：
- `UIDesign.md`: Apple Human Interface Guidelines **浅色系** (#FFFFFF 为主背景)
- `UIDesignSpec.md`: Apple-style **暗色主题** (#0B0B0E 为页面背景)
- **结论：** 以 `UIDesignSpec.md` 和设计稿 `pencil-new.pen` 为准，采用 **暗色主题**。
- **已处理：** 在 `UIDesign.md` 头部添加废弃声明，指向 `UIDesignSpec.md` 为正式规范。
- **对齐文档：** `UIDesign.md`、`UIDesignSpec.md`
- **备注：** `tasks.md` 中的 UIDesign.md 引用保持不变，因 UIDesign.md 中的设计原则和交互说明仍有参考价值；具体颜色/组件规范以 UIDesignSpec.md 为准。
### 4.4 审计日志不可篡改实现 (已明确)
- **结论：** 采用 append-only + hash chain（前序哈希 + 当前内容）保证审计日志可追溯与不可篡改。
- **对齐文档：** `PRD.md`、`RequirementsDoc.md`、`FeatureSummary.md`、`DevelopmentPlan.md`、`tasks.md`
--- ---
**当前状态：** 无待决策项。 ## 5. 数值与指标一致性 (已验证)
### 5.1 功能优先级数量
| 优先级 | PRD | FeatureSummary | DevelopmentPlan | tasks.md | 状态 |
| --- | --- | --- | --- | --- | --- |
| P0 (MVP) | 12项 (场景级) | 23 | 21 | 23 | ✅ 一致（新增 F-51, F-52） |
| P1 | 4项 (场景级) | 22 | - | 22 | ✅ 一致 |
| P2 | 2项 (场景级) | 8 | - | 8 | ✅ 一致 |
### 5.2 技术指标
| 指标 | PRD | FeatureSummary | DevelopmentPlan | 状态 |
| --- | --- | --- | --- | --- |
| 审核报告产出时间 | ≤ 5 分钟（含排队 ≤ 2 分钟） | ≤ 5 分钟（含排队 ≤ 2 分钟） | ≤ 5 分钟（含排队 ≤ 2 分钟） | ✅ 一致 |
| 竞品 Logo F1 | ≥ 0.85 | ≥ 0.85 | ≥ 0.85 | ✅ 一致 |
| ASR 字错率 | ≤ 10% | ≤ 10% | ≤ 10% | ✅ 一致 |
| OCR 准确率 | ≥ 95% | ≥ 95% | ≥ 95% | ✅ 一致 |
| 语境理解误报率 | ≤ 5% | ≤ 5% | ≤ 5% | ✅ 一致 |
| 时长统计误差 | ≤ 1秒 | ≤ 1秒 | ≤ 1秒 | ✅ 一致 |
| 频次统计准确率 | ≥ 95% | ≥ 95% | ≥ 95% | ✅ 一致 |
| 加密方案 | AES-256-GCM | AES-256-GCM | AES-256-GCM | ✅ 一致 |
| CV 采样率 | 2fps | 2fps | 2fps | ✅ 一致 |
### 5.3 开发周期
| 项目 | DevelopmentPlan | tasks.md | 状态 |
| --- | --- | --- | --- |
| 总周期 | 11 周 | 11 周 | ✅ 一致 |
| Phase 1 | Week 1-2 | Week 1-2 | ✅ 一致 |
| Phase 2 | Week 3-6 (4周) | Week 3-6 (4周) | ✅ 一致 |
| Phase 3 | Week 7-9 | Week 7-9 | ✅ 一致 |
| Phase 4 | Week 10-11 | Week 10-11 | ✅ 一致 |
### 5.4 测试覆盖率要求
| 类型 | DevelopmentPlan | tdd_plan.md | tasks.md | 状态 |
| --- | --- | --- | --- | --- |
| 后端覆盖率 | ≥ 80% | ≥ 80% | ≥ 80% | ✅ 一致 |
| 前端覆盖率 | ≥ 70% | ≥ 70% | ≥ 70% | ✅ 一致 |
---
## 6. 合理性评估 (已验证)
### 6.1 技术方案合理性
- ✅ **前后端分离 + AI 微服务化**：适合视频处理的高算力需求
- ✅ **FastAPI + Celery + Redis**：Python 生态成熟，适合 AI 集成
- ✅ **PostgreSQL + pgvector**：减少架构复杂度，统一向量检索
- ✅ **Tus 协议**：解决大文件上传不稳定问题
- ✅ **弹性 GPU 集群**：支持自动扩缩容，控制成本
### 6.2 时间估算合理性
- ✅ **Phase 2 延长至 4 周**：预留多模态时间戳对齐的工程时间
- ✅ **Phase 3 移动端 + 审核台**：3 周合理
- ✅ **Phase 4 联调验收**：2 周合理
### 6.3 功能优先级合理性
- ✅ **F-09 语境理解提升至 P0**：避免"人工智障"体验
- ✅ **F-17 进度展示提升至 P0**：缓解等待焦虑
- ✅ **F-05 拆分为 A/B**：MVP 聚焦核心防竞品能力
- ✅ **F-45 时长频次校验 P0**：满足 Brief 硬性指标
- ✅ **F-47/48/49 AI 配置 P0**：AI 服务基础设施
---
## 7. 已完成处理项
### 7.1 UI 设计文档统一 ✅
**状态：** 已完成 (2026-02-03)
**描述：** `UIDesign.md`（浅色系）与 `UIDesignSpec.md`（暗色主题）风格冲突
**决策：** 以 `UIDesignSpec.md` 和 `pencil-new.pen` 为准（暗色主题）
**已完成行动：**
1. ✅ 在 `UIDesign.md` 头部添加废弃声明，指向 `UIDesignSpec.md` 为正式规范
2. ✅ `tasks.md` 中的引用保持不变（设计原则部分仍有参考价值）
### 7.2 AIProviderConfig 文档引用更新 ✅
**状态：** 已完成 (2026-02-03)
**描述：** `AIProviderConfig.md` 第7章引用了已废弃的 `UIDesign.md`
**已完成行动：**
- ✅ 更新引用为 `User_Role_Interfaces.md` 第 4.6 章
### 7.3 tdd_plan.md 版本号补充 ✅
**状态：** 已完成 (2026-02-03)
**描述：** `tdd_plan.md` 缺少版本号和文档头部元信息
**已完成行动：**
- ✅ 添加文档头部元信息，版本号 V1.0
---
**当前状态：** ✅ 无待决策项。所有文档一致性问题已解决，可开始开发。
---
## 8. 检查历史
| 检查时间 | 版本 | 检查人 | 发现问题 | 处理结果 |
| --- | --- | --- | --- | --- |
| 2026-02-03 | V1.4 | Claude | UI设计风格不一致、版本号引用 | 已统一 |
| 2026-02-03 | V1.5 | Claude | AIProviderConfig引用过时、tdd_plan缺版本号 | 已修复 |
| 2026-02-03 | V1.6 | Claude | 新增 F-51 品牌方终审开关、F-52 审核流程进度可视化 | 已同步至全部文档 |
| 2026-02-03 | V1.7 | Claude | F-52 扩展为全角色（达人/代理商/品牌方）可见 | 已同步：FeatureSummary、tasks.md、User_Role_Interfaces、UI设计 |

115
FeatureSummary.md
View File

@ -2,8 +2,8 @@
| 文档类型 | **Feature Summary (产品功能文档)** | | 文档类型 | **Feature Summary (产品功能文档)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.3 | | **版本号** | V1.6 |
| **发布日期** | 2026-02-03 | | **发布日期** | 2026-02-03 |
| **关联文档** | RequirementsDoc.md, PRD.md, User_Role_Interfaces.md | | **关联文档** | RequirementsDoc.md, PRD.md, User_Role_Interfaces.md |
| **侧重** | 功能清单、优先级、验收标准、界面映射、边界说明 | | **侧重** | 功能清单、优先级、验收标准、界面映射、边界说明 |
@ -18,6 +18,9 @@
| V1.1 | 2026-02-02 | Claude | 根据 Gemini 修订意见调整：补充验收标准、Out of Scope、核心痛点细化 | | V1.1 | 2026-02-02 | Claude | 根据 Gemini 修订意见调整：补充验收标准、Out of Scope、核心痛点细化 |
| V1.2 | 2026-02-02 | Claude | 根据 Gemini 关键改进意见：优先级调整、功能拆分、新增功能、移动端适配 | | V1.2 | 2026-02-02 | Claude | 根据 Gemini 关键改进意见：优先级调整、功能拆分、新增功能、移动端适配 |
| V1.3 | 2026-02-02 | Claude | **新增 AI 厂商动态配置功能模块 (F-47~F-50)**，支持数据库配置、多租户隔离 | | V1.3 | 2026-02-02 | Claude | **新增 AI 厂商动态配置功能模块 (F-47~F-50)**，支持数据库配置、多租户隔离 |
| V1.4 | 2026-02-03 | Claude | 文档一致性修订：AI 配置单提供商模式、审计日志不可篡改方案、版本号更新 |
| V1.5 | 2026-02-03 | Claude | **新增 F-51 品牌方终审开关、F-52 审核流程进度可视化** |
| V1.6 | 2026-02-03 | Claude | **F-52 扩展为全角色可见**：代理商端（桌面+移动）、品牌方端（桌面+移动）均可查看进度 |
**Gemini 修订意见采纳情况：** **Gemini 修订意见采纳情况：**
@ -37,7 +40,7 @@
### 1.1 产品定位 ### 1.1 产品定位
SmartAudit 是一款**基于多模态大模型的 B2B SaaS 审核工具**，定位为**"智能预审员"**，在人工介入前**自动化拦截 80% 的基础错误和合规风险**，将审核流转周期从"天"缩短到"小时"。 秒思智能审核平台 是一款**基于多模态大模型的 B2B SaaS 审核工具**，定位为**"智能预审员"**，在人工介入前**自动化拦截 80% 的基础错误和合规风险**，将审核流转周期从"天"缩短到"小时"。
### 1.2 核心价值 ### 1.2 核心价值
@ -64,7 +67,7 @@ SmartAudit 是一款**基于多模态大模型的 B2B SaaS 审核工具**，定
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ SmartAudit 功能架构 │ │ 秒思智能审核平台 功能架构 │
├─────────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────────┤
│ │ │ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
@ -372,6 +375,7 @@ SmartAudit 是一款**基于多模态大模型的 B2B SaaS 审核工具**，定
| --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- |
| F-19 | 风险列表展示 | P0 | US-08 | 代理商 | | F-19 | 风险列表展示 | P0 | US-08 | 代理商 |
| F-20 | 确认/驳回操作 | P0 | US-08 | 代理商 | | F-20 | 确认/驳回操作 | P0 | US-08 | 代理商 |
| F-51 | 品牌方终审开关 | **P0** | - | 品牌方 |
| F-21 | 强制通过权 | P1 | US-09 | 品牌方（默认授权代理商） | | F-21 | 强制通过权 | P1 | US-09 | 品牌方（默认授权代理商） |
| F-22 | 特例记录与白名单 | P1 | US-09 | 品牌方 | | F-22 | 特例记录与白名单 | P1 | US-09 | 品牌方 |
| F-23 | 规则依据与证据查看 | P1 | US-08 | 代理商/品牌方 | | F-23 | 规则依据与证据查看 | P1 | US-08 | 代理商/品牌方 |
@ -395,12 +399,95 @@ SmartAudit 是一款**基于多模态大模型的 B2B SaaS 审核工具**，定
**操作说明：** **操作说明：**
- 驳回：自动将勾选的问题打包发送给达人 - 驳回：自动将勾选的问题打包发送给达人
- 通过：流程结束 - 通过：
- 若品牌方**未开启终审**（默认）→ 流程结束，任务状态变为「已通过」
- 若品牌方**已开启终审** → 进入品牌方终审队列，任务状态变为「待终审」
**界面映射：** 代理商端 → 审核决策台 → 决策栏 **界面映射：** 代理商端 → 审核决策台 → 决策栏
--- ---
#### F-51 品牌方终审开关 ⭐ P0 (新增)
**功能描述：** 品牌方可配置是否对代理商初审通过的内容进行终审。
**配置选项：**
- **终审开关**：开启/关闭（**默认关闭**）
- **终审范围**：全部内容 / 仅舆情风险内容 / 仅指定代理商
- **终审超时处理**：超时自动通过 / 超时提醒（默认48小时）
**流程说明：**
```
┌─────────────────────────────────────────────────────────────┐
│ 终审关闭（默认） │
│ 达人提交 → AI审核 → 代理商初审通过 → ✅ 最终通过 │
├─────────────────────────────────────────────────────────────┤
│ 终审开启 │
│ 达人提交 → AI审核 → 代理商初审通过 → 品牌方终审 │
│ ├─ 通过 → ✅ 最终通过 │
│ └─ 驳回 → 返回达人修改 │
└─────────────────────────────────────────────────────────────┘
```
**为什么是 P0：** 审核流程是系统核心逻辑，需在 MVP 阶段确定流程框架，即使默认关闭也需要支持配置能力。
**界面映射：** 品牌方端 → 系统设置 → 审核流程配置
---
#### F-52 审核流程进度可视化 ⭐ P0 (新增)
**功能描述：** **全角色（达人、代理商、品牌方）** 均可在移动端和桌面端实时查看内容的完整审核流程状态，清晰了解当前处于哪个审核阶段。
**审核状态流转：**
```
┌─────────────────────────────────────────────────────────────────┐
│ 审核流程状态（全角色可见） │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ① 已提交 ② AI审核中 ③ 待代理商审核 ④ 待品牌终审 │
│ ⬇️ ⬇️ ⬇️ ⬇️ │
│ ┌──────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 📤 │ ──▶ │ 🤖 AI │ ──▶│ 👥 代理商│ ──▶│ 🛡️ 品牌方│ │
│ │已上传 │ │ 审核中 │ │ 审核中 │ │ 终审中 │ │
│ └──────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ⚠️ 需修改 ⚠️ 驳回 ⚠️ 驳回 │
│ │ │ │ │
│ └───────────────┴───────────────┘ │
│ 返回修改 │
│ │
│ 最终状态：✅ 审核通过 或 ❌ 审核驳回 │
└─────────────────────────────────────────────────────────────────┘
```
**状态定义：**
| 状态 | 图标 | 颜色 | 说明 |
| --- | --- | --- | --- |
| 已提交 | 📤 | 灰色 | 内容已上传，等待处理 |
| AI审核中 | 🤖 | 蓝色/动画 | AI 正在分析内容 |
| AI审核通过 | ✅ | 绿色 | AI 未发现硬性问题，进入人工复核 |
| 需修改 | ⚠️ | 橙色 | AI 发现问题，需要达人修改 |
| 待代理商审核 | 👥 | 紫色 | 等待代理商人工复核 |
| 待品牌终审 | 🛡️ | 紫色 | 等待品牌方终审（仅当终审开启时） |
| 审核通过 | ✅ | 绿色 | 流程完成，可发布 |
| 审核驳回 | ❌ | 红色 | 被驳回，需修改后重新提交 |
**为什么是 P0：** 达人最关心"我的内容现在在哪个环节"，清晰的流程状态能减少达人焦虑，避免频繁询问代理商，提升用户体验。代理商和品牌方也需要在审核时清楚了解内容当前所处阶段。
**界面映射：**
| 角色 | 端 | 页面 | 说明 |
| --- | --- | --- | --- |
| 达人 | 桌面 | 任务列表、审核结果页 | 卡片状态标签 + 顶部进度条 |
| 达人 | 移动 | 任务列表、审核结果页 | 卡片状态标签 + 顶部进度条 |
| 代理商 | 桌面 | 审核决策台 | 顶部进度条，标注"当前：代理商审核" |
| 代理商 | 移动 | 快捷审核 | 导航栏下方进度条 |
| 品牌方 | 桌面 | 终审台 | 顶部进度条，标注"当前：品牌终审" |
| 品牌方 | 移动 | 审批中心 | 审批项内显示进度条 |
---
#### F-21 强制通过权 #### F-21 强制通过权
**功能描述：** 品牌方可手动放行过于保守的误报（如达人玩的新梗）。**默认授权代理商独立使用强制通过功能**；品牌方可在设置中**按代理商**关闭授权，关闭后代理商需发起审批流程。 **功能描述：** 品牌方可手动放行过于保守的误报（如达人玩的新梗）。**默认授权代理商独立使用强制通过功能**；品牌方可在设置中**按代理商**关闭授权，关闭后代理商需发起审批流程。
@ -706,7 +793,7 @@ V1 版本指出 3 个违规点：✅ 已修复 2 个 | ❌ 未修复 1 个
--- ---
### 3.12 系统管理 - AI 厂商配置 (V1.4 新增) ### 3.12 系统管理 - AI 厂商配置 (V1.4 修订)
| 功能编号 | 功能名称 | 优先级 | 用户故事 | 使用角色 | | 功能编号 | 功能名称 | 优先级 | 用户故事 | 使用角色 |
| --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- |
@ -717,13 +804,13 @@ V1 版本指出 3 个违规点：✅ 已修复 2 个 | ❌ 未修复 1 个
#### F-47 AI 厂商动态配置 ⭐ P0 #### F-47 AI 厂商动态配置 ⭐ P0
**功能描述：** 品牌方管理员可在后台配置多个 AI 厂商（DeepSeek、OpenAI、通义千问、OneAPI 中转等），配置存储在数据库中，运行时动态加载，无需修改代码或重启服务。 **功能描述：** 品牌方管理员可在后台配置**单一 AI 提供商**（OneAPI/OpenRouter 中转或直连厂商），配置存储在数据库中，运行时动态加载，无需修改代码或重启服务。每个租户仅保留一套配置，可随时切换提供商。
**核心功能：** **核心功能：**
- 支持添加、编辑、删除 AI 厂商配置 - 支持配置与更新 AI 提供商
- 配置 Base URL、API Key（AES-256-GCM 加密存储）、默认模型 - 配置 Base URL、API Key（AES-256-GCM 加密存储）、默认模型
- 为不同使用场景（Brief 解析、脚本预审、视频审核）指定不同厂商 - 为不同使用场景（Brief 解析、脚本预审、视频审核）指定不同模型
- 配置优先级和备用厂商（故障转移） - 可通过 OneAPI/OpenRouter 聚合多模型
- 未配置时阻断调用并提示品牌方完成配置 - 未配置时阻断调用并提示品牌方完成配置
**为什么是 P0：** 这是 AI 服务的基础设施，所有 AI 功能都依赖此配置。 **为什么是 P0：** 这是 AI 服务的基础设施，所有 AI 功能都依赖此配置。
@ -744,7 +831,7 @@ V1 版本指出 3 个违规点：✅ 已修复 2 个 | ❌ 未修复 1 个
#### F-49 多租户 AI 配置隔离 #### F-49 多租户 AI 配置隔离
**功能描述：** 不同品牌方可配置独立的 AI 厂商，实现租户级别的配置隔离和配额管理。 **功能描述：** 不同品牌方可配置独立的 AI 提供商，实现租户级别的配置隔离和配额管理。
**界面映射：** 品牌方后台 → 系统设置 → AI 配置 **界面映射：** 品牌方后台 → 系统设置 → AI 配置
@ -799,6 +886,8 @@ V1 版本指出 3 个违规点：✅ 已修复 2 个 | ❌ 未修复 1 个
| F-17 | 审核进度实时展示 | 视频审核 | ⭐ P1→P0，缓解等待焦虑 | | F-17 | 审核进度实时展示 | 视频审核 | ⭐ P1→P0，缓解等待焦虑 |
| F-19 | 风险列表展示 | 审核台 | | | F-19 | 风险列表展示 | 审核台 | |
| F-20 | 确认/驳回操作 | 审核台 | | | F-20 | 确认/驳回操作 | 审核台 | |
| F-51 | 品牌方终审开关 | 审核台 | ⭐ 新增，审核流程可配置 |
| F-52 | 审核流程进度可视化 | 达人端 | ⭐ 新增，达人可见审核状态 |
| F-33 | 核心指标卡片 | 数据看板 | | | F-33 | 核心指标卡片 | 数据看板 | |
| F-47 | AI 厂商动态配置 | 系统管理 | ⭐ V1.3 新增，AI 基础设施 | | F-47 | AI 厂商动态配置 | 系统管理 | ⭐ V1.3 新增，AI 基础设施 |
| F-48 | AI 厂商连通性测试 | 系统管理 | ⭐ V1.3 新增 | | F-48 | AI 厂商连通性测试 | 系统管理 | ⭐ V1.3 新增 |
@ -868,7 +957,7 @@ V1 版本指出 3 个违规点：✅ 已修复 2 个 | ❌ 未修复 1 个
| **安全** | 传输与存储加密（AES-256-GCM）；基于角色权限控制；关键操作二次确认 | | **安全** | 传输与存储加密（AES-256-GCM）；基于角色权限控制；关键操作二次确认 |
| **隐私** | 数据最小化；默认保留 30 天；符合《个保法》与 GDPR | | **隐私** | 数据最小化；默认保留 30 天；符合《个保法》与 GDPR |
| **数据本地化** | 国内客户数据存储于中国大陆境内服务器 | | **数据本地化** | 国内客户数据存储于中国大陆境内服务器 |
| **审计** | 操作日志可审计且不可篡改 | | **审计** | 操作日志可审计且不可篡改（append-only + hash chain） |
| **移动端适配** | **达人端（上传/查看报告）必须适配移动端 H5 竖屏操作** | | **移动端适配** | **达人端（上传/查看报告）必须适配移动端 H5 竖屏操作** |
> ⚠️ **移动端适配说明：** 达人的工作场景多在拍摄现场（移动端），需要在手机上完成脚本上传、查看审核结果等操作。如果只做 PC 网页版，达人无法在拍摄现场即时使用，产品价值会大打折扣。 > ⚠️ **移动端适配说明：** 达人的工作场景多在拍摄现场（移动端），需要在手机上完成脚本上传、查看审核结果等操作。如果只做 PC 网页版，达人无法在拍摄现场即时使用，产品价值会大打折扣。
@ -925,7 +1014,7 @@ V1 版本指出 3 个违规点：✅ 已修复 2 个 | ❌ 未修复 1 个
| RequirementsDoc.md | 业务需求文档（用户故事、成功指标） | | RequirementsDoc.md | 业务需求文档（用户故事、成功指标） |
| PRD.md | 产品需求文档（功能需求、技术架构） | | PRD.md | 产品需求文档（功能需求、技术架构） |
| User_Role_Interfaces.md | 用户角色与界面规范 | | User_Role_Interfaces.md | 用户角色与界面规范 |
| **AIProviderConfig.md** | **AI 厂商动态配置架构设计（V2.0）** | | **AIProviderConfig.md** | **AI 厂商动态配置架构设计（V2.1）** |
| 技术设计文档 (TDD) | 待编写 | | 技术设计文档 (TDD) | 待编写 |
| API 接口规范 | 待编写 | | API 接口规范 | 待编写 |
| 数据字典 | 待编写 | | 数据字典 | 待编写 |

35
PRD.md
View File

@ -2,7 +2,7 @@
| 文档类型 | **PRD (Product Requirement Document)** | | 文档类型 | **PRD (Product Requirement Document)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.0 | | **版本号** | V1.0 |
| **发布日期** | 2026-02-03 | | **发布日期** | 2026-02-03 |
| **状态** | 草稿 (Draft) | | **状态** | 草稿 (Draft) |
@ -102,11 +102,12 @@
- 视频自动审核（竞品、违禁词、画面风险） → [US-05] - 视频自动审核（竞品、违禁词、画面风险） → [US-05]
- 审核台风险打点与确认/驳回 → [US-08] - 审核台风险打点与确认/驳回 → [US-08]
- 语境理解降低误报 → [US-04] - 语境理解降低误报 → [US-04]
- 审核进度展示与时间戳修改清单 → [US-07] - 审核进度展示（F-17） → [US-07]
- 基础黑白名单与竞品库（F-05-A） → [US-10A] - 基础黑白名单与竞品库（F-05-A） → [US-10A]
- 时长与频次校验（F-45） → [US-05] - 时长与频次校验（F-45） → [US-05]
- AI 服务配置与连通性测试（F-47/F-48） - AI 服务配置与连通性测试（F-47/F-48）
- 多租户 AI 配置隔离（F-49） - 多租户 AI 配置隔离（F-49）
- 数据看板核心指标卡片（F-33）
**P1（首版发布后快速迭代）** **P1（首版发布后快速迭代）**
- Brand Safety 软性风险提示 → [US-06] - Brand Safety 软性风险提示 → [US-06]
@ -134,6 +135,7 @@
- **规则库管理与版本控制：** 支持平台规则库更新、品牌私有规则与白名单配置 - **规则库管理与版本控制：** 支持平台规则库更新、品牌私有规则与白名单配置
- **权限与多租户隔离：** 支持品牌/代理/达人不同角色的权限与数据隔离 - **权限与多租户隔离：** 支持品牌/代理/达人不同角色的权限与数据隔离
- **审计日志与报告导出：** 支持导出可追溯的审核证据链 - **审计日志与报告导出：** 支持导出可追溯的审核证据链
- **数据看板与核心指标：** 提供核心指标卡片与基础数据概览
### 5.2 Out of Scope ### 5.2 Out of Scope
@ -218,15 +220,21 @@
**P0** **P0**
- 审核台展示风险列表（红/黄/绿分级）与时间戳 - 审核台展示风险列表（红/黄/绿分级）与时间戳
- 支持确认/驳回操作，无需从头看视频 - 支持确认/驳回操作，无需从头看视频
- **可配置审核流程（F-51）**：品牌方可开启/关闭终审环节
- **终审关闭（默认）**：代理商初审通过 → 最终通过
- **终审开启**：代理商初审通过 → 品牌方终审 → 最终通过/驳回
- 支持配置终审范围（全部/仅舆情风险/指定代理商）
- 支持配置终审超时处理（默认48小时）
**P1** **P1**
- 品牌方"强制通过权"：可手动放行过于保守的误报（需记录原因与审批人）；**默认授权代理商独立使用，可在品牌方设置中按代理商关闭，关闭后需走审批流程**。强制通过弹窗需填写原因，并提供“保存为特例”可选项（**默认不勾选**，勾选后形成豁免条款，需品牌方确认生效） - 品牌方"强制通过权"：可手动放行过于保守的误报（需记录原因与审批人）；**默认授权代理商独立使用，可在品牌方设置中按代理商关闭，关闭后需走审批流程**。强制通过弹窗需填写原因，并提供"保存为特例"可选项（**默认不勾选**，勾选后形成豁免条款，需品牌方确认生效）
- 特例可沉淀为规则白名单/豁免条款（含来源：强制通过勾选或手动记录） - 特例可沉淀为规则白名单/豁免条款（含来源：强制通过勾选或手动记录）
- 如需用于模型优化，必须确保数据授权与合规评估 - 如需用于模型优化，必须确保数据授权与合规评估
- 可查看规则依据与证据片段 - 可查看规则依据与证据片段
**验收要点** **验收要点**
- 每条结论包含规则版本、模型版本、证据截图/片段与时间戳 - 每条结论包含规则版本、模型版本、证据截图/片段与时间戳
- 终审开启时，代理商通过后任务状态变为「待终审」，品牌方操作后变为「已通过」或「待修改」
### 6.5 代理商管理 ### 6.5 代理商管理
@ -269,6 +277,22 @@
--- ---
### 6.9 数据看板与核心指标
**P0**
- 核心指标卡片（F-33）：展示审核总量、初审通过率、硬性召回率、舆情拦截数、平均审核周期
**P1**
- 趋势图表（F-34）：近 30 天审核量与通过率趋势
- 风险预警（F-35）：竞品露出集中爆发、达人连续未通过、舆情异常上升
- 代理商绩效对比（F-36）与达人排行榜（F-37）
**验收要点**
- 指标口径与成功指标定义一致
- 指标数据可追溯到审计记录
---
## 7. 关键流程 (Key User Flows) ## 7. 关键流程 (Key User Flows)
### 7.1 品牌方工作流 ### 7.1 品牌方工作流
@ -326,6 +350,7 @@
- 全流程日志可追溯、不可篡改 - 全流程日志可追溯、不可篡改
- 导出报告包含规则版本、模型版本、证据截图/片段与时间戳 - 导出报告包含规则版本、模型版本、证据截图/片段与时间戳
- 支持争议场景下完整审核证据链导出 - 支持争议场景下完整审核证据链导出
- 审计日志采用 append-only + hash chain（前序哈希 + 当前内容）确保可追溯
--- ---
@ -394,13 +419,13 @@
- **ASR/OCR**：支持普通话及主流方言的语音识别，支持复杂背景字幕识别 - **ASR/OCR**：支持普通话及主流方言的语音识别，支持复杂背景字幕识别
- **计算机视觉**：Logo 检测、物体识别、场景分类 - **计算机视觉**：Logo 检测、物体识别、场景分类
- **消息队列**：异步处理视频审核任务，支持优先级调度 - **消息队列**：异步处理视频审核任务，支持优先级调度
- **AI 厂商动态配置**：品牌方管理员可在后台配置多个 AI 厂商（DeepSeek/OpenAI/OneAPI 等），运行时动态加载，支持多租户隔离和故障转移（详见 AIProviderConfig.md） - **AI 厂商动态配置**：品牌方管理员可在后台配置**单一 AI 提供商**（可为 OneAPI/OpenRouter 中转或直连厂商），运行时动态加载，支持多租户隔离；配置变更可随时切换（详见 AIProviderConfig.md）
--- ---
## 14. 里程碑与发布计划 (Milestones) ## 14. 里程碑与发布计划 (Milestones)
- **MVP (P0)**：Brief 解析、规则加载、脚本预审、视频审核、审核台、语境理解降低误报、审核进度展示、基础黑白名单与竞品库、时长与频次校验、AI 服务商配置 - **MVP (P0)**：Brief 解析、规则加载、脚本预审、视频审核、审核台、语境理解降低误报、审核进度展示、基础黑白名单与竞品库、时长与频次校验、AI 服务商配置、核心指标卡片
- **V1.1 (P1)**：Brand Safety 提示、规则版本、证据链导出、强制通过权、高级豁免规则 - **V1.1 (P1)**：Brand Safety 提示、规则版本、证据链导出、强制通过权、高级豁免规则
- **V2 (P2)**：批量处理、版本差异报告 - **V2 (P2)**：批量处理、版本差异报告

6
RequirementsDoc.md
View File

@ -2,7 +2,7 @@
| 文档类型 | **RD (Requirements Document)** | | 文档类型 | **RD (Requirements Document)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.0 | | **版本号** | V1.0 |
| **发布日期** | 2026-02-03 | | **发布日期** | 2026-02-03 |
| **状态** | **修订 (Revised)** | | **状态** | **修订 (Revised)** |
@ -135,6 +135,7 @@
7. **规则库管理与版本控制:** 支持平台规则库更新、品牌私有规则与白名单配置。 7. **规则库管理与版本控制:** 支持平台规则库更新、品牌私有规则与白名单配置。
8. **权限与多租户隔离:** 支持品牌/代理/达人不同角色的权限与数据隔离。 8. **权限与多租户隔离:** 支持品牌/代理/达人不同角色的权限与数据隔离。
9. **审计日志与报告导出:** 支持导出可追溯的审核证据链。 9. **审计日志与报告导出:** 支持导出可追溯的审核证据链。
10. **数据看板与核心指标:** 提供核心指标卡片与基础数据概览。
### ❌ Out of Scope (本期不做) ### ❌ Out of Scope (本期不做)
@ -188,7 +189,7 @@
* **ASR/OCR：** 支持普通话及主流方言的语音识别，支持复杂背景字幕识别 * **ASR/OCR：** 支持普通话及主流方言的语音识别，支持复杂背景字幕识别
* **计算机视觉：** Logo 检测、物体识别、场景分类 * **计算机视觉：** Logo 检测、物体识别、场景分类
* **消息队列：** 异步处理视频审核任务，支持优先级调度 * **消息队列：** 异步处理视频审核任务，支持优先级调度
* **AI 厂商动态配置：** 支持在数据库中配置多个 AI 厂商（DeepSeek/OpenAI/OneAPI 等），运行时动态加载，支持多租户隔离和故障转移（详见 AIProviderConfig.md） * **AI 厂商动态配置：** 支持在数据库中配置**单一 AI 提供商**（可为 OneAPI/OpenRouter 中转或直连厂商），运行时动态加载，支持多租户隔离；配置变更可随时切换（详见 AIProviderConfig.md）
--- ---
@ -213,6 +214,7 @@
* **性能:** ≤ 100MB 视频上传后，AI 预审报告产出时间不超过 5 分钟（含排队 ≤ 2 分钟）。 * **性能:** ≤ 100MB 视频上传后，AI 预审报告产出时间不超过 5 分钟（含排队 ≤ 2 分钟）。
* **审计链路:** 每条结论包含规则版本、模型版本、证据截图/片段与时间戳。 * **审计链路:** 每条结论包含规则版本、模型版本、证据截图/片段与时间戳。
* **F-45 时长与频次统计:** 时长统计误差 ≤ 1秒；频次统计准确率 ≥ 95%。 * **F-45 时长与频次统计:** 时长统计误差 ≤ 1秒；频次统计准确率 ≥ 95%。
* **审计日志不可篡改:** 采用 append-only + hash chain（前序哈希 + 当前内容）校验可追溯。
--- ---

38
UIDesign.md
View File

@ -1,12 +1,23 @@
# UIDesign.md - 智能视频审核系统 UI 设计规范 # UIDesign.md - 智能视频审核系统 UI 设计规范
> ⚠️ **重要说明 (2026-02-03)**
>
> 本文档为**早期设计参考文档**，设计风格为浅色系。
>
> **当前正式设计规范请参考：[UIDesignSpec.md](./UIDesignSpec.md)**
> - 设计稿文件：`pencil-new.pen`
> - 设计风格：Apple-style **暗色主题**
> - 包含最新的设计令牌、组件规范和页面清单
>
> 本文档仅保留用于历史参考和设计原则说明。开发时以 `UIDesignSpec.md` 为准。
| 文档类型 | **UI Design System (设计系统规范)** | | 文档类型 | **UI Design System (设计系统规范)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.1 | | **版本号** | V1.1 |
| **发布日期** | 2026-02-03 | | **发布日期** | 2026-02-03 |
| **设计风格** | Apple Human Interface Guidelines 浅色系 | | **设计风格** | ~~Apple Human Interface Guidelines 浅色系~~ → 已更新为暗色主题，见 UIDesignSpec.md |
| **关联文档** | PRD.md, FeatureSummary.md, User_Role_Interfaces.md, DevelopmentPlan.md | | **关联文档** | PRD.md, FeatureSummary.md, User_Role_Interfaces.md, DevelopmentPlan.md, **UIDesignSpec.md** |
--- ---
@ -16,22 +27,23 @@
| --- | --- | --- | --- | | --- | --- | --- | --- |
| V1.0 | 2026-02-02 | Claude | 初稿：设计原则、色彩系统、组件库、三端界面规范 | | V1.0 | 2026-02-02 | Claude | 初稿：设计原则、色彩系统、组件库、三端界面规范 |
| V1.1 | 2026-02-02 | Claude | 新增第10章：AI 服务配置界面设计规范 | | V1.1 | 2026-02-02 | Claude | 新增第10章：AI 服务配置界面设计规范 |
| V1.2 | 2026-02-03 | Claude | 添加废弃声明，指向 UIDesignSpec.md（暗色主题） |
--- ---
## 1. 设计原则 (Design Principles) ## 1. 设计原则 (Design Principles)
借鉴 Apple Human Interface Guidelines，SmartAudit 的设计遵循以下核心原则： 借鉴 Apple Human Interface Guidelines，秒思智能审核平台 的设计遵循以下核心原则：
### 1.1 核心设计理念 ### 1.1 核心设计理念
| 原则 | 描述 | 在 SmartAudit 中的体现 | | 原则 | 描述 | 在 秒思智能审核平台 中的体现 |
| --- | --- | --- | | --- | --- | --- |
| **Clarity (清晰)** | 文字清晰易读，图标精确传意，功能显而易见 | 审核结论用红/黄/绿 + 文字 + 图标三重表达 | | **Clarity (清晰)** | 文字清晰易读，图标精确传意，功能显而易见 | 审核结论用红/黄/绿 + 文字 + 图标三重表达 |
| **Deference (克制)** | UI 退居幕后，内容为王 | 审核台以视频和报告为核心，界面元素轻量化 | | **Deference (克制)** | UI 退居幕后，内容为王 | 审核台以视频和报告为核心，界面元素轻量化 |
| **Depth (层次)** | 通过视觉层次和流畅动效建立空间感 | 卡片悬浮阴影、模态弹窗、进度条层叠 | | **Depth (层次)** | 通过视觉层次和流畅动效建立空间感 | 卡片悬浮阴影、模态弹窗、进度条层叠 |
### 1.2 SmartAudit 专属原则 ### 1.2 秒思智能审核平台 专属原则
| 原则 | 说明 | | 原则 | 说明 |
| --- | --- | | --- | --- |
@ -641,7 +653,7 @@ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text",
│ │ │ │
│ ┌──────────┐ ┌────────────────────────────────────────────────────────┐ │ │ ┌──────────┐ ┌────────────────────────────────────────────────────────┐ │
│ │ │ │ │ │ │ │ │ │ │ │
│ │ SmartAudit│ │ 页面内容区域 │ │ │ │ 秒思智能审核平台│ │ 页面内容区域 │ │
│ │ │ │ │ │ │ │ │ │ │ │
│ ├──────────┤ │ │ │ │ ├──────────┤ │ │ │
│ │ │ │ │ │ │ │ │ │ │ │
@ -680,7 +692,7 @@ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text",
``` ```
┌────────────────────────────────────────────────────────────────────────────┐ ┌────────────────────────────────────────────────────────────────────────────┐
│ SmartAudit 🔔 (3) 👤 张三 │ │ 秒思智能审核平台 🔔 (3) 👤 张三 │
├──────────┬─────────────────────────────────────────────────────────────────┤ ├──────────┬─────────────────────────────────────────────────────────────────┤
│ │ │ │ │ │
│ 📊 工作台 │ 工作台 │ │ 📊 工作台 │ 工作台 │
@ -727,7 +739,7 @@ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text",
``` ```
┌────────────────────────────────────────────────────────────────────────────┐ ┌────────────────────────────────────────────────────────────────────────────┐
│ SmartAudit 🔔 (3) 👤 张三 │ │ 秒思智能审核平台 🔔 (3) 👤 张三 │
├──────────┬─────────────────────────────────────────────────────────────────┤ ├──────────┬─────────────────────────────────────────────────────────────────┤
│ │ │ │ │ │
│ 📊 工作台 │ Brief 配置中心 │ │ 📊 工作台 │ Brief 配置中心 │
@ -769,7 +781,7 @@ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text",
``` ```
┌────────────────────────────────────────────────────────────────────────────┐ ┌────────────────────────────────────────────────────────────────────────────┐
│ SmartAudit 🔔 (3) 👤 张三 │ │ 秒思智能审核平台 🔔 (3) 👤 张三 │
├──────────┬─────────────────────────────────────────────────────────────────┤ ├──────────┬─────────────────────────────────────────────────────────────────┤
│ │ │ │ │ │
│ 📊 工作台 │ 审核决策台 ⬅️ ➡️ │ │ 📊 工作台 │ 审核决策台 ⬅️ ➡️ │
@ -892,7 +904,7 @@ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text",
``` ```
┌────────────────────────────────────────────────────────────────────────────┐ ┌────────────────────────────────────────────────────────────────────────────┐
│ SmartAudit 🔔 (3) 👤 王总 │ │ 秒思智能审核平台 🔔 (3) 👤 王总 │
├──────────┬─────────────────────────────────────────────────────────────────┤ ├──────────┬─────────────────────────────────────────────────────────────────┤
│ │ │ │ │ │
│ 📊 数据 │ 数据看板 本月 ▼ 导出报告 ▼ │ │ 📊 数据 │ 数据看板 本月 ▼ 导出报告 ▼ │
@ -936,7 +948,7 @@ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text",
``` ```
┌────────────────────────────────────────────────────────────────────────────┐ ┌────────────────────────────────────────────────────────────────────────────┐
│ SmartAudit 🔔 (3) 👤 王总 │ │ 秒思智能审核平台 🔔 (3) 👤 王总 │
├──────────┬─────────────────────────────────────────────────────────────────┤ ├──────────┬─────────────────────────────────────────────────────────────────┤
│ │ │ │ │ │
│ 📊 数据 │ 规则配置 │ │ 📊 数据 │ 规则配置 │
@ -998,7 +1010,7 @@ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text",
``` ```
┌────────────────────────────────────────────────────────────────────────────┐ ┌────────────────────────────────────────────────────────────────────────────┐
│ SmartAudit 🔔 (3) 👤 王总 │ │ 秒思智能审核平台 🔔 (3) 👤 王总 │
├──────────┬─────────────────────────────────────────────────────────────────┤ ├──────────┬─────────────────────────────────────────────────────────────────┤
│ │ │ │ │ │
│ 📊 数据 │ AI 服务配置 │ │ 📊 数据 │ AI 服务配置 │

2
UIDesignSpec.md
View File

@ -2,7 +2,7 @@
| 文档类型 | **UI Design Specification** | | 文档类型 | **UI Design Specification** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.0 | | **版本号** | V1.0 |
| **发布日期** | 2026-02-03 | | **发布日期** | 2026-02-03 |
| **设计稿文件** | `pencil-new.pen` | | **设计稿文件** | `pencil-new.pen` |

256
User_Role_Interfaces.md
View File

@ -2,8 +2,8 @@
| 文档类型 | **UI/UX Spec (Interface Definitions)** | | 文档类型 | **UI/UX Spec (Interface Definitions)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.3 | | **版本号** | V1.5 |
| **发布日期** | 2026-02-03 | | **发布日期** | 2026-02-03 |
| **关联文档** | RequirementsDoc.md, PRD.md, FeatureSummary.md, DevelopmentPlan.md, AIProviderConfig.md, UIDesign.md, tasks.md | | **关联文档** | RequirementsDoc.md, PRD.md, FeatureSummary.md, DevelopmentPlan.md, AIProviderConfig.md, UIDesign.md, tasks.md |
| **侧重** | 角色权限、核心页面布局、交互逻辑 | | **侧重** | 角色权限、核心页面布局、交互逻辑 |
@ -19,6 +19,8 @@
| V1.1 | 2026-02-02 | Claude | 与 RD/PRD 对齐：补充用户故事引用、区域合规、特例记录规范、证据链权限 | | V1.1 | 2026-02-02 | Claude | 与 RD/PRD 对齐：补充用户故事引用、区域合规、特例记录规范、证据链权限 |
| V1.2 | 2026-02-02 | Claude | 新增代理商端和品牌方端移动端 UI 设计（工作台、快捷审核、预警、审批） | | V1.2 | 2026-02-02 | Claude | 新增代理商端和品牌方端移动端 UI 设计（工作台、快捷审核、预警、审批） |
| V1.3 | 2026-02-02 | Claude | 新增 AI 服务配置章节（4.6），品牌方专属功能 | | V1.3 | 2026-02-02 | Claude | 新增 AI 服务配置章节（4.6），品牌方专属功能 |
| V1.4 | 2026-02-03 | Claude | **新增审核流程进度可视化 UI（F-52）**：达人端任务列表状态标签、审核结果页进度条 |
| V1.5 | 2026-02-03 | Claude | **扩展审核流程进度可视化至全角色**：代理商审核决策台/快捷审核、品牌方审批中心均可查看进度条 |
--- ---
@ -34,14 +36,16 @@
| **Brief 管理** | 查看任务详情 | ✅ 上传/解析/编辑 Brief | ✅ 全局规则配置 | | **Brief 管理** | 查看任务详情 | ✅ 上传/解析/编辑 Brief | ✅ 全局规则配置 |
| **脚本/视频提交** | ✅ 上传 & 修改 [US-03] | ❌ 不可提交 | ❌ 不可提交 | | **脚本/视频提交** | ✅ 上传 & 修改 [US-03] | ❌ 不可提交 | ❌ 不可提交 |
| **查看 AI 报告** | ✅ 仅查看自己的 [US-07] | ✅ 查看所管辖达人的 | ✅ 查看所有 | | **查看 AI 报告** | ✅ 仅查看自己的 [US-07] | ✅ 查看所管辖达人的 | ✅ 查看所有 |
| **审核决策** | ❌ 无权 | ✅ 初审 (驳回/通过) [US-08] | ✅ 终审 / 强制通过 [US-09] | | **审核决策** | ❌ 无权 | ✅ 初审 (驳回/通过) [US-08] | ✅ 终审（可配置）/ 强制通过 [US-09] |
| **申诉功能** | ✅ 发起申诉 (消耗令牌) | ✅ 仲裁申诉 | ❌ 无需申诉 | | **申诉功能** | ✅ 发起申诉 (消耗令牌) | ✅ 仲裁申诉 | ❌ 无需申诉 |
| **证据链导出** | ❌ 无权 | ✅ 导出所管辖任务 | ✅ 导出全部 [US-12] | | **证据链导出** | ❌ 无权 | ✅ 导出所管辖任务 | ✅ 导出全部 [US-12] |
| **数据看板** | 仅看个人任务进度 | 整体进度 / 达人排名 | 全局合规率 / 舆情风控 | | **数据看板** | 仅看个人任务进度 | 整体进度 / 达人排名 | 全局合规率 / 舆情风控 |
| **系统配置** | ❌ 无权 | ❌ 无权 | ✅ 规则库/阈值/白名单/区域合规 [US-10A/US-10B] | | **系统配置** | ❌ 无权 | ❌ 无权 | ✅ 规则库/阈值/白名单/区域合规/审核流程 [US-10A/US-10B] |
| **AI 服务配置** | ❌ 无权 | ❌ 无权（继承品牌方配置） | ✅ 配置 AI 提供商/模型/参数 | | **AI 服务配置** | ❌ 无权 | ❌ 无权（继承品牌方配置） | ✅ 配置 AI 提供商/模型/参数 |
| **用户管理** | ❌ 无权 | ✅ 管理所属达人 | ✅ 管理代理商与达人 | | **用户管理** | ❌ 无权 | ✅ 管理所属达人 | ✅ 管理代理商与达人 |
> **审核流程说明：** 品牌方可在系统设置中配置是否开启终审环节。**默认关闭**，代理商初审通过即为最终通过；开启后，代理商初审通过的内容需进入品牌方终审队列。
--- ---
## 1.1 各端导航结构 (Navigation Structure) ## 1.1 各端导航结构 (Navigation Structure)
@ -108,13 +112,52 @@
## 2. 界面详解：达人端 (The Creator Portal) ## 2. 界面详解：达人端 (The Creator Portal)
**设计目标：** 极简、透明、减少焦虑。让达人像发朋友圈一样简单地完成合规检查。 **设计目标：** 极简、透明、减少焦虑。让达人像发朋友圈一样简单地完成合规检查。
**核心设备：** 手机浏览器 (Mobile Web) / 小程序。 **核心设备：** 手机浏览器 (H5) / 小程序。
### 2.1 任务列表页 (Task List) ### 2.1 任务列表页 (Task List)
* **状态概览：** 卡片式布局，显示当前任务状态（待提交、AI审核中、需修改、已通过）。 * **状态概览：** 卡片式布局，显示当前任务状态（待提交、AI审核中、需修改、已通过）。
* **行动号召 (CTA):** 针对不同状态显示醒目按钮，如 `[上传脚本]` 或 `[查看修改意见]`。 * **行动号召 (CTA):** 针对不同状态显示醒目按钮，如 `[上传脚本]` 或 `[查看修改意见]`。
#### 2.1.1 审核流程进度可视化 ⭐ F-52
**功能说明：** 达人可在任务列表和详情页清晰看到内容当前处于哪个审核阶段。
**任务卡片状态标签：**
```
┌─────────────────────────────────────────────────────────────────┐
│ 📹 XX品牌618推广 │
│ │
│ 审核进度： │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ ✅已提交 → 🤖AI审核中 → ○待代理商审核 → ○待品牌终审 → ○通过 │ │
│ │ ↑当前阶段 │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ 状态: 🤖 AI审核中 更新于: 2分钟前 │
│ [查看详情] │
└─────────────────────────────────────────────────────────────────┘
```
**状态定义与样式：**
| 状态 | 图标 | 颜色 | 标签文案 |
| --- | --- | --- | --- |
| 待提交 | 📤 | 灰色 | 待提交 |
| 已提交 | ✅ | 灰色 | 已提交 |
| AI审核中 | 🤖 | 蓝色(动画) | AI审核中 |
| AI审核通过 | ✅ | 绿色 | AI通过，待人工复核 |
| 需修改 | ⚠️ | 橙色 | 需修改 |
| 待代理商审核 | 👥 | 紫色 | 等待代理商审核 |
| 代理商驳回 | ❌ | 红色 | 代理商驳回 |
| 待品牌终审 | 🛡️ | 紫色 | 等待品牌方终审 |
| 品牌方驳回 | ❌ | 红色 | 品牌方驳回 |
| 审核通过 | ✅ | 绿色 | 审核通过，可发布 |
**进度条规则：**
- 终审关闭时：显示 4 步（已提交 → AI审核 → 代理商审核 → 通过）
- 终审开启时：显示 5 步（已提交 → AI审核 → 代理商审核 → 品牌终审 → 通过）
- 当前阶段高亮显示，已完成阶段打勾，未到达阶段灰色
### 2.2 智能上传与扫描页 (The Magic Scanner) [US-03, US-07] ### 2.2 智能上传与扫描页 (The Magic Scanner) [US-03, US-07]
这是达人等待 AI 结果的页面，必须缓解等待焦虑（Wait-time Anxiety）。 这是达人等待 AI 结果的页面，必须缓解等待焦虑（Wait-time Anxiety）。
@ -136,7 +179,38 @@
### 2.3 审核结果反馈页 (Audit Report) ### 2.3 审核结果反馈页 (Audit Report)
当 AI 发现问题时，不能直接把 JSON 扔给达人，要翻译成“人话”。 当 AI 发现问题时，不能直接把 JSON 扔给达人，要翻译成"人话"。
#### 2.3.1 审核流程进度条 ⭐ F-52
**页面顶部显示完整审核流程进度：**
```
┌─────────────────────────────────────────────────────────────────┐
│ 📹 XX品牌618推广 - 审核详情 返回 ← │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ 已提交 AI审核 代理商审核 最终结果 │ │
│ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │
│ │ │ ✅ │ ───▶ │ ✅ │ ───▶ │ 👥 │ ───▶ │ ○ │ │ │
│ │ │ 完成 │ │ 通过 │ │审核中│ │ 待定 │ │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ │ │
│ │ 2/3 10:30 2/3 10:35 当前 │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ 当前状态：👥 等待代理商审核 │
│ 预计处理时间：通常 2-4 小时内 │
│ │
├─────────────────────────────────────────────────────────────────┤
│ 以下为审核详情内容... │
└─────────────────────────────────────────────────────────────────┘
```
**进度条交互：**
- 点击已完成的节点可查看该阶段详情（时间、处理人、结果）
- 当前阶段显示预估等待时间
- 驳回状态时显示驳回原因摘要
* **结果横幅：** * **结果横幅：**
* 🔴 **未通过 (Blocked):** 存在硬性违规，必须修改。 * 🔴 **未通过 (Blocked):** 存在硬性违规，必须修改。
@ -231,6 +305,31 @@
**布局结构：** **布局结构：**
#### 3.3.1 审核流程进度条 ⭐ F-52
**页面顶部显示当前任务的审核流程进度：**
```
┌─────────────────────────────────────────────────────────────────┐
│ 审核决策台 返回列表 ← │
├─────────────────────────────────────────────────────────────────┤
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ 审核流程 当前：代理商审核 │ │
│ │ │ │
│ │ ✅已提交 ────▶ ✅AI审核 ────▶ ●代理商审核 ────▶ ○品牌终审 │ │
│ │ ↑当前阶段 │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │
│ [视频播放器区域] [AI检查单区域] │
└─────────────────────────────────────────────────────────────────┘
```
**进度条显示规则：**
- 当前阶段：紫色高亮，大圆点
- 已完成阶段：绿色 ✅，显示完成时间
- 待处理阶段：灰色空心圆
- 品牌终审步骤：仅当品牌方开启终审时显示
* **左侧：视频播放器** * **左侧：视频播放器**
* **智能进度条：** 进度条上打满 colored dots * **智能进度条：** 进度条上打满 colored dots
* 🔴 红点：硬伤（点击跳转） * 🔴 红点：硬伤（点击跳转）
@ -250,11 +349,13 @@
* **底部：决策栏 (Action Bar)** * **底部：决策栏 (Action Bar)**
* `[ 驳回 ]`：点击后，自动将勾选的问题打包发送给达人 * `[ 驳回 ]`：点击后，自动将勾选的问题打包发送给达人
* `[ 强制通过 ]` [US-09]：强制通过（默认可用；品牌方关闭授权时按钮改为“申请强制通过”，提交后进入审批） * `[ 强制通过 ]` [US-09]：强制通过（默认可用；品牌方关闭授权时按钮改为"申请强制通过"，提交后进入审批）
* **必须填写放行原因**（如"达人玩的新梗，品牌方认可"） * **必须填写放行原因**（如"达人玩的新梗，品牌方认可"）
* 弹窗提供“**保存为特例**”可选项（**默认不勾选**，勾选后形成豁免条款，需品牌方确认后生效） * 弹窗提供"**保存为特例**"可选项（**默认不勾选**，勾选后形成豁免条款，需品牌方确认后生效）
* **记录审批人**与操作时间，纳入审计日志 * **记录审批人**与操作时间，纳入审计日志
* `[ 通过 ]`：流程结束 * `[ 通过 ]`：
* 若品牌方**未开启终审**（默认）→ 流程结束，任务状态「已通过」
* 若品牌方**已开启终审** → 进入品牌方终审队列，任务状态「待终审」
@ -360,6 +461,10 @@
│ ← 返回 快捷审核 ⋮ 更多 │ │ ← 返回 快捷审核 ⋮ 更多 │
├─────────────────────────────────────────────┤ ├─────────────────────────────────────────────┤
│ ┌─────────────────────────────────────┐ │ │ ┌─────────────────────────────────────┐ │
│ │ 审核流程 代理商审核中 │ │
│ │ ✅提交 ─▶ ✅AI ─▶ ●代理商 ─▶ ○终审 │ │
│ └─────────────────────────────────────┘ │
│ ┌─────────────────────────────────────┐ │
│ │ │ │ │ │ │ │
│ │ 📹 视频播放器 │ │ │ │ 📹 视频播放器 │ │
│ │ (支持横屏全屏) │ │ │ │ (支持横屏全屏) │ │
@ -524,7 +629,101 @@
* **模型版本号：** AI 检测时使用的模型版本 * **模型版本号：** AI 检测时使用的模型版本
* 完整操作日志（不可篡改） * 完整操作日志（不可篡改）
### 4.5 舆情预警中心 (Brand Safety Center) ### 4.5 终审台 (Final Review) ⭐ 新增
**入口位置：** 品牌方端侧边栏 → 终审台（仅当终审开启时显示）
**触发条件：** 品牌方在系统设置中开启「终审开关」后，代理商初审通过的内容进入此队列
#### 4.5.1 终审列表
```
┌─────────────────────────────────────────────────────────────────┐
│ ✅ 待终审 (8) 筛选 ▼ 搜索 🔍 │
├─────────────────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 📹 XX品牌618推广 - 达人A │ │
│ │ 代理商：代理商A · 初审人：张三 · 3小时前 │ │
│ │ 🟡 舆情风险 1 项 [查看详情] │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 📹 XX品牌新品测评 - 达人B │ │
│ │ 代理商：代理商B · 初审人：李四 · 5小时前 │ │
│ │ ✅ 无风险项 [查看详情] │ │
│ └─────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ ⏱️ 超时提醒：2 条内容将在 24 小时内超时 │
└─────────────────────────────────────────────────────────────────┘
```
#### 4.5.2 终审详情页 ⭐ F-52
**UI 设计：** `pencil-new.pen` → "品牌方端 - 终审台" (aePi5)
**审核流程进度条（页面顶部）：**
```
┌─────────────────────────────────────────────────────────────────┐
│ 终审台 返回列表 ← │
│ 春季护肤新品体验分享 · 达人: 小美 │
├─────────────────────────────────────────────────────────────────┤
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ 审核流程 当前：品牌终审 │ │
│ │ │ │
│ │ ✅已提交 ────▶ ✅AI审核 ────▶ ✅代理商审核 ────▶ ●品牌终审 │ │
│ │ ↑当前阶段 │ │
│ └────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
* **布局：** 复用代理商审核决策台布局（视频播放器 + AI 检查单）
* **额外信息：** 显示代理商初审意见和通过理由
* **决策按钮：**
* `[ 驳回 ]`：填写驳回理由，任务状态变为「终审驳回」，返回达人修改
* `[ 通过 ]`：任务状态变为「已通过」，流程结束
#### 4.5.3 审核流程配置
**入口位置：** 系统设置 → 审核流程配置
```
┌─────────────────────────────────────────────────────────────────┐
│ ⚙️ 审核流程配置 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 品牌方终审 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ ○ 关闭（默认）- 代理商初审通过即为最终通过 │ │
│ │ ● 开启 - 代理商初审通过后需品牌方终审 │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ 终审范围（仅当开启终审时可配置） │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ ● 全部内容 │ │
│ │ ○ 仅舆情风险内容（AI 标记为黄色/红色舆情风险） │ │
│ │ ○ 仅指定代理商 │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ 终审超时处理 │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ 超时时间：[ 48 ] 小时 │ │
│ │ ● 超时后自动通过 │ │
│ │ ○ 超时后仅提醒（不自动通过） │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ [ 取消 ] [ 保存 ] │
└─────────────────────────────────────────────────────────────────┘
```
**配置说明：**
| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| 终审开关 | **关闭** | 关闭时代理商通过即为最终通过 |
| 终审范围 | 全部内容 | 可按内容类型或代理商筛选 |
| 超时时间 | 48小时 | 待终审内容的最长等待时间 |
| 超时处理 | 自动通过 | 超时后自动通过或仅提醒 |
---
### 4.6 舆情预警中心 (Brand Safety Center)
* **实时监控：** * **实时监控：**
* 近期被 AI 标记为"舆情风险"的视频列表 * 近期被 AI 标记为"舆情风险"的视频列表
@ -537,7 +736,7 @@
* **预警规则：** * **预警规则：**
* 配置自动通知规则（如：高风险视频自动 @品牌方） * 配置自动通知规则（如：高风险视频自动 @品牌方）
### 4.6 AI 服务配置 (AI Configuration) 🤖 ### 4.7 AI 服务配置 (AI Configuration) 🤖
**入口位置：** 系统设置 → AI 服务配置 **入口位置：** 系统设置 → AI 服务配置
**权限控制：** 仅品牌方管理员可配置，代理商和达人自动继承品牌方配置 **权限控制：** 仅品牌方管理员可配置，代理商和达人自动继承品牌方配置
@ -721,15 +920,26 @@
#### 4.7.3 移动端审批中心 (Approval Center) #### 4.7.3 移动端审批中心 (Approval Center)
**场景：** 当品牌方关闭授权时，代理商申请"强制通过"，品牌方需审批。 **场景：**
1. 当品牌方关闭授权时，代理商申请"强制通过"，品牌方需审批
2. **当开启品牌终审时，代理商初审通过的视频进入品牌方终审队列** ⭐ F-52
``` ```
┌─────────────────────────────────────────────┐ ┌─────────────────────────────────────────────┐
│ ✅ 待审批 筛选 ▼ │ │ 审批中心 待审批 │ 已处理 │
├─────────────────────────────────────────────┤ ├─────────────────────────────────────────────┤
│ 待处理 (3) │
│ ┌─────────────────────────────────────┐ │ │ ┌─────────────────────────────────────┐ │
│ │ 🟡 强制通过申请 │ │ │ │ 🟣 视频终审申请 30分钟前│ │
│ │ 达人「小美」的视频「春季护肤新品 │ │
│ │ 体验」已通过代理商审核，等待终审 │ │
│ │ │ │
│ │ 审核流程进度： │ │
│ │ ✅提交 ─▶ ✅AI ─▶ ✅代理商 ─▶ ●终审│ │
│ │ │ │
│ │ [ 拒绝 ] [ 通过 ] │ │
│ └─────────────────────────────────────┘ │
│ ┌─────────────────────────────────────┐ │
│ │ 🟡 强制通过申请 10分钟前│ │
│ │ 达人：@小美美 │ │ │ │ 达人：@小美美 │ │
│ │ 申请人：代理商A - 张三 │ │ │ │ 申请人：代理商A - 张三 │ │
│ │ 原因：达人玩的新梗，品牌方认可 │ │ │ │ 原因：达人玩的新梗，品牌方认可 │ │
@ -740,18 +950,30 @@
│ │ │ │ │ │ │ │
│ │ [ 拒绝 ] [ 批准 ] │ │ │ │ [ 拒绝 ] [ 批准 ] │ │
│ └─────────────────────────────────────┘ │ │ └─────────────────────────────────────┘ │
├─────────────────────────────────────────────┤ │ ┌─────────────────────────────────────┐ │
│ 已处理 (12) [查看 >] │ │ │ 🟡 规则配置变更 2小时前 │ │
│ │ 代理商「星耀传媒」申请修改审核规则│ │
│ │ 竞品露出阈值调整为70% │ │
│ │ │ │
│ │ [ 拒绝 ] [ 通过 ] │ │
│ └─────────────────────────────────────┘ │
├─────────────────────────────────────────────┤ ├─────────────────────────────────────────────┤
│ 📊 🔔 ✅ 📋 👤 │ │ 📊 🔔 ✅ 📋 👤 │
└─────────────────────────────────────────────┘ └─────────────────────────────────────────────┘
``` ```
**视频终审审批项说明：** ⭐ F-52
* 仅当品牌方开启"终审开关"时显示此类审批项
* 显示完整审核流程进度条，品牌终审阶段高亮
* 点击可查看视频详情和代理商初审意见
* 通过/拒绝后自动通知代理商和达人
**交互说明：** **交互说明：**
* 点击视频片段可预览关键时间点 * 点击视频片段可预览关键时间点
* 批准/拒绝需二次确认 * 批准/拒绝需二次确认
* 批准后自动通知代理商和达人 * 批准后自动通知代理商和达人
* 审批记录同步至审计日志 * 审批记录同步至审计日志
* **进度条交互：** 点击已完成节点可查看该阶段详情（处理人、时间、结果）
#### 4.7.4 移动端审计日志 (Audit Quick View) #### 4.7.4 移动端审计日志 (Audit Quick View)

2
ai-config-demo.html
View File

@ -3,7 +3,7 @@
<head> <head>
<meta charset="utf-8" /> <meta charset="utf-8" />
<meta name="viewport" content="width=device-width,initial-scale=1" /> <meta name="viewport" content="width=device-width,initial-scale=1" />
<title>SmartAudit · AI 服务配置（说明版）</title> <title>秒思智能审核平台 · AI 服务配置（说明版）</title>
<style> <style>
:root { :root {
--bg: #0b0c0f; --bg: #0b0c0f;

1621
featuredoc/tdd_plan.md
View File

File diff suppressed because it is too large Load Diff

2
frontend/components/index.ts
View File

@ -1,5 +1,5 @@
/** /**
* SmartAudit 组件库统一导出 * 秒思智能审核平台组件库统一导出
* 基于 UIDesignSpec.md 设计规范 * 基于 UIDesignSpec.md 设计规范
*/ */

2
frontend/package.json
View File

@ -1,7 +1,7 @@
{ {
"name": "smartaudit-frontend", "name": "smartaudit-frontend",
"version": "1.0.0", "version": "1.0.0",
"description": "SmartAudit AI 营销内容合规审核平台 - 前端", "description": "秒思智能审核平台（AI 营销内容合规审核平台）- 前端",
"private": true, "private": true,
"scripts": { "scripts": {
"dev": "next dev", "dev": "next dev",

2
frontend/styles/globals.css
View File

@ -1,4 +1,4 @@
/* SmartAudit - 全局样式文件 */ /* 秒思智能审核平台 - 全局样式文件 */
/* 基于 UIDesignSpec.md 设计规范 */ /* 基于 UIDesignSpec.md 设计规范 */
@import url('https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&display=swap'); @import url('https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&display=swap');

3685
pencil-new.pen
View File

File diff suppressed because it is too large Load Diff

199
scripts/setup-github.sh Executable file
View File

@ -0,0 +1,199 @@
#!/bin/bash
#
# GitHub 仓库配置脚本
# 用于配置分支保护规则和其他 GitHub 设置
#
# 使用方法: ./scripts/setup-github.sh
#
set -e
# 颜色定义
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# 日志函数
log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
echo ""
echo "========================================"
echo " 秒思智能审核平台 - GitHub 配置脚本"
echo "========================================"
echo ""
# 1. 检查 GitHub CLI 是否安装
log_info "检查 GitHub CLI..."
if ! command -v gh &> /dev/null; then
log_error "GitHub CLI (gh) 未安装"
echo ""
echo "请先安装 GitHub CLI:"
echo " macOS: brew install gh"
echo " Ubuntu: sudo apt install gh"
echo " Windows: winget install GitHub.cli"
echo ""
echo "安装后运行: gh auth login"
exit 1
fi
log_success "GitHub CLI 已安装: $(gh --version | head -n1)"
# 2. 检查是否已登录
log_info "检查 GitHub 登录状态..."
if ! gh auth status &> /dev/null; then
log_error "未登录 GitHub"
echo ""
echo "请运行以下命令登录:"
echo " gh auth login"
echo ""
exit 1
fi
log_success "已登录 GitHub"
# 3. 检查是否在 git 仓库中
log_info "检查 Git 仓库..."
if ! git rev-parse --is-inside-work-tree &> /dev/null; then
log_error "当前目录不是 Git 仓库"
exit 1
fi
# 4. 获取远程仓库信息
log_info "获取远程仓库信息..."
REMOTE_URL=$(git remote get-url origin 2>/dev/null || echo "")
if [ -z "$REMOTE_URL" ]; then
log_error "未找到远程仓库 (origin)"
echo ""
echo "请先添加远程仓库:"
echo " git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git"
echo ""
exit 1
fi
# 解析 owner/repo
if [[ "$REMOTE_URL" =~ github\.com[:/]([^/]+)/([^/.]+)(\.git)?$ ]]; then
OWNER="${BASH_REMATCH[1]}"
REPO="${BASH_REMATCH[2]}"
else
log_error "无法解析 GitHub 仓库地址: $REMOTE_URL"
exit 1
fi
log_success "仓库: $OWNER/$REPO"
# 5. 检查仓库是否存在于 GitHub
log_info "验证远程仓库..."
if ! gh repo view "$OWNER/$REPO" &> /dev/null; then
log_warn "远程仓库不存在或无权限访问"
echo ""
read -p "是否创建远程仓库? (y/n): " CREATE_REPO
if [ "$CREATE_REPO" = "y" ]; then
log_info "创建远程仓库..."
gh repo create "$OWNER/$REPO" --private --source=. --push
log_success "远程仓库已创建"
else
log_error "请先在 GitHub 上创建仓库"
exit 1
fi
fi
# 6. 获取默认分支
log_info "获取默认分支..."
DEFAULT_BRANCH=$(gh repo view "$OWNER/$REPO" --json defaultBranchRef --jq '.defaultBranchRef.name' 2>/dev/null || echo "main")
log_info "默认分支: $DEFAULT_BRANCH"
# 7. 配置分支保护规则
echo ""
log_info "配置分支保护规则..."
# 构建 JSON payload
PROTECTION_PAYLOAD=$(cat <<EOF
{
"required_status_checks": {
"strict": true,
"contexts": [
"Frontend Tests / Unit & Integration Tests",
"Backend Tests / Unit & Integration Tests"
]
},
"enforce_admins": false,
"required_pull_request_reviews": {
"required_approving_review_count": 1,
"dismiss_stale_reviews": true,
"require_code_owner_reviews": false
},
"restrictions": null,
"allow_force_pushes": false,
"allow_deletions": false
}
EOF
)
# 应用分支保护规则
if gh api "repos/$OWNER/$REPO/branches/$DEFAULT_BRANCH/protection" \
--method PUT \
--input - <<< "$PROTECTION_PAYLOAD" &> /dev/null; then
log_success "分支保护规则已配置"
else
log_warn "分支保护规则配置失败（可能需要 GitHub Pro/Team 计划）"
echo ""
echo "对于免费版 GitHub，请手动在 Web UI 配置:"
echo " 1. 进入 https://github.com/$OWNER/$REPO/settings/branches"
echo " 2. 点击 'Add branch protection rule'"
echo " 3. Branch name pattern: $DEFAULT_BRANCH"
echo " 4. 勾选 'Require a pull request before merging'"
echo " 5. 勾选 'Require status checks to pass before merging'"
echo ""
fi
# 8. 验证配置
echo ""
log_info "验证分支保护配置..."
PROTECTION_STATUS=$(gh api "repos/$OWNER/$REPO/branches/$DEFAULT_BRANCH/protection" 2>/dev/null || echo "none")
if [ "$PROTECTION_STATUS" != "none" ]; then
log_success "分支保护规则已生效"
echo ""
echo "当前保护规则:"
gh api "repos/$OWNER/$REPO/branches/$DEFAULT_BRANCH/protection" --jq '{
"必需状态检查": .required_status_checks.contexts,
"必需PR审批数": .required_pull_request_reviews.required_approving_review_count,
"管理员强制执行": .enforce_admins.enabled
}' 2>/dev/null || echo " (无法获取详情)"
else
log_warn "未检测到分支保护规则"
fi
# 9. 配置仓库设置
echo ""
log_info "配置仓库设置..."
# 启用自动删除合并后的分支
gh api "repos/$OWNER/$REPO" \
--method PATCH \
--field delete_branch_on_merge=true \
&> /dev/null && log_success "启用: 合并后自动删除分支" || log_warn "无法配置自动删除分支"
# 禁用 wiki（如果不需要）
gh api "repos/$OWNER/$REPO" \
--method PATCH \
--field has_wiki=false \
&> /dev/null && log_success "禁用: Wiki" || true
# 10. 完成
echo ""
echo "========================================"
echo " 配置完成!"
echo "========================================"
echo ""
echo "后续步骤:"
echo " 1. 确保 CI 工作流文件已提交 (.github/workflows/)"
echo " 2. 创建第一个 PR 验证 CI 是否正常运行"
echo " 3. 验证分支保护规则是否阻止直接 push 到 $DEFAULT_BRANCH"
echo ""
echo "验证命令:"
echo " gh pr status # 查看 PR 状态"
echo " gh run list # 查看 CI 运行记录"
echo " gh api repos/$OWNER/$REPO/branches/$DEFAULT_BRANCH/protection # 查看保护规则"
echo ""

264
tasks.md
View File

@ -1,9 +1,9 @@
# tasks.md - SmartAudit 开发任务清单 # tasks.md - 秒思智能审核平台 开发任务清单
| 文档类型 | **Development Tasks (开发任务清单)** | | 文档类型 | **Development Tasks (开发任务清单)** |
| --- | --- | | --- | --- |
| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | | **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) |
| **版本号** | V1.4 | | **版本号** | V1.7 |
| **发布日期** | 2026-02-03 | | **发布日期** | 2026-02-03 |
| **依据文档** | PRD.md, FeatureSummary.md, DevelopmentPlan.md, UIDesign.md, User_Role_Interfaces.md, AIProviderConfig.md | | **依据文档** | PRD.md, FeatureSummary.md, DevelopmentPlan.md, UIDesign.md, User_Role_Interfaces.md, AIProviderConfig.md |
| **总周期** | 11 周 (2.75 个月) | | **总周期** | 11 周 (2.75 个月) |
@ -19,6 +19,9 @@
| V1.2 | 2026-02-02 | Claude | Gemini 审阅优化：新增 API Mock、CI/CD、消息中心后端接口任务 | | V1.2 | 2026-02-02 | Claude | Gemini 审阅优化：新增 API Mock、CI/CD、消息中心后端接口任务 |
| V1.3 | 2026-02-02 | Claude | 确立 TDD 为核心开发规范 | | V1.3 | 2026-02-02 | Claude | 确立 TDD 为核心开发规范 |
| V1.4 | 2026-02-02 | Claude | 新增 AI 服务配置任务（TASK-005-D/E/F） | | 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` |
--- ---
@ -87,7 +90,7 @@
| 优先级 | 功能数量 | 说明 | | 优先级 | 功能数量 | 说明 |
| --- | --- | --- | | --- | --- | --- |
| **P0 (MVP)** | 21 | 必须实现 | | **P0 (MVP)** | 23 | 必须实现（含 F-51 品牌方终审开关、F-52 审核流程进度可视化） |
| **P1** | 22 | 首版后快速迭代（以 FeatureSummary 的 P1 清单为准） | | **P1** | 22 | 首版后快速迭代（以 FeatureSummary 的 P1 清单为准） |
| **P2** | 8 | 中长期规划 | | **P2** | 8 | 中长期规划 |
@ -149,6 +152,8 @@
| F-48 | TASK-005-E | | F-48 | TASK-005-E |
| F-49 | TASK-066 | | F-49 | TASK-066 |
| F-50 | TASK-067 | | 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 标记。 > 注：F-05 已拆分为 F-05-A/B，历史任务中仍可能出现 F-05 标记。
@ -192,6 +197,7 @@
**任务描述：** **任务描述：**
- PostgreSQL 数据库设计 - PostgreSQL 数据库设计
- 核心表创建：brands, agencies, creators, tasks, briefs, videos, reports, risk_items, rule_sets, audit_logs - 核心表创建：brands, agencies, creators, tasks, briefs, videos, reports, risk_items, rule_sets, audit_logs
- audit_logs 增加 prev_hash/hash 字段，支持 append-only + hash chain
- 配置 pgvector 扩展（向量检索） - 配置 pgvector 扩展（向量检索）
- 配置 Alembic 数据库迁移 - 配置 Alembic 数据库迁移
- 创建种子数据 - 创建种子数据
@ -202,6 +208,7 @@
- [ ] 所有核心表创建成功 - [ ] 所有核心表创建成功
- [ ] pgvector 扩展可用 - [ ] pgvector 扩展可用
- [ ] 迁移脚本可正常执行 - [ ] 迁移脚本可正常执行
- [ ] audit_logs hash chain 字段可用
--- ---
@ -296,24 +303,43 @@
--- ---
#### TASK-005-C: CI/CD 流水线配置 #### TASK-005-C: CI/CD 流水线与 GitHub 配置
| 属性 | 内容 | | 属性 | 内容 |
| --- | --- | | --- | --- |
| **负责人** | Backend | | **负责人** | Backend |
| **优先级** | P0 | | **优先级** | P0 |
| **预估工时** | 1d | | **预估工时** | 1.5d |
| **依赖** | TASK-001, TASK-006 | | **依赖** | TASK-001, TASK-006 |
| **功能编号** | 基础设施 | | **功能编号** | 基础设施 |
**任务描述：** **任务描述：**
- 配置 GitLab CI / GitHub Actions - 配置 GitHub Actions 工作流
- 实现代码提交后自动 Lint 检查 - `.github/workflows/frontend-test.yml` (Vitest + Playwright)
- `.github/workflows/backend-test.yml` (pytest)
- 实现代码提交后自动 Lint + 测试
- **配置 Codecov 覆盖率报告**（见下方步骤）
- 实现 Docker 镜像自动构建 - 实现 Docker 镜像自动构建
- 配置 Dev 环境自动部署 - 配置 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 错误阻断合并 - [ ] Lint/测试错误阻断 PR 合并
- [ ] **Codecov 覆盖率报告正常上传**（验证：https://codecov.io/gh/{owner}/{repo}）
- [ ] **分支保护规则已生效**（验证：`gh api repos/{owner}/{repo}/branches/main/protection`）
- [ ] 直接 push 到 main 被拒绝
- [ ] Dev 环境自动更新 - [ ] Dev 环境自动更新
--- ---
@ -1409,6 +1435,203 @@
--- ---
#### 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 响应式设计与无障碍 ### 4.7 响应式设计与无障碍
> 规范参考：User_Role_Interfaces.md 第 7-8 章 > 规范参考：User_Role_Interfaces.md 第 7-8 章
@ -1736,6 +1959,11 @@
**任务描述：** **任务描述：**
- 实现审核记录查询 - 实现审核记录查询
- 实现完整审核链路查看 - 实现完整审核链路查看
- 审计日志采用 append-only + hash chain（前序哈希 + 当前内容），禁止更新/删除
**验收标准：**
- [ ] 审计日志链式校验通过
- [ ] 不支持对历史审计日志的更新/删除
--- ---
@ -2074,14 +2302,18 @@ graph TD
| --- | --- | | --- | --- |
| **设计稿节点ID** | `PjBJD` | | **设计稿节点ID** | `PjBJD` |
| **优先级** | P0 | | **优先级** | P0 |
| **依赖** | TASK-007, TASK-026 | | **依赖** | TASK-007, TASK-026, TASK-073 |
| **关联任务** | TASK-026 | | **关联任务** | TASK-026, TASK-073 |
**实现要点：** **实现要点：**
- 使用 `MobileLayout` 组件 - 使用 `MobileLayout` 组件
- 任务卡片使用 `Card` 组件 - 任务卡片使用 `Card` 组件
- 状态标签使用 `Tag` 组件 - 状态标签使用 `Tag` 组件
- 底部导航：工作台/任务/审核/消息/我的 - 底部导航：工作台/任务/审核/消息/我的
- ⭐ **审核流程进度条**（F-52）：
- 任务卡片内嵌审核进度条组件 `<ReviewProgressBar />`
- 进度条节点ID：`V5Vrv`（AI审核中状态示例）、`r3pZG`（需修改状态示例）
- 状态流转：已提交 → AI审核 → 代理商审核 → [品牌终审] → 通过
--- ---
@ -2105,10 +2337,14 @@ graph TD
| --- | --- | | --- | --- |
| **设计稿节点ID** | `Vn3VU` | | **设计稿节点ID** | `Vn3VU` |
| **优先级** | P0 | | **优先级** | P0 |
| **依赖** | TASK-028 | | **依赖** | TASK-028, TASK-073 |
| **关联任务** | TASK-028 | | **关联任务** | TASK-028, TASK-073 |
**实现要点：** **实现要点：**
- ⭐ **审核流程进度卡片**（F-52）：
- 进度卡片节点ID：`GNZKG`
- 显示完整流程：已提交 → AI审核 → 代理商审核 → 最终结果
- 每个节点显示时间戳和状态
- 结果横幅（通过/警告/驳回） - 结果横幅（通过/警告/驳回）
- 视频播放器带时间戳标注 - 视频播放器带时间戳标注
- 修改清单组件 - 修改清单组件