docs: 更新匹配规则及页面改造相关文档，新增演示产品及报告验证记录

docs/需求与评估结果数据契约.md

@@ -1,10 +1,10 @@
 # 融资需求与评估结果数据契约
 
-版本：v1.2（需求、完整度/准备状态与报告v2自填支线已实施；匹配仍为计划）。日期：2026-09-24。配套：[开发文档](开发文档.md)、[开发进度](开发进度.md)。
+版本：v1.5（需求/报告v2、目录冻结及规则匹配落库已实施；匹配读接口与页面待接）。日期：2026-09-24。配套：[开发文档](开发文档.md)、[开发进度](开发进度.md)。
 
 本文补充融资需求字段、资料完整度与准备等级、产品匹配解释三个范围，作为后续前后端、数据迁移及验收的共同依据。依据为[开发说明书](开发说明书.docx)第2—5节及[原型图](原型.jpg)第02—05、09屏，并遵循用户后续确认的无草稿、H5优先、数据库存元及复用评估/报告表的约定。
 
-**实施状态：需求v2、用途字典、完整度/准备状态、执行策略快照和报告v2自填支线已实现。** DEC-DEMAND和DEC-READINESS已按用户授权采用首版开发配置；新提交冻结targetResultVersion=2。升级前未带该标记或目标1的输入仍走resultVersion=1，旧成功报告不重算。真实匹配及产品解释待DEC-MATCH/产品资料，v2真实模型语义和生产业务验收仍待完成。本轮使用假模型验证；证据见开发文档0.6和开发进度6.6。
+**实施状态：需求v2、用途字典、完整度/准备状态、执行策略快照和报告v2自填支线已实现。** DEC-DEMAND和DEC-READINESS已按用户授权采用首版开发配置；新提交冻结targetResultVersion=2。升级前未带该标记或目标1的输入仍走resultVersion=1，旧成功报告不重算。真实匹配及产品解释待DEC-MATCH/产品资料，v2有限真实模型样例现已通过，生产业务和大样本语义验收仍待完成；证据见开发文档0.7、开发进度6.7及[真实模型验证记录](报告v2真实模型验证.md)。
 
 ## 1. 范围与业务含义
 
@@ -15,7 +15,7 @@
 | 融资准备等级 | 按已发布资料规则，哪些信息缺失、矛盾或可以进入人工核对 | 风险等级、授信等级、获批概率 |
 | 产品匹配 | 在指定时点、产品版本和已知事实下，具体条件是否满足 | 审批结论；自填条件满足也未经机构核验 |
 
-本次不新增页面；需求录入放评估页的“资金需求”步骤/分组，确认页、档案、报告同步显示。原型默认展示最多三个候选；不足三个不补造。匹配解释在现有产品详情内展示，传递 assessmentId 与 productId。产品对比、PDF、渠道、注销、知识库等审查发现另外排期，不随本文隐式纳入实现。
+最初契约不新增页面，需求录入放评估页的“资金需求”步骤/分组，确认页、档案、报告同步显示。2026-09-24用户明确要求补齐04—10，现以[页面改造方案](原型04-10页面改造与跳转方案.md)为准：新增对比/下一步行动页并将PDF纳入一期任务；其余渠道、注销、知识库未随本次扩大。原型默认最多三个候选，不足不补造；匹配解释仍在现有产品详情展示，传递assessmentId与productId。
 
 本次只增加共同融资需求字段。年龄段/工作年限、企业开票/纳税/流水/法人等补充资料另在 ASSESS-001 的字段字典阶段细化；当前已有 `year_invoicing/year_tax_amount` 可复用，但没有录入/API支撑时不能启用依赖它们的准入规则或宣称相关完整度已覆盖。企业成立月数与经营月数不等同，不能互相代填。
 
@@ -149,6 +149,8 @@ HTTP201接受回执保持 `{assessmentId:string,submissionStatus:"accepted"}`；
 
 ## 5. 产品匹配与结果解释
 
+2026-09-24已接通发布预检、字段编译、目录冻结、三态判定、productId升序及正式任务落库；不启用评分。快照结构见[产品规则开发契约](产品匹配规则开发契约.md)第7节。本地经用户授权上架6条演示产品，用于联调；匹配读接口/页面、真实产品规则与人工金标准仍待验收。
+
 ### 5.1 候选判定与未知值
 
 1. 先验证产品发布状态、有效期、适用对象和配置完整性，冻结本次可评估产品集合。草稿/下架/过期产品不进入本次集合；无真实产品或无已发布规则时 matching.status=unavailable。
@@ -171,6 +173,8 @@ unknown不是建议申请；ineligible不是永久拒绝。展示应为“本次
 - 证据 `{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；只解释服务端已生成的理由，不能新增规则、伪造优势/风险或改判定。模型内容缺证据、含审批承诺或改写数值时拒绝保存该段，保留规则理由并显示解释暂不可用。不存在“必须每家补足三正三反”的生成要求。
 
+证据类型增补：source在事实完全缺失/无法确定来源时允许null，不捏造self_reported/verified；observedAt未知也为null。额外提供requiredSource、reasonCode、valueType及unit，现已映射入正式match_result。not_applicable以product_snapshot作为适用范围依据来源。
+
 ### 5.3 结果存储与接口
 
 仍在 `fa_ai_chat.match_result` 保存有序JSON数组，数据库键沿用snake_case，DTO层转camelCase；不新建匹配表，不把有序数组改为对象。每项包含：
@@ -185,7 +189,7 @@ unknown不是建议申请；ineligible不是永久拒绝。展示应为“本次
 | evidence / aiExplanation | evidence / ai_explanation | 证据数组及可空解释对象，嵌套对象也显式映射键名 |
 | productSnapshot | product_snapshot | 不可变产品参数、适用对象/地区/用途规则、材料、来源引用、采集/更新时间、产品版本；金额元字符串，期限月，年化百分数字符串 |
 
-当前 `Assessment::complete()` 用isset强制rank/score非null，**必须随v2调整为“键存在＋按eligibility验证类型”**，不能仅在文档中把score写可空。匹配读接口尚未实现，不存在把这一变更当现有兼容已通过的依据。
+`Assessment::complete()`现已对v2按冻结目录复算并比对整个匹配数组与统计，允许未评分score=null及非候选rank=null，禁止非法组合/引用写入；v1保留旧格式。匹配读接口尚未实现。19项正式任务测试已覆盖合法null落库及旧冻结引擎兼容。
 
 聚合对象 `matching={status,reasonCode,ruleVersion,orderingPolicyVersion,catalogSnapshotId,candidateCount,ineligibleCount,unknownCount}` 存在report_data，不放入match_result数组头部：
 
@@ -224,7 +228,7 @@ matches只读成功评估，未成功409；参数错误422。服务端先鉴权
 
 报告标准区块为“需求概况—资料完整度—准备等级—主要优势—待完善项—风险提示—候选及解释—免责声明”。不必为每个区块生成长文本；缺数据时明确未提供。需求金额/期限、比例、等级、匹配理由通过结构化事实呈现，AI正文继续只作定性解释。
 
-v2模型输出不直接作为完整Report入库。服务端仅接受固定四个模型字段summary/strengths/improvements/riskWarnings；summary 2—600字符，各数组0—6项，每text 2—400字符，每条evidenceRefs 1—5个且去重，只引用输入的facts/ruleEvidence/readinessBasis公共引用ID。统一引用命名空间 `fact:<fieldKey>`、`rule:<evidenceId>`、`readiness:<basisId>`，使用第4.2/5.2节保存的唯一ID；无引用的优势不能存。保留现有禁止数值复述、HTML和控制字符的校验；新增结构不得沿用当前只支持observations/suggestions/dataGaps的v1解析器。summary仅概括事实且不能改变结构化结论。
+v2模型输出不直接作为完整Report入库。服务端仅接受固定四个模型字段summary/strengths/improvements/riskWarnings；summary 2—600字符，各数组0—6项，每text 2—400字符，每条evidenceRefs 1—5个且去重，只引用输入的facts/ruleEvidence/readinessBasis公共引用ID。统一引用命名空间 `fact:<fieldKey>`、`rule:<evidenceId>`、`readiness:<basisId>`，使用第4.2/5.2节保存的唯一ID；无引用的优势不能存。外发提供allowedEvidenceRefs，但不传完整度计数/百分比；单项建议1—3个引用，服务端上限仍为5。不得从自填零负债推断信用记录，不得从资料齐全推断受理资格；not_applicable不是缺失。保留禁止数值复述、HTML和控制字符的校验，补中文项数/“为零”等模式；新增结构不得沿用当前只支持observations/suggestions/dataGaps的v1解析器。summary仅概括事实且不能改变结构化结论。
 
 禁止输出保证通过、审批概率、已核验信用良好、内部渠道等无依据结论。语义校验和提示词不能保证模型绝无错误，需用人工金标准样例持续验收；数值、等级和准入结果始终由服务端权威字段控制。主报告结构不合法时任务failed；单产品AI解释失败时保留确定性匹配理由，不触发无限收费重试。