kol-insight/doc/review-PRD-claude.md

PRD 评审报告

概要

项目	内容
评审时间	2026-01-28 21:30
目标文档	doc/PRD.md
参照文档	doc/RequirementsDoc.md
问题统计	3 个严重 / 2 个一般 / 3 个建议

一致性检查

需求覆盖分析

RequirementsDoc 需求项	PRD 对应位置	状态
批量查询 KOL 视频数据	US-001, US-002, US-003	✅ 已覆盖
支持星图ID精准查询	US-001 / 3.2.1节	✅ 已覆盖
支持达人unique_id精准查询	US-002 / 3.2.1节	✅ 已覆盖
支持达人昵称模糊查询	US-003 / 3.2.1节	✅ 已覆盖
计算预估自然CPM	US-004 / 3.2.2节	⚠️ 部分覆盖（缺少公式）
计算预估自然看后搜	US-004 / 3.2.2节	⚠️ 部分覆盖（缺少公式）
计算预估自然看后搜成本	US-004 / 3.2.2节	⚠️ 部分覆盖（缺少公式）
数据导出	US-005 / 3.2.4节	✅ 已覆盖
调用品牌API获取品牌名称	-	❌ 未覆盖
技术栈：Next.js + PostgreSQL	7.1节	✅ 已覆盖
部署方式：Docker / PM2	7.1节	✅ 已覆盖

差异说明

PRD 新增但 RequirementsDoc 未明确提及的内容：

1. 用户角色定义（2.1节）：细化了"运营人员"和"投放优化师"两个角色，这是对原始需求的合理扩展
2. 用户旅程设计（2.3节）：可视化了用户操作流程，增强了需求理解
3. 里程碑规划（第8章）：增加了MVP和v1.1两个阶段规划
4. 风险评估（第9章）：识别了数据同步延迟、性能问题等风险

评估: 以上新增内容均为合理的 PRD 扩展，有助于后续开发和实施。

问题清单

严重问题 (Critical)

必须修复，否则影响后续文档生成

1. [位置: doc/PRD.md:199] 缺少外部品牌API依赖说明

   • 现状：PRD 第6章"接口需求"中仅提及 PostgreSQL，未说明需要调用外部品牌API
   • 与 RequirementsDoc 的差异：RequirementsDoc 明确说明"合作品牌要使用合作品牌id 调用另一个API查找 https://api.internal.intelligrow.cn/docs#/%E4%BA%91%E5%9B%BE/get_yuntu_cookies_v1_yuntu_get_cookie_get /v1/yuntu/brands/{brand_id}"
   • 建议：在 6.1 外部接口表格中增加品牌API行：

     | 品牌API | 根据品牌ID获取品牌名称 | https://api.internal.intelligrow.cn/v1/yuntu/brands/{brand_id} |
     

2. [位置: doc/PRD.md:273] 输出字段映射不完整

   • 现状：附录B中大部分输出字段的"字段名"列标记为"-"，缺少数据库字段映射
   • 影响：开发人员无法知道如何从数据库获取这些数据
   • 建议：补全所有输出字段对应的数据库字段名，参考 RequirementsDoc 中的字段定义

3. [位置: doc/PRD.md:114] 计算公式缺失

   • 现状：3.2.2节"数据计算模块"仅描述了功能，未给出具体计算公式
   • 与 RequirementsDoc 的差异：RequirementsDoc 明确了三个公式：
     • 预估自然CPM = estimated_video_cost / natural_play_cnt * 1000
     • 预估自然看后搜人数 = natural_play_cnt / total_play_cnt * after_view_search_uv
     • 预估自然看后搜人数成本 = estimated_video_cost / 预估自然看后搜人数
   • 建议：在 3.2.2 节的"描述"列或"验收标准"列中添加完整的计算公式

一般问题 (Major)

建议修复，可提升文档质量

1. [位置: doc/PRD.md:119] 术语不一致

   • 问题：PRD 使用"预估自然看后搜"，RequirementsDoc 使用"预估自然看后搜人数"
   • 影响：可能导致理解偏差（是次数还是人数）
   • 建议：统一术语为"预估自然看后搜人数"，与计算公式中使用的 after_view_search_uv（用户数）概念一致

2. [位置: doc/PRD.md:168] 数据模型与计算公式不匹配

   • 问题：5.1节数据模型中未列出计算公式所需的关键字段：
     • estimated_video_cost（预估视频价格）- 已在5.2中提及
     • natural_play_cnt（自然曝光数）- 已在5.1中提及
     • total_play_cnt（总曝光数）- 已在5.1中提及
     • after_view_search_uv（看后搜人数）- 未明确提及字段名
   • 建议：在 5.1 数据模型图中补充这些关键字段的明确字段名

改进建议 (Minor)

可选优化项

1. [位置: doc/PRD.md:262] 术语表可补充

   • 建议：在术语表中补充以下术语：
     • natural_play_cnt：自然曝光次数
     • estimated_video_cost：预估视频价格
     • after_view_search_uv：看后搜用户数

2. [位置: doc/PRD.md:164] 数据需求可细化

   • 建议：补充数据库表名（如 videos 或 kol_videos）
   • 建议：补充关键字段的索引建议（star_id, star_unique_id, star_nickname）

3. [位置: doc/PRD.md:208] 内部接口设计

   • 建议：虽然标注"待补充"，但可以在此阶段先列出核心API端点：
     • POST /api/query - 批量查询接口
     • GET /api/export - 数据导出接口

用户故事评估

评估项	结果
用户故事总数	7 个
符合格式规范	7 / 7 ✅
有验收标准	7 / 7 ✅
关联功能点	7 / 7 ✅
优先级划分	明确（P0/P1/P2）✅

用户故事质量评价

优点:

• ✅ 所有用户故事都有唯一ID（US-001 ~ US-007）
• ✅ 格式规范，符合"作为{角色}，我想要{功能}，以便{价值}"结构
• ✅ 验收标准清晰、可测试
• ✅ 优先级划分合理，核心查询和计算功能为P0

无明显问题

评审结论

需修改后通过

结论说明

PRD 整体质量较好，功能需求覆盖完整，用户故事设计规范，文档结构清晰。但存在以下关键问题需要修复：

1. 外部API依赖缺失：未说明需要调用品牌API获取品牌名称，这是实现完整功能的必要依赖
2. 计算公式缺失：开发人员需要明确的计算公式来实现预估指标
3. 字段映射不完整：输出字段与数据库字段的映射关系不明确

修复上述3个严重问题后，PRD 可以作为下一阶段（FeatureSummary、UIDesign、DevelopmentPlan）的基础文档。

下一步行动

• 必须：在 6.1 节补充品牌API外部接口说明
• 必须：在 3.2.2 节补充完整的计算公式
• 必须：在附录B中补全所有输出字段的数据库字段名
• 建议：统一"预估自然看后搜"术语为"预估自然看后搜人数"
• 建议：在 5.1 数据模型中明确标注计算公式所需字段的字段名

---

附录：RequirementsDoc 原始需求对照

为便于对比，以下是 RequirementsDoc 中的核心需求要点：

功能需求

• 批量查询 KOL 视频数据
• 支持星图ID、达人unique_id、达人昵称搜索
• 计算预估自然CPM、看后搜成本等指标
• 数据导出

查询规则

• 星图ID → 匹配 star_id 字段（精准匹配）
• 达人unique_id → 匹配 star_unique_id 字段（精准匹配）
• 达人昵称 → 模糊匹配 star_nickname 字段（包含匹配）

计算公式

预估自然CPM = estimated_video_cost / natural_play_cnt * 1000
预估自然看后搜人数 = natural_play_cnt / total_play_cnt * after_view_search_uv
预估自然看后搜人数成本 = estimated_video_cost / 预估自然看后搜人数

外部依赖

• 品牌API: /v1/yuntu/brands/{brand_id}
• 用途：根据合作品牌ID查询品牌名称

技术栈

• Next.js (App Router)
• PostgreSQL
• Docker / PM2