# 设计文档矛盾与模糊点分析 (V1.2)

本文档用于记录并跟踪 `SmartAudit` 项目各设计文档之间的矛盾点与模糊点。以下条目均已对齐并给出统一结论。

---

## 1. 核心功能与技术实现

### 1.1 移动端交付形态 (已统一)
- **结论：** 统一为 **响应式 H5 / 小程序**，不开发原生 App。
- **对齐文档：** `DevelopmentPlan.md`、`User_Role_Interfaces.md`

### 1.2 Logo 检测职责边界 (已澄清)
- **结论：** 视觉模型仅用于画面语义/场景风险分析；竞品 Logo 检测由内置 CV 模型处理，不受配置影响。
- **对齐文档：** `AIProviderConfig.md`、`UIDesign.md`、`User_Role_Interfaces.md`

### 1.3 文件上传方案 (已同步)
- **结论：** 批量上传采用 **多文件拖拽并发上传 + Tus 断点续传**，弃用 ZIP。
- **对齐文档：** `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`

---

## 3. AI 功能与 UI

### 3.1 多模态模型的 UI 呈现 (已统一)
- **结论：** 模型下拉选项显示能力标签（如 `gpt-4o [文字/视觉]`），便于识别多模态模型。
- **对齐文档：** `UIDesign.md`、`User_Role_Interfaces.md`

### 3.2 多租户 AI 配置范围 (已统一)
- **结论：** F-49 提升为 **P0**；MVP 必须包含多租户 AI 配置隔离能力。
- **对齐文档：** `FeatureSummary.md`、`tasks.md`、`DevelopmentPlan.md`、`PRD.md`

---

## 4. 文档一致性

### 4.1 TDD 计划文档缺失 (已补齐)
- **结论：** 新增 `featuredoc/tdd_plan.md`，作为 `tasks.md` 中 TDD 引用的正式文档。
- **对齐文档：** `tasks.md`

### 4.2 视频采样率假设 (已同步)
- **结论：** CV 采样率默认 **2fps**，并在该采样率下验证时长统计准确性。
- **对齐文档：** `PRD.md`、`FeatureSummary.md`

---

**当前状态：** 无待决策项。