baodan/docs/PPT与海报首迭代实施记录_20260802.md

PPT 与海报生成全链路首迭代实施记录

日期：2026-08-02
依据：PPT与海报生成全链路详细修复计划书_20260802.md

1. 本轮范围

本轮完成计划书“立即执行的第一轮迭代”中的 P0-A、P0-B、P0-C，并建立 Goldens 与三份核心 Schema 的基础设施。计划书中 Phase 1～6 的长期改造不在本轮范围内。

2. 已完成变更

P0-A 确认与生成门禁

• 确认时校验文件实际 SHA-256、上传记录哈希和前端提交哈希一致。
• 确认时校验解析快照哈希，阻断基于过期解析结果的确认。
• 对币种、年龄、缴费金额、关键利益字段、产品匹配和来源页执行服务端业务校验。
• 手工修改关键字段必须填写覆盖原因；确认快照写入 Schema 版本和各级哈希。
• 海报生成和文案重生成再次执行同一套门禁，禁止绕过确认接口直接生成。
• 业务校验失败统一返回 HTTP 422；审计日志仅记录哈希和覆盖原因，不写完整敏感快照。

P0-B 数字口径纠偏

• 缺失或无效数字保留为 None，不再归一成 0。
• 移除重疾险、IUL 中不同语义字段之间的兜底映射。
• 移除“年缴保费 × 缴费年期 = 合同总保费”的事实字段推导，只保留明确标记的派生估算字段。
• IRR、回本年和比较指标遇到缺失值时不参与计算。
• 海报显式里程碑与表格冲突时记录未解决冲突，不再静默覆盖。
• PPT 渲染按保单币种展示；缺失数字显示“待确认”；可空金额路径不再执行除法、求和或 float(None)。

P0-C 模板确定性

• 模板必须覆盖当前全部保司和全部产品，而不是任意命中一个即通过。
• 自动模板选择采用稳定排序；最高优先级并列时阻断并要求显式选择。
• 前端模板列表采用相同的全量适用规则和确定性排序，并展示歧义提示。
• 管理端明确说明 slidesConfig 目前仅控制视觉/元数据，不宣称能控制业务页面结构。
• 任务记录 scenarioOverrideTrace，包含请求场景、模板场景标签、服务端检测场景、Worker 检测场景和最终场景。

Schema 与 Goldens

• 冻结 field-value.schema.json、document-ir.schema.json、plan-data-snapshot.schema.json 首版草案。
• 新增 Goldens manifest、使用说明和评估脚本；脚本在样本不足时以阻断状态退出。
• 新增 Schema 评审记录，明确迁移 036/037 前仍需产品、精算、合规确认的业务决策。

3. 验证结果

• 后端目标回归：111 passed，1 skipped（系统 Python 未安装 python-pptx）。
• 使用工作区文档运行时复跑 PPT 相关测试：81 passed，无跳过。
• 前端生产构建：通过。
• Vue TypeScript 检查：通过。
• Python compileall：通过。
• git diff --check：通过（仅有仓库既有换行符提示）。

4. 未解决项与外部依赖

• Goldens 当前为 0/10：仓库内没有经脱敏、经业务批准的真实计划书样本，不能用虚构样本替代基线。
• 迁移 036/037 未创建：需先完成 Schema 评审记录中的业务决策，避免把未确认语义固化进数据库。
• 前端 ESLint 暂不能执行：项目使用 ESLint 9，但仓库没有 eslint.config.js/mjs/cjs flat config；本轮以生产构建和 vue-tsc 作为前端静态验证。
• Phase 1～6（完整事实模型、Document IR 持久化、场景规则库、Poster RenderDocument、模板克隆增强、可观测性与发布治理）仍按原计划书继续推进。

5. 下一轮入口条件

1. 提供至少 10 份脱敏且获批的真实计划书样本及人工标准答案。
2. 产品、精算、合规共同确认三份 Schema 的待决项。
3. 决策通过后再创建迁移 036/037，并进入 Phase 1/2。