diff --git a/AIProviderConfig.md b/AIProviderConfig.md index 6d54128..1f359cb 100644 --- a/AIProviderConfig.md +++ b/AIProviderConfig.md @@ -2,9 +2,9 @@ | 文档类型 | **Technical Design (技术设计文档)** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | -| **版本号** | V2.0 | -| **日期** | 2026-02-02 | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | +| **版本号** | V2.1 | +| **日期** | 2026-02-03 | | **侧重** | AI 服务动态配置、多租户隔离、模型选择 | --- @@ -15,6 +15,7 @@ | --- | --- | --- | --- | | V1.0 | 2026-02-02 | Claude | 初稿:AI 厂商动态配置架构设计 | | V2.0 | 2026-02-02 | Claude | 重构:简化为统一提供商+三模型配置方案 | +| V2.1 | 2026-02-03 | Claude | 文档一致性修订:明确单提供商模式与可切换原则 | --- @@ -22,7 +23,7 @@ ### 1.1 业务需求 -SmartAudit 系统需要调用三类 AI 服务完成视频审核: +秒思智能审核平台 系统需要调用三类 AI 服务完成视频审核: | 服务类型 | 用途 | 示例模型 | | --- | --- | --- | @@ -35,6 +36,7 @@ SmartAudit 系统需要调用三类 AI 服务完成视频审核: | 目标 | 描述 | | --- | --- | | **灵活配置** | 品牌方可在后台自由选择 AI 提供商和模型 | +| **单一提供商** | 每租户仅保留一套提供商配置,必要时手动切换 | | **统一接入** | 支持 OneAPI/OpenRouter 中转,一套配置调用多种模型 | | **直连支持** | 也支持直连 Anthropic、OpenAI、DeepSeek 等厂商 | | **多租户隔离** | 不同品牌方使用独立的 AI 配置和配额 | @@ -693,7 +695,7 @@ def mask_api_key(api_key: str) -> str: ## 7. 界面设计 -> 详见 UIDesign.md 第 10 章「AI 服务配置界面」 +> 详见 User_Role_Interfaces.md 第 4.6 章「AI 服务配置」 ### 7.1 界面入口 diff --git a/DevelopmentPlan.md b/DevelopmentPlan.md index 0cc7f81..9fc2285 100644 --- a/DevelopmentPlan.md +++ b/DevelopmentPlan.md @@ -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 的集成**以及**移动端适配**等工程难点。 @@ -10,10 +10,10 @@ | 文档类型 | **Development Plan (技术架构与实施计划)** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | -| **版本号** | V1.5 | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | +| **版本号** | V1.6 | | **日期** | 2026-02-03 | -| **依据** | FeatureSummary V1.3, PRD V1.0, RequirementsDoc V1.0 | +| **依据** | FeatureSummary V1.4, PRD V1.0, RequirementsDoc V1.0 | | **侧重** | 技术选型、架构设计、MVP 范围、开发排期、验收标准 | --- @@ -29,6 +29,7 @@ | V1.3 | 2026-02-03 | Claude | **确立 TDD 为项目核心开发规范**,关联 tdd_plan.md | | V1.4 | 2026-02-03 | Claude | **新增 AI 厂商动态配置架构**,支持数据库配置、运行时热更新、多租户隔离 | | 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 解析、反讽识别、情感分析 | | **视觉理解 (VLM)** | **Qwen-VL / 豆包视觉** | 处理复杂场景理解(如:环境脏乱差、具体动作判定);**Brief 图片解析** | -| **语音识别 (ASR)** | **Paraformer (阿里) / SenseVoice** | 高精度中文语音转写,支持时间戳对齐 | +| **语音识别 (ASR)** | **Whisper / Paraformer / SenseVoice** | 通过 AIProviderConfig 配置音频模型,支持时间戳对齐 | | **文字识别 (OCR)** | **PaddleOCR v4** | 针对中文视频字幕优化,开源免费,轻量级 | | **版面分析 (Layout)** | **PaddleOCR Layout / LayoutLMv3** | Brief PDF 版面分析,提取图文混排结构 | | **竞品 Logo 检测** | **Grounding DINO + Vector DB** | ⭐ V1.2 修正:改为向量检索方案,见下方说明 | @@ -119,11 +120,11 @@ graph TD > > **核心特性:** > - **数据库存储配置:** AI 厂商的 API Key、Base URL 等配置存储在数据库中,而非环境变量 -> - **运行时动态加载:** 管理员可在后台配置 AI 厂商,系统运行时动态读取配置初始化客户端 -> - **多租户隔离:** 不同品牌方可配置独立的 AI 厂商和配额 +> - **运行时动态加载:** 管理员可在后台配置**单一 AI 提供商**,系统运行时动态读取配置初始化客户端 +> - **多租户隔离:** 不同品牌方可配置独立的 AI 提供商配置和配额 > - **热更新:** 配置变更即时生效,无需重启服务 -> - **故障转移:** 主厂商不可用时自动切换到备用厂商 > - **API Key 加密:** 使用 AES-256-GCM 加密存储敏感信息 +> - **可切换:** 管理员可随时更换提供商(OneAPI/OpenRouter 或直连厂商) > > **支持的厂商类型:** > - 国内厂商:DeepSeek、通义千问、豆包、智谱、Moonshot @@ -252,11 +253,11 @@ sequenceDiagram ## 3. MVP (P0) 开发范围定义 -基于 `FeatureSummary.md V1.3`,MVP 阶段必须包含的功能: +基于 `FeatureSummary.md V1.4`,MVP 阶段必须包含的功能: ### ✅ 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 | | `risk_items` | 风险项 | id, report_id, type, level, timestamp_start, timestamp_end, evidence_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) -引用自 `FeatureSummary.md V1.3` 第 9 章,MVP 上线前必须满足: +引用自 `FeatureSummary.md V1.4` 第 9 章,MVP 上线前必须满足: | 验收项 | 标准 | 测量方式 | 责任方 | | --- | --- | --- | --- | @@ -518,6 +521,6 @@ sequenceDiagram | User_Role_Interfaces.md | 界面规范 | | tasks.md | 开发任务清单 | | **featuredoc/tdd_plan.md** | **TDD 实施计划(核心规范)** | -| **AIProviderConfig.md** | **AI 厂商动态配置架构设计(V2.0)** | +| **AIProviderConfig.md** | **AI 厂商动态配置架构设计(V2.1)** | | 数据字典 | 待编写 | | API 接口规范 | 待编写 | diff --git a/DocumentContradictions.md b/DocumentContradictions.md index eb2e8b1..f51d169 100644 --- a/DocumentContradictions.md +++ b/DocumentContradictions.md @@ -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` ### 1.2 Logo 检测职责边界 (已澄清) -- **结论:** 视觉模型仅用于画面语义/场景风险分析;竞品 Logo 检测由内置 CV 模型处理,不受配置影响。 -- **对齐文档:** `AIProviderConfig.md`、`UIDesign.md`、`User_Role_Interfaces.md` +- **结论:** 视觉模型仅用于画面语义/场景风险分析;竞品 Logo 检测由内置 CV 模型(Grounding DINO + Vector DB)处理,不受配置影响。 +- **对齐文档:** `AIProviderConfig.md`、`UIDesign.md`、`User_Role_Interfaces.md`、`DevelopmentPlan.md` ### 1.3 文件上传方案 (已同步) - **结论:** 批量上传采用 **多文件拖拽并发上传 + Tus 断点续传**,弃用 ZIP。 - **对齐文档:** `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.1 强制通过与特例关系 (已统一) -- **结论:** “强制通过”弹窗内提供 **保存为特例** 勾选项(默认不勾选);勾选后生成豁免条款并等待品牌方确认生效。 +- **结论:** "强制通过"弹窗内提供 **保存为特例** 勾选项(默认不勾选);勾选后生成豁免条款并等待品牌方确认生效。 - **对齐文档:** `PRD.md`、`UIDesign.md`、`User_Role_Interfaces.md` ### 2.2 强制通过禁用后的流程 (已统一) -- **结论:** 品牌方关闭授权后,代理商端按钮文案变为“申请强制通过”,填写理由并提交品牌方审批。 +- **结论:** 品牌方关闭授权后,代理商端按钮文案变为"申请强制通过",填写理由并提交品牌方审批。 - **对齐文档:** `PRD.md`、`UIDesign.md`、`User_Role_Interfaces.md` ### 2.3 AI 配置可见性 (已统一) - **结论:** 代理商/达人 **不可见** AI 配置,仅品牌方管理员可查看与修改。 -- **对齐文档:** `UIDesign.md`、`User_Role_Interfaces.md` +- **对齐文档:** `UIDesign.md`、`User_Role_Interfaces.md`、`AIProviderConfig.md` --- @@ -50,14 +57,124 @@ ## 4. 文档一致性 -### 4.1 TDD 计划文档缺失 (已补齐) +### 4.1 TDD 计划文档 (已补齐) - **结论:** 新增 `featuredoc/tdd_plan.md`,作为 `tasks.md` 中 TDD 引用的正式文档。 -- **对齐文档:** `tasks.md` +- **对齐文档:** `tasks.md`、`DevelopmentPlan.md` ### 4.2 视频采样率假设 (已同步) - **结论:** 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设计 | diff --git a/FeatureSummary.md b/FeatureSummary.md index 9b297e9..917dcea 100644 --- a/FeatureSummary.md +++ b/FeatureSummary.md @@ -2,8 +2,8 @@ | 文档类型 | **Feature Summary (产品功能文档)** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | -| **版本号** | V1.3 | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | +| **版本号** | V1.6 | | **发布日期** | 2026-02-03 | | **关联文档** | RequirementsDoc.md, PRD.md, User_Role_Interfaces.md | | **侧重** | 功能清单、优先级、验收标准、界面映射、边界说明 | @@ -18,6 +18,9 @@ | V1.1 | 2026-02-02 | Claude | 根据 Gemini 修订意见调整:补充验收标准、Out of Scope、核心痛点细化 | | V1.2 | 2026-02-02 | Claude | 根据 Gemini 关键改进意见:优先级调整、功能拆分、新增功能、移动端适配 | | 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 修订意见采纳情况:** @@ -37,7 +40,7 @@ ### 1.1 产品定位 -SmartAudit 是一款**基于多模态大模型的 B2B SaaS 审核工具**,定位为**"智能预审员"**,在人工介入前**自动化拦截 80% 的基础错误和合规风险**,将审核流转周期从"天"缩短到"小时"。 +秒思智能审核平台 是一款**基于多模态大模型的 B2B SaaS 审核工具**,定位为**"智能预审员"**,在人工介入前**自动化拦截 80% 的基础错误和合规风险**,将审核流转周期从"天"缩短到"小时"。 ### 1.2 核心价值 @@ -64,7 +67,7 @@ SmartAudit 是一款**基于多模态大模型的 B2B SaaS 审核工具**,定 ``` ┌─────────────────────────────────────────────────────────────────┐ -│ SmartAudit 功能架构 │ +│ 秒思智能审核平台 功能架构 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ @@ -372,6 +375,7 @@ SmartAudit 是一款**基于多模态大模型的 B2B SaaS 审核工具**,定 | --- | --- | --- | --- | --- | | F-19 | 风险列表展示 | P0 | US-08 | 代理商 | | F-20 | 确认/驳回操作 | P0 | US-08 | 代理商 | +| F-51 | 品牌方终审开关 | **P0** | - | 品牌方 | | F-21 | 强制通过权 | P1 | US-09 | 品牌方(默认授权代理商) | | F-22 | 特例记录与白名单 | P1 | US-09 | 品牌方 | | 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 强制通过权 **功能描述:** 品牌方可手动放行过于保守的误报(如达人玩的新梗)。**默认授权代理商独立使用强制通过功能**;品牌方可在设置中**按代理商**关闭授权,关闭后代理商需发起审批流程。 @@ -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 -**功能描述:** 品牌方管理员可在后台配置多个 AI 厂商(DeepSeek、OpenAI、通义千问、OneAPI 中转等),配置存储在数据库中,运行时动态加载,无需修改代码或重启服务。 +**功能描述:** 品牌方管理员可在后台配置**单一 AI 提供商**(OneAPI/OpenRouter 中转或直连厂商),配置存储在数据库中,运行时动态加载,无需修改代码或重启服务。每个租户仅保留一套配置,可随时切换提供商。 **核心功能:** -- 支持添加、编辑、删除 AI 厂商配置 +- 支持配置与更新 AI 提供商 - 配置 Base URL、API Key(AES-256-GCM 加密存储)、默认模型 -- 为不同使用场景(Brief 解析、脚本预审、视频审核)指定不同厂商 -- 配置优先级和备用厂商(故障转移) +- 为不同使用场景(Brief 解析、脚本预审、视频审核)指定不同模型 +- 可通过 OneAPI/OpenRouter 聚合多模型 - 未配置时阻断调用并提示品牌方完成配置 **为什么是 P0:** 这是 AI 服务的基础设施,所有 AI 功能都依赖此配置。 @@ -744,7 +831,7 @@ V1 版本指出 3 个违规点:✅ 已修复 2 个 | ❌ 未修复 1 个 #### F-49 多租户 AI 配置隔离 -**功能描述:** 不同品牌方可配置独立的 AI 厂商,实现租户级别的配置隔离和配额管理。 +**功能描述:** 不同品牌方可配置独立的 AI 提供商,实现租户级别的配置隔离和配额管理。 **界面映射:** 品牌方后台 → 系统设置 → AI 配置 @@ -799,6 +886,8 @@ V1 版本指出 3 个违规点:✅ 已修复 2 个 | ❌ 未修复 1 个 | F-17 | 审核进度实时展示 | 视频审核 | ⭐ P1→P0,缓解等待焦虑 | | F-19 | 风险列表展示 | 审核台 | | | F-20 | 确认/驳回操作 | 审核台 | | +| F-51 | 品牌方终审开关 | 审核台 | ⭐ 新增,审核流程可配置 | +| F-52 | 审核流程进度可视化 | 达人端 | ⭐ 新增,达人可见审核状态 | | F-33 | 核心指标卡片 | 数据看板 | | | F-47 | AI 厂商动态配置 | 系统管理 | ⭐ V1.3 新增,AI 基础设施 | | F-48 | AI 厂商连通性测试 | 系统管理 | ⭐ V1.3 新增 | @@ -868,7 +957,7 @@ V1 版本指出 3 个违规点:✅ 已修复 2 个 | ❌ 未修复 1 个 | **安全** | 传输与存储加密(AES-256-GCM);基于角色权限控制;关键操作二次确认 | | **隐私** | 数据最小化;默认保留 30 天;符合《个保法》与 GDPR | | **数据本地化** | 国内客户数据存储于中国大陆境内服务器 | -| **审计** | 操作日志可审计且不可篡改 | +| **审计** | 操作日志可审计且不可篡改(append-only + hash chain) | | **移动端适配** | **达人端(上传/查看报告)必须适配移动端 H5 竖屏操作** | > ⚠️ **移动端适配说明:** 达人的工作场景多在拍摄现场(移动端),需要在手机上完成脚本上传、查看审核结果等操作。如果只做 PC 网页版,达人无法在拍摄现场即时使用,产品价值会大打折扣。 @@ -925,7 +1014,7 @@ V1 版本指出 3 个违规点:✅ 已修复 2 个 | ❌ 未修复 1 个 | RequirementsDoc.md | 业务需求文档(用户故事、成功指标) | | PRD.md | 产品需求文档(功能需求、技术架构) | | User_Role_Interfaces.md | 用户角色与界面规范 | -| **AIProviderConfig.md** | **AI 厂商动态配置架构设计(V2.0)** | +| **AIProviderConfig.md** | **AI 厂商动态配置架构设计(V2.1)** | | 技术设计文档 (TDD) | 待编写 | | API 接口规范 | 待编写 | | 数据字典 | 待编写 | diff --git a/PRD.md b/PRD.md index 069e9ba..1ce7824 100644 --- a/PRD.md +++ b/PRD.md @@ -2,7 +2,7 @@ | 文档类型 | **PRD (Product Requirement Document)** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | | **版本号** | V1.0 | | **发布日期** | 2026-02-03 | | **状态** | 草稿 (Draft) | @@ -102,11 +102,12 @@ - 视频自动审核(竞品、违禁词、画面风险) → [US-05] - 审核台风险打点与确认/驳回 → [US-08] - 语境理解降低误报 → [US-04] -- 审核进度展示与时间戳修改清单 → [US-07] +- 审核进度展示(F-17) → [US-07] - 基础黑白名单与竞品库(F-05-A) → [US-10A] - 时长与频次校验(F-45) → [US-05] - AI 服务配置与连通性测试(F-47/F-48) - 多租户 AI 配置隔离(F-49) +- 数据看板核心指标卡片(F-33) **P1(首版发布后快速迭代)** - Brand Safety 软性风险提示 → [US-06] @@ -134,6 +135,7 @@ - **规则库管理与版本控制:** 支持平台规则库更新、品牌私有规则与白名单配置 - **权限与多租户隔离:** 支持品牌/代理/达人不同角色的权限与数据隔离 - **审计日志与报告导出:** 支持导出可追溯的审核证据链 +- **数据看板与核心指标:** 提供核心指标卡片与基础数据概览 ### 5.2 Out of Scope @@ -218,15 +220,21 @@ **P0** - 审核台展示风险列表(红/黄/绿分级)与时间戳 - 支持确认/驳回操作,无需从头看视频 +- **可配置审核流程(F-51)**:品牌方可开启/关闭终审环节 + - **终审关闭(默认)**:代理商初审通过 → 最终通过 + - **终审开启**:代理商初审通过 → 品牌方终审 → 最终通过/驳回 + - 支持配置终审范围(全部/仅舆情风险/指定代理商) + - 支持配置终审超时处理(默认48小时) **P1** -- 品牌方"强制通过权":可手动放行过于保守的误报(需记录原因与审批人);**默认授权代理商独立使用,可在品牌方设置中按代理商关闭,关闭后需走审批流程**。强制通过弹窗需填写原因,并提供“保存为特例”可选项(**默认不勾选**,勾选后形成豁免条款,需品牌方确认生效) +- 品牌方"强制通过权":可手动放行过于保守的误报(需记录原因与审批人);**默认授权代理商独立使用,可在品牌方设置中按代理商关闭,关闭后需走审批流程**。强制通过弹窗需填写原因,并提供"保存为特例"可选项(**默认不勾选**,勾选后形成豁免条款,需品牌方确认生效) - 特例可沉淀为规则白名单/豁免条款(含来源:强制通过勾选或手动记录) - 如需用于模型优化,必须确保数据授权与合规评估 - 可查看规则依据与证据片段 **验收要点** - 每条结论包含规则版本、模型版本、证据截图/片段与时间戳 +- 终审开启时,代理商通过后任务状态变为「待终审」,品牌方操作后变为「已通过」或「待修改」 ### 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.1 品牌方工作流 @@ -326,6 +350,7 @@ - 全流程日志可追溯、不可篡改 - 导出报告包含规则版本、模型版本、证据截图/片段与时间戳 - 支持争议场景下完整审核证据链导出 +- 审计日志采用 append-only + hash chain(前序哈希 + 当前内容)确保可追溯 --- @@ -394,13 +419,13 @@ - **ASR/OCR**:支持普通话及主流方言的语音识别,支持复杂背景字幕识别 - **计算机视觉**:Logo 检测、物体识别、场景分类 - **消息队列**:异步处理视频审核任务,支持优先级调度 -- **AI 厂商动态配置**:品牌方管理员可在后台配置多个 AI 厂商(DeepSeek/OpenAI/OneAPI 等),运行时动态加载,支持多租户隔离和故障转移(详见 AIProviderConfig.md) +- **AI 厂商动态配置**:品牌方管理员可在后台配置**单一 AI 提供商**(可为 OneAPI/OpenRouter 中转或直连厂商),运行时动态加载,支持多租户隔离;配置变更可随时切换(详见 AIProviderConfig.md) --- ## 14. 里程碑与发布计划 (Milestones) -- **MVP (P0)**:Brief 解析、规则加载、脚本预审、视频审核、审核台、语境理解降低误报、审核进度展示、基础黑白名单与竞品库、时长与频次校验、AI 服务商配置 +- **MVP (P0)**:Brief 解析、规则加载、脚本预审、视频审核、审核台、语境理解降低误报、审核进度展示、基础黑白名单与竞品库、时长与频次校验、AI 服务商配置、核心指标卡片 - **V1.1 (P1)**:Brand Safety 提示、规则版本、证据链导出、强制通过权、高级豁免规则 - **V2 (P2)**:批量处理、版本差异报告 diff --git a/RequirementsDoc.md b/RequirementsDoc.md index bc93185..68aff99 100644 --- a/RequirementsDoc.md +++ b/RequirementsDoc.md @@ -2,7 +2,7 @@ | 文档类型 | **RD (Requirements Document)** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | | **版本号** | V1.0 | | **发布日期** | 2026-02-03 | | **状态** | **修订 (Revised)** | @@ -135,6 +135,7 @@ 7. **规则库管理与版本控制:** 支持平台规则库更新、品牌私有规则与白名单配置。 8. **权限与多租户隔离:** 支持品牌/代理/达人不同角色的权限与数据隔离。 9. **审计日志与报告导出:** 支持导出可追溯的审核证据链。 +10. **数据看板与核心指标:** 提供核心指标卡片与基础数据概览。 ### ❌ Out of Scope (本期不做) @@ -188,7 +189,7 @@ * **ASR/OCR:** 支持普通话及主流方言的语音识别,支持复杂背景字幕识别 * **计算机视觉:** Logo 检测、物体识别、场景分类 * **消息队列:** 异步处理视频审核任务,支持优先级调度 -* **AI 厂商动态配置:** 支持在数据库中配置多个 AI 厂商(DeepSeek/OpenAI/OneAPI 等),运行时动态加载,支持多租户隔离和故障转移(详见 AIProviderConfig.md) +* **AI 厂商动态配置:** 支持在数据库中配置**单一 AI 提供商**(可为 OneAPI/OpenRouter 中转或直连厂商),运行时动态加载,支持多租户隔离;配置变更可随时切换(详见 AIProviderConfig.md) --- @@ -213,6 +214,7 @@ * **性能:** ≤ 100MB 视频上传后,AI 预审报告产出时间不超过 5 分钟(含排队 ≤ 2 分钟)。 * **审计链路:** 每条结论包含规则版本、模型版本、证据截图/片段与时间戳。 * **F-45 时长与频次统计:** 时长统计误差 ≤ 1秒;频次统计准确率 ≥ 95%。 +* **审计日志不可篡改:** 采用 append-only + hash chain(前序哈希 + 当前内容)校验可追溯。 --- diff --git a/UIDesign.md b/UIDesign.md index c11c9de..fa2381c 100644 --- a/UIDesign.md +++ b/UIDesign.md @@ -1,12 +1,23 @@ # UIDesign.md - 智能视频审核系统 UI 设计规范 +> ⚠️ **重要说明 (2026-02-03)** +> +> 本文档为**早期设计参考文档**,设计风格为浅色系。 +> +> **当前正式设计规范请参考:[UIDesignSpec.md](./UIDesignSpec.md)** +> - 设计稿文件:`pencil-new.pen` +> - 设计风格:Apple-style **暗色主题** +> - 包含最新的设计令牌、组件规范和页面清单 +> +> 本文档仅保留用于历史参考和设计原则说明。开发时以 `UIDesignSpec.md` 为准。 + | 文档类型 | **UI Design System (设计系统规范)** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | | **版本号** | V1.1 | | **发布日期** | 2026-02-03 | -| **设计风格** | Apple Human Interface Guidelines 浅色系 | -| **关联文档** | PRD.md, FeatureSummary.md, User_Role_Interfaces.md, DevelopmentPlan.md | +| **设计风格** | ~~Apple Human Interface Guidelines 浅色系~~ → 已更新为暗色主题,见 UIDesignSpec.md | +| **关联文档** | PRD.md, FeatureSummary.md, User_Role_Interfaces.md, DevelopmentPlan.md, **UIDesignSpec.md** | --- @@ -16,22 +27,23 @@ | --- | --- | --- | --- | | V1.0 | 2026-02-02 | Claude | 初稿:设计原则、色彩系统、组件库、三端界面规范 | | V1.1 | 2026-02-02 | Claude | 新增第10章:AI 服务配置界面设计规范 | +| V1.2 | 2026-02-03 | Claude | 添加废弃声明,指向 UIDesignSpec.md(暗色主题) | --- ## 1. 设计原则 (Design Principles) -借鉴 Apple Human Interface Guidelines,SmartAudit 的设计遵循以下核心原则: +借鉴 Apple Human Interface Guidelines,秒思智能审核平台 的设计遵循以下核心原则: ### 1.1 核心设计理念 -| 原则 | 描述 | 在 SmartAudit 中的体现 | +| 原则 | 描述 | 在 秒思智能审核平台 中的体现 | | --- | --- | --- | | **Clarity (清晰)** | 文字清晰易读,图标精确传意,功能显而易见 | 审核结论用红/黄/绿 + 文字 + 图标三重表达 | | **Deference (克制)** | UI 退居幕后,内容为王 | 审核台以视频和报告为核心,界面元素轻量化 | | **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 配置中心 │ @@ -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 服务配置 │ diff --git a/UIDesignSpec.md b/UIDesignSpec.md index cc206ab..d2f980a 100644 --- a/UIDesignSpec.md +++ b/UIDesignSpec.md @@ -2,7 +2,7 @@ | 文档类型 | **UI Design Specification** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | | **版本号** | V1.0 | | **发布日期** | 2026-02-03 | | **设计稿文件** | `pencil-new.pen` | diff --git a/User_Role_Interfaces.md b/User_Role_Interfaces.md index 08b070b..07ea3a2 100644 --- a/User_Role_Interfaces.md +++ b/User_Role_Interfaces.md @@ -2,8 +2,8 @@ | 文档类型 | **UI/UX Spec (Interface Definitions)** | | --- | --- | -| **项目名称** | SmartAudit (AI 营销内容合规审核平台) | -| **版本号** | V1.3 | +| **项目名称** | 秒思智能审核平台 (AI 营销内容合规审核平台) | +| **版本号** | V1.5 | | **发布日期** | 2026-02-03 | | **关联文档** | 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.2 | 2026-02-02 | Claude | 新增代理商端和品牌方端移动端 UI 设计(工作台、快捷审核、预警、审批) | | 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 | ✅ 全局规则配置 | | **脚本/视频提交** | ✅ 上传 & 修改 [US-03] | ❌ 不可提交 | ❌ 不可提交 | | **查看 AI 报告** | ✅ 仅查看自己的 [US-07] | ✅ 查看所管辖达人的 | ✅ 查看所有 | -| **审核决策** | ❌ 无权 | ✅ 初审 (驳回/通过) [US-08] | ✅ 终审 / 强制通过 [US-09] | +| **审核决策** | ❌ 无权 | ✅ 初审 (驳回/通过) [US-08] | ✅ 终审(可配置)/ 强制通过 [US-09] | | **申诉功能** | ✅ 发起申诉 (消耗令牌) | ✅ 仲裁申诉 | ❌ 无需申诉 | | **证据链导出** | ❌ 无权 | ✅ 导出所管辖任务 | ✅ 导出全部 [US-12] | | **数据看板** | 仅看个人任务进度 | 整体进度 / 达人排名 | 全局合规率 / 舆情风控 | -| **系统配置** | ❌ 无权 | ❌ 无权 | ✅ 规则库/阈值/白名单/区域合规 [US-10A/US-10B] | +| **系统配置** | ❌ 无权 | ❌ 无权 | ✅ 规则库/阈值/白名单/区域合规/审核流程 [US-10A/US-10B] | | **AI 服务配置** | ❌ 无权 | ❌ 无权(继承品牌方配置) | ✅ 配置 AI 提供商/模型/参数 | | **用户管理** | ❌ 无权 | ✅ 管理所属达人 | ✅ 管理代理商与达人 | +> **审核流程说明:** 品牌方可在系统设置中配置是否开启终审环节。**默认关闭**,代理商初审通过即为最终通过;开启后,代理商初审通过的内容需进入品牌方终审队列。 + --- ## 1.1 各端导航结构 (Navigation Structure) @@ -108,13 +112,52 @@ ## 2. 界面详解:达人端 (The Creator Portal) **设计目标:** 极简、透明、减少焦虑。让达人像发朋友圈一样简单地完成合规检查。 -**核心设备:** 手机浏览器 (Mobile Web) / 小程序。 +**核心设备:** 手机浏览器 (H5) / 小程序。 ### 2.1 任务列表页 (Task List) * **状态概览:** 卡片式布局,显示当前任务状态(待提交、AI审核中、需修改、已通过)。 * **行动号召 (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] 这是达人等待 AI 结果的页面,必须缓解等待焦虑(Wait-time Anxiety)。 @@ -136,7 +179,38 @@ ### 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):** 存在硬性违规,必须修改。 @@ -231,6 +305,31 @@ **布局结构:** +#### 3.3.1 审核流程进度条 ⭐ F-52 + +**页面顶部显示当前任务的审核流程进度:** + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ 审核决策台 返回列表 ← │ +├─────────────────────────────────────────────────────────────────┤ +│ ┌────────────────────────────────────────────────────────────┐ │ +│ │ 审核流程 当前:代理商审核 │ │ +│ │ │ │ +│ │ ✅已提交 ────▶ ✅AI审核 ────▶ ●代理商审核 ────▶ ○品牌终审 │ │ +│ │ ↑当前阶段 │ │ +│ └────────────────────────────────────────────────────────────┘ │ +│ │ +│ [视频播放器区域] [AI检查单区域] │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**进度条显示规则:** +- 当前阶段:紫色高亮,大圆点 +- 已完成阶段:绿色 ✅,显示完成时间 +- 待处理阶段:灰色空心圆 +- 品牌终审步骤:仅当品牌方开启终审时显示 + * **左侧:视频播放器** * **智能进度条:** 进度条上打满 colored dots * 🔴 红点:硬伤(点击跳转) @@ -250,11 +349,13 @@ * **底部:决策栏 (Action Bar)** * `[ 驳回 ]`:点击后,自动将勾选的问题打包发送给达人 - * `[ 强制通过 ]` [US-09]:强制通过(默认可用;品牌方关闭授权时按钮改为“申请强制通过”,提交后进入审批) + * `[ 强制通过 ]` [US-09]:强制通过(默认可用;品牌方关闭授权时按钮改为"申请强制通过",提交后进入审批) * **必须填写放行原因**(如"达人玩的新梗,品牌方认可") - * 弹窗提供“**保存为特例**”可选项(**默认不勾选**,勾选后形成豁免条款,需品牌方确认后生效) + * 弹窗提供"**保存为特例**"可选项(**默认不勾选**,勾选后形成豁免条款,需品牌方确认后生效) * **记录审批人**与操作时间,纳入审计日志 - * `[ 通过 ]`:流程结束 + * `[ 通过 ]`: + * 若品牌方**未开启终审**(默认)→ 流程结束,任务状态「已通过」 + * 若品牌方**已开启终审** → 进入品牌方终审队列,任务状态「待终审」 @@ -360,6 +461,10 @@ │ ← 返回 快捷审核 ⋮ 更多 │ ├─────────────────────────────────────────────┤ │ ┌─────────────────────────────────────┐ │ +│ │ 审核流程 代理商审核中 │ │ +│ │ ✅提交 ─▶ ✅AI ─▶ ●代理商 ─▶ ○终审 │ │ +│ └─────────────────────────────────────┘ │ +│ ┌─────────────────────────────────────┐ │ │ │ │ │ │ │ 📹 视频播放器 │ │ │ │ (支持横屏全屏) │ │ @@ -524,7 +629,101 @@ * **模型版本号:** 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 标记为"舆情风险"的视频列表 @@ -537,7 +736,7 @@ * **预警规则:** * 配置自动通知规则(如:高风险视频自动 @品牌方) -### 4.6 AI 服务配置 (AI Configuration) 🤖 +### 4.7 AI 服务配置 (AI Configuration) 🤖 **入口位置:** 系统设置 → AI 服务配置 **权限控制:** 仅品牌方管理员可配置,代理商和达人自动继承品牌方配置 @@ -721,15 +920,26 @@ #### 4.7.3 移动端审批中心 (Approval Center) -**场景:** 当品牌方关闭授权时,代理商申请"强制通过",品牌方需审批。 +**场景:** +1. 当品牌方关闭授权时,代理商申请"强制通过",品牌方需审批 +2. **当开启品牌终审时,代理商初审通过的视频进入品牌方终审队列** ⭐ F-52 ``` ┌─────────────────────────────────────────────┐ -│ ✅ 待审批 筛选 ▼ │ +│ 审批中心 待审批 │ 已处理 │ ├─────────────────────────────────────────────┤ -│ 待处理 (3) │ │ ┌─────────────────────────────────────┐ │ -│ │ 🟡 强制通过申请 │ │ +│ │ 🟣 视频终审申请 30分钟前│ │ +│ │ 达人「小美」的视频「春季护肤新品 │ │ +│ │ 体验」已通过代理商审核,等待终审 │ │ +│ │ │ │ +│ │ 审核流程进度: │ │ +│ │ ✅提交 ─▶ ✅AI ─▶ ✅代理商 ─▶ ●终审│ │ +│ │ │ │ +│ │ [ 拒绝 ] [ 通过 ] │ │ +│ └─────────────────────────────────────┘ │ +│ ┌─────────────────────────────────────┐ │ +│ │ 🟡 强制通过申请 10分钟前│ │ │ │ 达人:@小美美 │ │ │ │ 申请人:代理商A - 张三 │ │ │ │ 原因:达人玩的新梗,品牌方认可 │ │ @@ -740,18 +950,30 @@ │ │ │ │ │ │ [ 拒绝 ] [ 批准 ] │ │ │ └─────────────────────────────────────┘ │ -├─────────────────────────────────────────────┤ -│ 已处理 (12) [查看 >] │ +│ ┌─────────────────────────────────────┐ │ +│ │ 🟡 规则配置变更 2小时前 │ │ +│ │ 代理商「星耀传媒」申请修改审核规则│ │ +│ │ 竞品露出阈值调整为70% │ │ +│ │ │ │ +│ │ [ 拒绝 ] [ 通过 ] │ │ +│ └─────────────────────────────────────┘ │ ├─────────────────────────────────────────────┤ │ 📊 🔔 ✅ 📋 👤 │ └─────────────────────────────────────────────┘ ``` +**视频终审审批项说明:** ⭐ F-52 +* 仅当品牌方开启"终审开关"时显示此类审批项 +* 显示完整审核流程进度条,品牌终审阶段高亮 +* 点击可查看视频详情和代理商初审意见 +* 通过/拒绝后自动通知代理商和达人 + **交互说明:** * 点击视频片段可预览关键时间点 * 批准/拒绝需二次确认 * 批准后自动通知代理商和达人 * 审批记录同步至审计日志 +* **进度条交互:** 点击已完成节点可查看该阶段详情(处理人、时间、结果) #### 4.7.4 移动端审计日志 (Audit Quick View) diff --git a/ai-config-demo.html b/ai-config-demo.html index 3fafc0e..49f3c8e 100644 --- a/ai-config-demo.html +++ b/ai-config-demo.html @@ -3,7 +3,7 @@
-