feat(融资): 新增产品对比页面及相关接口实现
新增产品对比页面 compare/compare，支持同一评估下最多3个产品的横向对比，展示额度、期限、利率、适用条件等核心指标及匹配详情。 新增 matches.uts 服务层，封装匹配列表、详情、公共产品查询接口。 新增 account 分包的 latest-report.uts 服务，用于查找用户最新成功报告。 调整个人中心页面，将“评估记录”改为“开始评估”，新增最近报告直达功能。 更新文档，标记匹配相关接口及原型07、09页面已实现，调整页面数量至26页。 移除 finance 分包中旧的 fetchMatches、fetchProduct 模拟数据接口，统一使用正式API。
This commit is contained in:
hujun
+50
-3
@@ -1,6 +1,6 @@
|
||||
# 产品匹配规则开发契约
|
||||
|
||||
版本：1.2。日期：2026-09-24。关联PRODUCT-001、PRODUCT-002、PRODUCT-003。页面消费方式见[04—10方案](原型04-10页面改造与跳转方案.md)，完整产品判定/快照/接口语义仍以[数据契约](需求与评估结果数据契约.md)第5节为准。
|
||||
版本：1.3。日期：2026-09-24。关联PRODUCT-001、PRODUCT-002、PRODUCT-003。页面消费方式见[04—10方案](原型04-10页面改造与跳转方案.md)，完整产品判定/快照/接口语义仍以[数据契约](需求与评估结果数据契约.md)第5节为准。
|
||||
|
||||
## 1. 本轮实现边界
|
||||
|
||||
@@ -77,7 +77,7 @@
|
||||
|
||||
64项覆盖金额上下界/一分钱误差/最大值/float拒绝、期限边界/类型、零值与缺失、fail优先但保留unknown、来源门槛、other用途、地区不从文本推断、证据产品隔离、确定性、无评分、身份字段排除、非法规则与列表大小等。
|
||||
|
||||
发布预检、字段编译、目录冻结/排序/理由及正式任务持久化已交付。下一步为匹配分页/详情与公共查询接口，再按04—10方案接页面；PRODUCT-003结构化编辑体验和真实产品录入仍待完成。演示产品联调不解除真实产品资料、外部核验和业务金标准验收的依赖。
|
||||
发布预检、字段编译、目录冻结/排序/理由及正式任务持久化已交付。匹配分页/详情与公共详情、03/04/05/06基础现已接通（第8节）；下一步为07对比及09报告三栏；PRODUCT-003结构化编辑体验和真实产品录入仍待完成。演示产品联调不解除真实产品资料、外部核验和业务金标准验收的依赖。
|
||||
|
||||
## 6. 产品发布JSON与字段编译（本轮已实现）
|
||||
|
||||
@@ -193,4 +193,51 @@ compile(product,dictionary)不读当前时间，返回来源、字典、规范
|
||||
|
||||
`tests/product_matching.php`纯内存验证目录筛选、冻结摘要、排序、理由引用、来源门槛和配置失败；`tests/product_matching_tasks.php --worker-stopped`使用本地演示目录及随机合成账户/假模型验证正式提交、落库、重试、旧引擎、损坏快照和归属。后者预期6条初始演示参数；运营修改后需要同步业务金标准，不能自动覆盖产品凑测试。测试结束只清理本次账户/评估/会话/队列，6条演示产品按用户要求保留。
|
||||
|
||||
正式接口的matches分页/详情、公共产品查询、单产品AI解释及04—10页面仍待后续开发；当前报告页显示真实规则统计，不能据此宣称整个匹配页面已经验收。
|
||||
本阶段之后的匹配只读API及页面进展见第8节；单产品AI解释、公共产品列表、07—10扩展和真实产品验收仍待完成。
|
||||
|
||||
## 8. 匹配读取与页面消费（2026-09-24已实现）
|
||||
|
||||
### 8.1 接口、鉴权与分页
|
||||
|
||||
统一前缀`/api/v1`，全部要求`Authorization: Bearer <token>`，响应沿用`{code,msg,time,data}`并禁止缓存。以下GET只读，不创建评估、调用DeepSeek或重新计算匹配；重复读取只可能更新当前可用性。
|
||||
|
||||
| 方法和路径 | 参数/类型 | 响应data | 关键错误 |
|
||||
| --- | --- | --- | --- |
|
||||
| GET /assessments/:id/matches | id正整数字符串；eligibility为eligible/ineligible/unknown，默认eligible；limit查询字符串1—50，默认3；cursor可省略/空字符串 | assessmentId:string、resultVersion:number、matching、items:MatchResult[]、hasMore:boolean、nextCursor:string/null | 401未登录；404非本人/软删除/ID无效；409报告未完成/格式不可用/匹配损坏；422参数/游标错误 |
|
||||
| GET /assessments/:id/matches/:productId | 两ID均为正整数字符串，无请求体 | assessmentId、resultVersion、matching、item:MatchResult | 404 MATCH_NOT_FOUND表示不在本次快照；其他鉴权/状态错误同列表；不回退公共详情 |
|
||||
| GET /products/:id | 当前产品ID；无个人评估参数 | 当前公共Product DTO及rulesByApplicantType | 401未登录；404 PRODUCT_NOT_FOUND表示未发布/不在有效期/不存在；409 PRODUCT_CONFIGURATION_INVALID表示发布资料损坏 |
|
||||
|
||||
列表拒绝未知查询字段、数组参数和非法limit。先验证所有者，再解析游标，不泄露他人评估是否有匹配结果。游标使用既有AES-GCM加密方案，绑定userId、assessmentId、resultVersion、冻结结果摘要、eligibility及offset；不是页码，不由前端拼接，换组必须丢弃。结果更改、跨评估、跨组或篡改返回422 `MATCH_CURSOR_INVALID`，客户端从首屏重读。当前产品状态不进入摘要，产品下架不会令分页失效。
|
||||
|
||||
已匹配但无符合项时`status=completed,candidateCount=0`；未执行时`status=unavailable`、三组统计为null、items空数组，均返回200。v1成功报告返回`LEGACY_INPUT`；既有v2未匹配报告不补算。损坏的匹配列表、重复产品、非法rank/score、统计不一致或错误证据引用返回409 `MATCH_RESULT_UNAVAILABLE`，不以空数组掩盖损坏。
|
||||
|
||||
未执行匹配的data示例（ID仅为示意）：
|
||||
|
||||
```json
|
||||
{
|
||||
"assessmentId": "100",
|
||||
"resultVersion": 1,
|
||||
"matching": {
|
||||
"status": "unavailable", "reasonCode": "LEGACY_INPUT",
|
||||
"ruleVersion": null, "orderingPolicyVersion": null, "catalogSnapshotId": null,
|
||||
"candidateCount": null, "ineligibleCount": null, "unknownCount": null
|
||||
},
|
||||
"items": [], "hasMore": false, "nextCursor": null
|
||||
}
|
||||
```
|
||||
|
||||
### 8.2 字段投影、金额与历史
|
||||
|
||||
MatchResult沿用数据契约第5节：productId、productVersion、eligibility、rank、score、scorePolicyVersion、reasons、positiveReasons、blockingReasons、cautions、evidence、aiExplanation、productSnapshot，新增实时读取的currentAvailability（available/unavailable/unknown）。score无已发布评分策略时为null；rank仅eligible有值，不能渲染成百分比或审批概率。所有理由/evidenceRefs只关联本项证据；接口显式投影字段，不返回analysis_context、姓名、证件号码或未声明内部字段。
|
||||
|
||||
productSnapshot包含产品ID/版本/名称/机构/类型，amountMinYuan、amountMaxYuan（元的两位小数字符串）、termMinMonths/termMaxMonths（整数月）、annualRateMinPercent/annualRateMaxPercent（百分数字符串）、isDemo、applicantTypes、regions（空数组表示全国）、validFrom/validUntil（日期）、capturedAt、source（publisher/title/reference/checkedOn）、rules、information/condition及创建/更新时间。客户端仅在显示时转万元，例如`"123456.78"`元显示`12.345678 万元`；个人事实金额也按此规则。
|
||||
|
||||
公共DTO使用当前发布条件rulesByApplicantType按主体分组，不返回eligibility、rank、score、个人理由/事实/证据。repaymentMethod、channel、approvalDuration在两种产品DTO均为null，当前页面显示“未提供”；不得从演示或自由文本猜值。公共详情不等于公共产品列表，GET /products尚未实现。
|
||||
|
||||
当前可用性通过一次受限ID集合查询读取，避免逐项查询。下架、删除、未到生效日或过期为unavailable；目录查询异常为unknown；历史快照仍可读。不会把产品当前版本/额度拼回历史详情。AI解释目前not_requested，前端明确提示尚未生成，保留完整确定性规则理由；失败时的提示分支已预留，真实生成与计费/重试待后续任务。
|
||||
|
||||
### 8.3 页面与验收边界
|
||||
|
||||
报告入口携带assessmentId；列表三组统计与分页来自同次结果；卡片只预览最多三条主要理由，详情保留全部不符/待核实理由，已满足项可展开。无评估编号时选择历史或重新评估；非法编号明确错误，绝不读取最近结果。详情无assessmentId只展示公共资料，有assessmentId始终读取本人快照。页面离开清空结果，响应返回时校验当前Token和请求序号，防止旧账户迟到响应恢复界面。
|
||||
|
||||
本轮`tests/match_records.php --worker-stopped`62项验证接口身份/方法、三组、游标分页和篡改、快照归属、未知键投影、损坏数据、下架/过期/删除/改价后历史、旧版报告、重复读取无副作用。产品变化只在测试连接事务内发生并回滚，随机账户及队列清理；停止正式worker以避免恢复扫描拾取合成评估。浏览器结果及截图见开发进度6.13。
|
||||
|
||||
Reference in New Issue
Block a user