feat: 完成原型04-10全链路功能开发，包括AI助手、PDF导出等

2026-09-28 17:50:46 +08:00
parent 7c252fc730
commit 79feb03b19
27 changed files with 1083 additions and 180 deletions
@@ -171,7 +171,7 @@ unknown不是建议申请；ineligible不是永久拒绝。展示应为“本次
 - 推荐依据 `positiveReasons`、不符条件 `blockingReasons`、待核实/注意事项 `cautions` 分开保存。首页各组最多展示三条；没有证据就不生成，详情可读完整列表。通过部分条件的不适配产品，其positiveReasons不能标成“推荐该产品”。
 - 理由 `{reasonId,code,text,evidenceRefs}` 由确定性规则/模板生成，evidenceRefs至少一个且只引用本项证据。失败条件、未知依据全部保存，不能因为只展示三条而丢掉阻断项。产品公共优势不是用户个性化理由。
 - 证据 `{evidenceId,ruleId,ruleVersion,kind,fieldRefs,operator,expected,actual,outcome,source,observedAt}` 固定类型、单位和来源。evidenceId在整份报告内唯一且稳定，例如由productId、ruleId和条目序号组成，不能让不同产品的同名规则共用ID。kind=hard/soft，source=self_reported/verified/product_snapshot；expected/actual金额保持元字符串，未知actual=null。规则快照保存requiredSource，复核时能判明证据是否够用。
- 单项 `aiExplanation={status,text,evidenceRefs}`，status=not_requested/completed/failed；只解释服务端已生成的理由，不能新增规则、伪造优势/风险或改判定。模型内容缺证据、含审批承诺或改写数值时拒绝保存该段，保留规则理由并显示解释暂不可用。不存在“必须每家补足三正三反”的生成要求。
+- 单项 `aiExplanation={status,text,evidenceRefs,reasonExplanations,generatedAt,errorCode,canRetry}`，status=not_requested/queued/running/completed/failed（2026-09-28已实现）；reasonExplanations为`{reasonId,text,evidenceRefs}[]`，generatedAt为ISO时间或null，errorCode为稳定错误码或null，canRetry为boolean。taskId/leaseUntil/requestKeys/attempts仅内部保存，不通过DTO外发；只解释服务端已生成的理由，不能新增规则、伪造优势/风险或改判定。模型内容缺证据、含审批承诺或改写数值时拒绝保存该段，保留规则理由并显示解释暂不可用。不存在“必须每家补足三正三反”的生成要求。

 证据类型增补：source在事实完全缺失/无法确定来源时允许null，不捏造self_reported/verified；observedAt未知也为null。额外提供requiredSource、reasonCode、valueType及unit，现已映射入正式match_result。not_applicable以product_snapshot作为适用范围依据来源。