25 Commits

Author SHA1 Message Date
Your Name
83737090bf docs: 新增 AI 厂商动态配置架构设计
- 新增 AIProviderConfig.md:详细设计 AI 厂商动态配置系统
  - 数据库存储配置(而非环境变量)
  - 运行时动态加载,支持热更新
  - 多租户隔离,支持品牌方独立配置
  - API Key 加密存储
  - 故障转移机制

- 更新 DevelopmentPlan.md (V1.4):
  - 在 AI 模型选型章节添加动态配置说明
  - 添加 AIProviderConfig.md 到相关文档

- 更新 FeatureSummary.md (V1.3):
  - 新增系统管理模块 (F-47~F-50)
  - F-47: AI 厂商动态配置 (P0)
  - F-48: AI 厂商连通性测试 (P0)
  - F-49: 多租户 AI 配置隔离 (P1)
  - F-50: API Key 轮换管理 (P1)

- 更新 RequirementsDoc.md 和 PRD.md:
  - 在技术架构概述中添加 AI 配置管理说明

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 18:31:29 +08:00
Your Name
f87ae48ad5 feat: 实现 FastAPI REST API 端点和集成测试
- 添加认证 API (登录/token验证)
- 添加 Brief API (上传/解析/导入/冲突检测)
- 添加视频 API (上传/断点续传/审核/违规/预览/重提交)
- 添加审核 API (决策/批量审核/申诉/历史)
- 实现基于角色的权限控制
- 更新集成测试,49 个测试全部通过
- 总体测试覆盖率 89.63%

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 18:08:12 +08:00
Your Name
8c297ff640 feat: 实现 AI 服务模块 (ASR/OCR/Logo检测)
新增 AI 服务模块,全部测试通过 (215 passed, 92.41% coverage):

- asr.py: 语音识别服务
  - 支持中文普通话/方言/中英混合
  - 时间戳精度 ≤ 100ms
  - WER 字错率计算

- ocr.py: 文字识别服务
  - 支持复杂背景下的中文识别
  - 水印检测
  - 批量帧处理

- logo_detector.py: 竞品 Logo 检测
  - F1 ≥ 0.85 (含 30% 遮挡场景)
  - 新 Logo 即刻生效
  - 跨帧跟踪

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 17:48:28 +08:00
Your Name
e77af7f8f0 feat: 实现 TDD 绿色阶段核心模块
实现以下模块并通过全部测试 (150 passed, 92.65% coverage):

- validators.py: 数据验证器 (Brief/视频/审核决策/申诉/时间戳/UUID)
- timestamp_align.py: 多模态时间戳对齐 (ASR/OCR/CV 融合)
- rule_engine.py: 规则引擎 (违禁词检测/语境感知/规则版本管理)
- brief_parser.py: Brief 解析 (卖点/禁忌词/时序要求/品牌调性提取)
- video_auditor.py: 视频审核 (文件验证/ASR/OCR/Logo检测/合规检查)

验收标准达成:
- 违禁词召回率 ≥ 95%
- 误报率 ≤ 5%
- 时长统计误差 ≤ 0.5秒
- 语境感知检测 ("最开心的一天" 不误判)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 17:41:37 +08:00
Your Name
f4f24eb46d chore: 添加测试依赖配置和 gitignore
- 添加 frontend/package.json 包含 Vitest 测试依赖
- 添加 backend/.gitignore 排除 __pycache__, .coverage 等
- 添加 frontend/.gitignore 排除 node_modules, dist 等

测试运行验证:
- 后端: 268 tests skipped (TDD 红灯阶段)
- 前端: 95 tests skipped (TDD 红灯阶段)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 17:28:05 +08:00
Your Name
040aada160 feat: 添加全面的 TDD 测试套件框架
基于项目需求文档(PRD.md, FeatureSummary.md, DevelopmentPlan.md,
UIDesign.md, User_Role_Interfaces.md)编写的 TDD 测试用例。

后端测试 (Python/pytest):
- 单元测试: rule_engine, brief_parser, timestamp_alignment,
  video_auditor, validators
- 集成测试: API Brief, Video, Review 端点
- AI 模块测试: ASR, OCR, Logo 检测服务
- 全局 fixtures 和 pytest 配置

前端测试 (TypeScript/Vitest):
- 工具函数测试: utils.test.ts
- 组件测试: Button, VideoPlayer, ViolationList
- Hooks 测试: useVideoAudit, useVideoPlayer, useAppeal
- MSW mock handlers 配置

E2E 测试 (Playwright):
- 认证流程测试
- 视频上传流程测试
- 视频审核流程测试
- 申诉流程测试

所有测试当前使用 pytest.skip() / it.skip() 作为占位符,
遵循 TDD 红灯阶段 - 等待实现代码后运行。

验收标准覆盖:
- ASR WER ≤ 10%
- OCR 准确率 ≥ 95%
- Logo F1 ≥ 0.85
- 时间戳误差 ≤ 0.5s
- 频次统计准确率 ≥ 95%

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 17:22:24 +08:00
Your Name
18fe22ce8a 确立 TDD 为项目核心开发规范
DevelopmentPlan.md (V1.3):
- 第9章测试策略新增 9.0 TDD 开发规范
- 声明 TDD 红-绿-重构循环为强制流程
- 定义各模块覆盖率要求(后端≥80%,前端≥70%)
- 相关文档新增 tdd_plan.md 引用

tasks.md (V1.3):
- 新增第0章"开发规范:TDD"
- 定义每个任务类型的 TDD 要求
- 定义任务完成标准(DoD)含测试要求

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 17:02:20 +08:00
Your Name
9cdb99505c 新增 TDD 实施评估与计划文档
featuredoc/tdd_plan.md (V1.0):
- 项目现状诊断:零代码起步,高度适合TDD
- 测试金字塔架构:单元75% + 集成20% + E2E 5%
- 后端测试策略:pytest + TestContainers + 表格驱动测试
- 前端测试策略:Vitest + Testing Library + MSW + Playwright
- AI模型测试策略:标注集验证 + 阈值门禁 + 回归测试
- 11周实施路线图
- 覆盖率目标:后端80%、前端70%、AI模块70%
- 工具链配置与CI/CD集成
- 团队规范与培训计划

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 16:58:00 +08:00
Your Name
7cc1dd178d 根据 Gemini 审阅优化 tasks.md (V1.2)
新增 3 个关键工程任务:
- TASK-005-B: API Mock 与文档定义 (解决前后端并行开发瓶颈)
- TASK-005-C: CI/CD 流水线配置 (自动化构建部署)
- TASK-030-B: 消息中心后端接口 (补全后端 API)

improve.md: Gemini 审阅建议文档

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 16:41:28 +08:00
Your Name
915a13fd0e 新增开发任务清单与UI设计规范文档
tasks.md (V1.1):
- 基于 PRD/FeatureSummary/DevelopmentPlan/UIDesign/User_Role_Interfaces 拆解 74 个开发任务
- Phase 1-4 共 11 周开发周期
- 包含代理商/品牌方移动端开发任务 (TASK-037A~I)
- 包含响应式设计与无障碍设计任务 (TASK-037J~L)
- 包含任务依赖关系图与验收标准汇总

UIDesign.md:
- UI 设计规范文档 (Apple HIG 风格)
- 色彩系统、组件规范、三端界面设计

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 16:26:48 +08:00
Your Name
b0a661069f 新增代理商端和品牌方端移动端 UI 设计
代理商移动端 (3.8节):
- 移动端工作台:待审核/待仲裁/今日通过统计
- 快捷审核:外出场景下的紧急视频审核处理
- 任务列表:卡片式任务展示与筛选
- 消息中心:通知类型与快捷操作

品牌方移动端 (4.6节):
- 移动端数据看板:关键指标与趋势图
- 舆情预警:紧急/关注事项分级展示
- 审批中心:强制通过申请的移动端审批
- 审计日志:快速查询与证据链导出

设计原则:
- 移动端定位为桌面端的轻量补充
- 复杂操作(规则配置等)引导至桌面端完成
- 支持横屏全屏视频预览

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 16:15:40 +08:00
Your Name
63c77323ca 审阅 User_Role_Interfaces.md 与 RD/PRD 对齐
- 补充用户故事引用 [US-01~US-13]
- 角色权限矩阵新增"证据链导出"权限
- Brief 配置补充在线文档链接、区域合规切换
- 审核决策台补充软性风控边界、强制通过记录规范
- 版本比对补充违规点修复统计摘要
- 规则配置补充区域合规、特例记录管理
- 审计日志细化证据链导出字段

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 16:08:39 +08:00
Your Name
62c87a234c 补充多模态时间戳对齐流程图 (Gemini 建议)
新增 2.5 章节:
- Mermaid 时序图展示 ASR/OCR/CV 并行处理与对齐流程
- 说明对齐算法要点:时间轴归一化、模糊匹配窗口、事件合并

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 12:11:18 +08:00
Your Name
e8e4edfd66 根据 Reviewer 技术修正意见更新 DevelopmentPlan.md V1.2
关键修正:
1. Logo 检测:废弃 YOLOv8,改为 Embedding-based Retrieval (Grounding DINO + Vector DB)
   - 支持 SaaS 模式动态添加竞品 Logo,无需重训练
2. Brief 解析:增加 Layout Analysis + VLM,支持提取 PDF 中的参考图片
3. GPU 资源:单一 T4 改为弹性 GPU 集群 (PAI-EAS/veFaaS),支持自动扩缩容
4. H5 防锁屏:增加 Wake Lock API 策略,解决 iOS Safari 上传中断问题
5. 排期调整:Phase 2 从 3 周延长至 4 周,总周期 10→11 周

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 12:02:45 +08:00
Your Name
4b8be74cb7 审阅并完善开发计划文档 DevelopmentPlan.md V1.1
修订内容:
- 补充版本历史与文档依据
- 完善 MVP 功能列表(18个P0功能)
- AI 模型选型改为国内合规方案(豆包/Qwen/DeepSeek)
- 新增 F-45 时长与频次校验技术方案
- 新增核心数据模型章节(实体关系+表结构)
- 新增验收标准章节(9项量化指标)
- 新增测试策略章节(6类测试+AI专项测试)
- 扩展下一步行动与相关文档

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 11:57:48 +08:00
Your Name
ccdef4d296 根据 Gemini 关键改进意见完善 FeatureSummary.md V1.2
优先级调整:
- F-09 语境理解 P1→P0(避免"人工智障"体验)
- F-17 审核进度展示 P1→P0(缓解等待焦虑)

功能拆分:
- F-05 拆分为 F-05-A 基础竞品库(P0) + F-05-B 高级豁免(P1)

新增功能:
- F-45 时长与频次校验 (P0)
- F-46 负样本清洗与回流 (P2)

其他改进:
- F-30 ZIP上传改为多文件拖拽上传
- 新增移动端 H5 适配要求

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 11:45:43 +08:00
Your Name
50170566e8 根据 Gemini 修订意见完善 FeatureSummary.md V1.1
- 补充完整验收标准章节(Brief解析、Logo检测、ASR/OCR等)
- 补充 Out of Scope 边界说明(5项排除功能)
- 细化核心痛点描述,增加痛点详细描述列

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 11:34:15 +08:00
Your Name
fb68f93ac1 新增产品功能文档,完善PRD和界面规范
- 新增 FeatureSummary.md:综合整理43个功能点,按优先级分类
- 完善 PRD.md:补充产品愿景、假设与约束、技术架构
- 更新 User_Role_Interfaces.md:补充用户故事引用、区域合规、证据链权限

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 11:26:59 +08:00
Your Name
173baf2e9f 审阅并完善用户角色与界面规范文档
基于 Gemini 初稿进行全面审阅和补充:

## 新增内容
- 版本历史追踪
- 各端导航结构图(达人/代理商/品牌方)
- 达人端:消息通知中心、历史记录页
- 代理商端:达人管理、数据报表、批量操作中心
- 品牌方端:数据看板(含可视化图表)、代理商管理、舆情预警中心
- 响应式设计规范(断点定义、各端适配策略)
- 无障碍设计要求(WCAG 2.1 AA)
- 错误处理与边界情况规范
- 页面清单与优先级标注

## 完善内容
- 扩展角色权限矩阵(增加系统配置、用户管理权限)
- 细化品牌方规则配置(版本管理、审批流程)
- 补充审计日志的高级筛选和证据链导出功能

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 10:56:29 +08:00
Your Name
57997acd18 综合审核并完善需求文档
- 增加版本历史追踪文档变更
- 为用户故事添加优先级标识(P0/P1/P2)
- 成功指标表格化,增加测量方式和责任方
- 新增技术架构概述章节
- 完善非功能性需求:增加个人信息保护法和数据本地化要求
- 开放问题表格化,增加解决方向和决策责任人
- 新增附录:相关文档列表和缩略语表

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 22:28:21 +08:00
Your Name
b7779b4c86 clarify soft-sentiment metric 2026-01-30 22:15:48 +08:00
Your Name
ef08986c7c review gemini revisions 2026-01-30 21:59:29 +08:00
Your Name
e8f8dd48cb refine compliance suggestions 2026-01-30 20:04:35 +08:00
Your Name
9ffa06e0d3 revise requirements doc 2026-01-30 19:59:36 +08:00
Your Name
7edc9a2064 first commit 2026-01-30 19:45:42 +08:00