lijiaoqiao/review/prd_tech_planning_expert_review_v1_2026-03-24.md

PRD 与技术规划专项专家评审报告（2026-03-24）

• 报告版本：v1.0
• 评审对象：docs/ 下 PRD、供应侧产品设计、技术架构与执行门禁相关文档
• 评审专家视角：产品、架构、安全、测试、结算
• 评审方法：一致性审查、闭环性审查、最小功能粒度审查（含按钮级检查）

---

1. 执行结论

1.1 是否符合行业最佳实践能力

结论：部分符合（可评估为 72/100）

已达标项：

1. 已形成 SSOT + 门禁 + 任务 + 验收用例 + 决议模板链路（subapi 集成域）。
2. 凭证边界红线（M-013~M-016）已制度化，具备 P0 阻断口径。
3. 运维可靠性有明确回滚目标（10 分钟触发、30 分钟恢复）。

未达标项：

1. 供应侧核心商业参数仍存在多口径冲突（会直接影响计费结算一致性）。
2. 供应侧核心功能没有被纳入与 subapi 同等级的 Gate/测试闭环。
3. 数据库方言与主技术栈（PostgreSQL）不一致，存在可执行性风险。

1.2 功能设计是否闭环

结论：subapi 集成域闭环较完整，供应侧交易域闭环不完整（综合 68/100）

1.3 功能清单是否细化到最小可细化（按钮级）

结论：未达到（42/100）

当前文档主要到“模块/流程/API”层，尚未下钻到：

1. 页面级字段定义（必填、校验、默认值）。
2. 按钮级交互定义（可见性、禁用态、点击后状态迁移）。
3. 空态/错误态/权限态矩阵。
4. 前端交互与后端状态机一一映射。

---

2. 关键发现（按严重级别）

2.1 P0-01：供应侧结算参数多口径冲突，存在错账风险

证据

1. 采购折扣系数=60%：
   • docs/business_model_profitability_design_v1_2026-03-18.md 第11行、第23行。
2. 采购折扣系数=0.85：
   • docs/supply_side_product_design_v1_2026-03-18.md 第135行。
3. 供应方收益=60%：
   • docs/supply_feature_technical_analysis_v1_2026-03-18.md 第189行。
4. SQL 示例按 85/15 分账：
   • docs/supply_detailed_design_v1_2026-03-18.md 第842行、第843行。

影响

1. 报价、结算、财务预测口径不一致，无法形成可审计账务链路。
2. 同一交易在不同服务中可能产生不同收益分配结果。

处理建议

1. 立即冻结单一分账公式（建议以 v4.2 SSOT 指定口径为准）。
2. 统一改写 PRD/产品/技术/SQL 示例并加“版本生效日期”。
3. 将分账公式纳入 Gate（若口径不一致直接阻断发布）。

---

2.2 P0-02：供应侧主流程未纳入可执行 Gate 闭环

证据

1. 供应侧流程已定义为核心业务：
   • docs/supply_side_product_design_v1_2026-03-18.md 第42-68行、第155-164行。
2. 两周执行任务单以 subapi 集成为主，未形成 SUP-* 类型执行任务：
   • docs/subapi_integration_risk_controls_execution_tasks_v1_2026-03-17.md 第48-124行。
3. 门禁有供应侧指标（M-011/M-012），但缺少与之绑定的可复跑测试用例与任务映射：
   • docs/acceptance_gate_single_source_v1_2026-03-18.md 第32-33行。

影响

1. 供应侧“入驻-验证-上架-交易-结算-赔付”无法被发布门禁真实拦截。
2. “文档有流程、执行无证据”的治理断层持续存在。

处理建议

1. 新建 Workstream SUP（入驻、挂载、定价、订单、提现、赔付、争议）。
2. 对 M-011/M-012 补齐测试用例与证据路径（对应 tests/supply/*、reports/supply/*）。
3. 将供应侧闭环纳入 EXP-006 决议硬门槛。

---

2.3 P0-03：供应侧关键 SQL 示例存在明显错误，可能误导实现与报表

证据

1. SQL 中使用未定义别名 su：
   • docs/supply_detailed_design_v1_2026-03-18.md 第838行、第840行、第851行。
2. supply_packages 与 supply_usage_records 的关联条件可疑（package_id 对 supply_account_id）：
   • docs/supply_detailed_design_v1_2026-03-18.md 第870-873行。

影响

1. 直接复制执行会失败或产生错误统计。
2. 收入与消耗报表可能出现错误聚合，影响结算与决策。

处理建议

1. 将 SQL 示例转为“可执行 SQL + 单元测试样例”。
2. 在文档中标注示例执行环境与校验结果（通过/失败）。

---

2.4 P1-01：数据库方言与主技术栈冲突（PostgreSQL vs MySQL）

证据

1. 主栈明确为 PostgreSQL：
   • docs/technical_architecture_optimized_v2_2026-03-18.md 第14行。
   • docs/test_plan_go_aligned_v1_2026-03-18.md 第5行、第70行。
2. 供应侧 DDL 仍为 MySQL 方言：
   • docs/supply_detailed_design_v1_2026-03-18.md 第198行（AUTO_INCREMENT）。
   • docs/supply_detailed_design_v1_2026-03-18.md 第237行（ON UPDATE CURRENT_TIMESTAMP）。
   • docs/supply_detailed_design_v1_2026-03-18.md 第379行（STORED 生成列语法差异）。

影响

1. DDL 无法直接在目标数据库执行，拖慢开发与验收。
2. 评审口径与实际实现环境脱节。

处理建议

1. 建立 sql/postgresql/ 唯一 DDL 源。
2. 文档中的 SQL 一律引用该目录，禁止内嵌多方言片段。

---

2.5 P1-02：技术架构存在双基线冲突，实施团队易走偏

证据

1. 旧版架构默认重组件（Kong/Kafka/Istio）：
   • docs/technical_architecture_design_v1_2026-03-18.md 第67-74行。
2. 优化版明确 S0/S1 默认禁止这些组件：
   • docs/technical_architecture_optimized_v2_2026-03-18.md 第31-35行、第52-57行。

影响

1. 研发、运维、采购可能按不同架构执行。
2. 成本与复杂度不可控，影响交付节奏。

处理建议

1. 将 technical_architecture_design_v1 标记为“历史稿/不再执行”。
2. 在目录层设置“当前生效架构索引页”，避免误读。

---

2.6 P1-03：PRD 仍为评审稿，关键商业/产品决策未冻结

证据

1. PRD 版本标识为 v0.1（评审稿）：
   • docs/llm_gateway_prd_v0_2026-03-16.md 第3行。
2. 关键事项仍在“待决策问题”：
   • docs/llm_gateway_prd_v0_2026-03-16.md 第205-209行。

影响

1. 研发与测试难以对齐明确产品边界与发布目标。
2. 需求变更风险上升，迭代返工概率高。

处理建议

1. 输出 PRD v1.0 冻结稿（明确“已拍板项/未拍板项”）。
2. 每个 P0 功能绑定 Requirement ID -> API -> Test Case -> Gate。

---

2.7 P1-04：功能清单未细化到按钮/状态级，前后端联调风险高

证据

1. PRD 与供应侧文档主要是流程/模块级描述：
   • docs/llm_gateway_prd_v0_2026-03-16.md 第70-90行、第106-139行。
   • docs/supply_side_product_design_v1_2026-03-18.md 第222-253行。
2. 尚未看到“页面字段、按钮行为、禁用条件、错误提示、权限态”的结构化定义。

影响

1. UI 实现将依赖口头沟通，需求解释偏差概率高。
2. 测试无法编写页面级可执行用例（尤其异常态与权限态）。

处理建议

1. 为每个核心页面新增“按钮级规格表”。
2. 建立 UI 规格模板：按钮ID、触发条件、后端接口、成功态、失败态、审计事件。

---

3. 闭环性评估矩阵（专家联合结论）

业务域	需求定义	技术设计	执行任务	测试用例	Gate/决议	结论
Subapi 集成	完整	完整	完整	完整	完整	基本闭环
凭证边界治理	完整	完整	完整	完整	完整	基本闭环
供应侧交易闭环	中	中	弱	弱	弱	未闭环
前端交互（按钮级）	弱	弱	无	无	无	未开始

---

4. 最小细化要求（按钮级）补齐清单

每个核心页面至少补齐以下 10 项：

1. 页面 ID 与目标用户角色。
2. 字段清单（类型、校验、默认值、脱敏规则）。
3. 按钮清单（主/次按钮、可见性条件）。
4. 按钮禁用条件（余额不足、权限不足、风控锁定等）。
5. 点击后状态迁移（loading/success/failed/retry）。
6. 错误码与文案映射。
7. 空态与异常态（无数据、网络异常、风控拦截）。
8. 审计事件（谁在何时做了什么）。
9. 埋点事件（转化漏斗、异常漏斗）。
10. 对应测试用例 ID（UI/E2E/API）。

---

5. 结论建议（GO 判定）

当前建议：CONDITIONAL NO-GO（先补齐 P0/P1 后再复审）

复审准入条件：

1. P0 全部关闭并有证据。
2. P1 至少完成“可执行不走样”的最低闭环（特别是按钮级规格和供应侧 Gate）。
3. 新版 PRD（v1.0）与技术规划 SSOT 互相引用且无冲突。