feat(融资): 新增产品对比页面及相关接口实现
新增产品对比页面 compare/compare,支持同一评估下最多3个产品的横向对比,展示额度、期限、利率、适用条件等核心指标及匹配详情。 新增 matches.uts 服务层,封装匹配列表、详情、公共产品查询接口。 新增 account 分包的 latest-report.uts 服务,用于查找用户最新成功报告。 调整个人中心页面,将“评估记录”改为“开始评估”,新增最近报告直达功能。 更新文档,标记匹配相关接口及原型07、09页面已实现,调整页面数量至26页。 移除 finance 分包中旧的 fetchMatches、fetchProduct 模拟数据接口,统一使用正式API。
This commit is contained in:
+36
-12
@@ -1,11 +1,11 @@
|
||||
# 原型04—10页面改造与跳转方案
|
||||
|
||||
版本:1.0。日期:2026-09-24。依据:[原型图](原型.jpg)、[开发文档](开发文档.md)、[数据契约](需求与评估结果数据契约.md)。本轮用户明确要求补齐04—10页面并随后进入产品匹配开发;此前“对比/PDF另行排期”的范围限制,自本方案起由下列正式任务覆盖。
|
||||
版本:1.3。日期:2026-09-28。依据:[原型图](原型.jpg)、[开发文档](开发文档.md)、[数据契约](需求与评估结果数据契约.md)。本轮用户明确要求补齐04—10页面并随后进入产品匹配开发;此前“对比/PDF另行排期”的范围限制,自本方案起由下列正式任务覆盖。
|
||||
|
||||
## 1. 范围与落地原则
|
||||
|
||||
- 04、05是同一产品匹配详情的不同判定状态,06是同一详情页的产品信息栏;复用现有product/product,不机械新增三个页面。
|
||||
- 07产品对比、10下一步行动新增两个融资分包页面。当前pages.json仍注册25页,实施后目标27页;本文中的新增路由尚未注册。
|
||||
- 07产品对比、10下一步行动新增两个融资分包页面。compare已注册,当前pages.json共26页;next-step仍待开发注册,最终目标27页。
|
||||
- 08复用assistant/assistant;09复用report/report并改为“评估概况/匹配结果/改善建议”。03匹配列表作为04—10的必要入口一并改造。
|
||||
- 保留蓝白主色、卡片、银行标识、正反理由分组和清晰底部行动区。数据必须来自本人本次评估;原型的92%/B+不作为默认值。
|
||||
- 首版使用既有三态准入:符合已知条件、条件不符、待核实。score=null,不展示匹配百分比;稳定顺序采用productId升序并注明不代表优劣。真实评分、运营优先级另发版本化策略。
|
||||
@@ -17,12 +17,12 @@
|
||||
|
||||
| 原型 | 页面实现 | 页面内容与行为 | 任务 | 当前状态 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| 04 单家银行AI解释 | product/product,tab=explanation,eligible状态 | 银行/产品名、条件判定、已满足条件、注意事项、证据来源、AI解释、对比/准备申请 | PRODUCT-004 | 待开发;现有公共详情不含个性化解释 |
|
||||
| 05 其他银行不推荐解释 | 同一页面,ineligible或unknown状态 | 不符条件与待核实项分组;已满足部分称“已满足条件”;查看资料/询问AI,不建议直接申请 | PRODUCT-004 | 待开发;服务端判定决定状态,不接受URL指定“推荐” |
|
||||
| 06 产品详情 | product/product,tab=details或conditions | 额度/期限/年化利率范围、还款方式、材料、渠道、适用对象、来源及版本;独立显示当前可用性 | PRODUCT-003、PRODUCT-004 | 基础页面已有;真实资料和快照接口待接 |
|
||||
| 07 同类产品对比 | 新增compare/compare | 同一评估2—3个产品列式对比,首列指标固定,移动端横向滚动;条件判定、金额/利率/期限、材料、差异依据 | PRODUCT-005 | 新增任务,未开始 |
|
||||
| 04 单家银行AI解释 | product/product,tab=explanation,eligible状态 | 银行/产品名、条件判定、已满足条件、注意事项、证据来源、AI解释、对比/准备申请 | PRODUCT-004 | 基础已接规则理由/证据/历史快照及对比;单产品AI解释和行动页待开发 |
|
||||
| 05 其他银行不推荐解释 | 同一页面,ineligible或unknown状态 | 不符条件与待核实项分组;已满足部分称“已满足条件”;查看资料/询问AI,不建议直接申请 | PRODUCT-004 | 已接不符/待核实及证据;AI咨询待接;服务端判定决定状态 |
|
||||
| 06 产品详情 | product/product,tab=details或conditions | 额度/期限/年化利率范围、还款方式、材料、渠道、适用对象、来源及版本;独立显示当前可用性 | PRODUCT-003、PRODUCT-004 | 已接三栏、公共/历史双模式及当前可用性;真实机构资料待录入 |
|
||||
| 07 同类产品对比 | 新增compare/compare | 同一评估2—3个产品列式对比,首列指标固定,移动端横向滚动;条件判定、金额/利率/期限、材料、差异依据 | PRODUCT-005 | 基础完成,本地联调通过;真实产品及平台待验收 |
|
||||
| 08 AI助手延伸问答 | assistant/assistant | 本次评估及选定产品上下文卡、按实际判定生成快捷问题、持久会话、分页、重试、返回报告/产品 | CHAT-001—004 | 页面已有;真实上下文问答待接 |
|
||||
| 09 我的融资报告 | report/report | 三栏内容、资料准备状态、完整度、最多三个候选及查看更多、改善项、PDF下载、重新评估、下一步行动 | REPORT-004、REPORT-005 | 自填报告已有;三栏/产品/PDF待开发 |
|
||||
| 09 我的融资报告 | report/report | 三栏内容、资料准备状态、完整度、最多三个候选及查看更多、改善项、PDF下载、重新评估、下一步行动 | REPORT-004、REPORT-005 | 三栏/历史候选/改善证据基础已联调;PDF及行动入口待独立任务 |
|
||||
| 10 下一步行动 | 新增next-step/next-step | 准备申请、查看已保存报告、下载PDF、优化资料、咨询AI、回首页;依结果决定可用行动 | REPORT-006 | 新增任务,未开始 |
|
||||
|
||||
### 03 匹配列表入口(必要配套)
|
||||
@@ -30,7 +30,7 @@
|
||||
1. 入口必须携带assessmentId。无编号时引导选择历史评估或开始评估,不能展示固定产品。
|
||||
2. 默认eligible最多三条;“查看更多”读取同一冻结结果分页。独立提供“条件不符”“待核实”分组及各组真实计数。
|
||||
3. matching=unavailable时说明尚未执行,completed且零候选说明已执行但没有候选,failed从任务状态页展示;三者不可共用“完善资料再试”。
|
||||
4. 卡片进入产品解释栏;“加入对比”不触发卡片跳转。选择限2—3项,切换评估清空选择,仅在当前页面内存保留。
|
||||
4. 卡片进入产品解释栏;“加入对比”不触发卡片跳转。选择限2—3项,选择ID仅在同一账户会话/评估的内存保留,跨页通过productIds传递;切换评估或会话清空内存选择,对比刷新按URL重新鉴权。
|
||||
5. 没有评分时移除当前score百分比和按score排序;金额和利率使用范围。金额、利率排序若后续提供,只改变展示顺序,不改历史rank。
|
||||
|
||||
### 04/05/06 产品详情的两种模式
|
||||
@@ -92,7 +92,7 @@
|
||||
| --- | --- | --- |
|
||||
| 03 | matches/matches?assessmentId=A&group=eligible | A必填;group允许eligible/ineligible/unknown,默认eligible |
|
||||
| 04/05/06 | product/product?assessmentId=A&productId=P&tab=explanation&from=matches | tab为explanation/details/conditions;带A必须读匹配快照;无A默认details;旧id仅作productId兼容,冲突时拒绝 |
|
||||
| 07 | compare/compare?assessmentId=A&productIds=P1,P2,P3 | A必填、ID去重后仍须2—3项;1项仅进入补选状态;不能跨评估 |
|
||||
| 07 | compare/compare?assessmentId=A&productIds=P1,P2,P3 | A必填,正式对比2—3项;重复ID直接报错,不静默去重;0/1项仅补选状态;不能跨评估 |
|
||||
| 08 | assistant/assistant?assessmentId=A&productIds=P1,P2&chatId=C&from=compare | A可选;productIds要求A;chatId可选且归属/上下文需一致;从首页进入允许无评估的普通问答 |
|
||||
| 09 | report/report?assessmentId=A&tab=overview | tab为overview/matches/improvements,默认overview;v1能力不足时解释原因 |
|
||||
| 10 | next-step/next-step?assessmentId=A&productId=P§ion=prepare | A必填,P可选;section为actions/prepare,默认actions;无P的prepare引导选择,不猜测产品 |
|
||||
@@ -133,9 +133,9 @@ flowchart TD
|
||||
| --- | --- | --- |
|
||||
| GET /api/v1/assessments/:id/status | 已实现 | 状态/重试边界,不把queued当模型运行 |
|
||||
| GET /api/v1/assessments/:id/report | 已实现自填v1/v2 | 09/10真实来源;产品区块随匹配扩展,不回填旧报告 |
|
||||
| GET /api/v1/assessments/:id/matches | 计划新增 | 03/09,三态分页、默认limit=3;既有契约字段不变 |
|
||||
| GET /api/v1/assessments/:id/matches/:productId | 计划新增 | 04/05/06,以及07每次最多读取三项;本人成功记录、本次冻结产品,404不得回退公共数据 |
|
||||
| GET /api/v1/products/:id | 计划新增 | 06公共模式;不含个人判定及理由,当前资料与历史快照分开 |
|
||||
| GET /api/v1/assessments/:id/matches | 已实现 | 03/09,三态分页、默认limit=3;既有契约字段不变 |
|
||||
| GET /api/v1/assessments/:id/matches/:productId | 已实现 | 04/05/06,以及07每次最多读取三项;本人成功记录、本次冻结产品,404不得回退公共数据 |
|
||||
| GET /api/v1/products/:id | 已实现,会员Bearer | 06公共模式;不含个人判定及理由,当前资料与历史快照分开 |
|
||||
| POST /api/v1/assistant/chats | 计划新增 | contextAssessmentId:string或null、contextProductIds:string[]、requestId;服务端校验同一评估和产品快照,不接客户端报告正文 |
|
||||
| GET/POST /api/v1/assistant/chats/:id/messages | 计划新增 | 08消息分页、提交与幂等;上下文由会话固定 |
|
||||
| GET /api/v1/assessments/:id/report.pdf | 计划新增,REPORT-005 | Bearer鉴权;成功application/pdf,Content-Disposition安全文件名、no-store;401/404/409/503为JSON错误;失败不生成报告或调用模型 |
|
||||
@@ -181,3 +181,27 @@ PDF接口owner校验先于渲染,未完成返回409 REPORT_NOT_READY,格式
|
||||
- 10没有银行申请提交;优化资料只创建新评估,历史和原报告不变;无草稿恢复。
|
||||
- 真实产品/渠道未就绪时只使用合成样例验证,不发布示例产品,不把原型中的固定排名与等级当实际结果。
|
||||
- 普通手机H5、桌面H5、微信内浏览器分别记录;PDF中文分页、长理由、无产品、历史下架、大字号/横向表格需要独立证据。
|
||||
|
||||
## 8. 2026-09-24 本轮落地与剩余边界
|
||||
|
||||
03列表与04/05/06三栏已使用正式只读API,报告提供入口;卡片不使用模拟百分比,未知与不符单列。公共模式不展示个人匹配,带assessmentId始终读取本人快照,失败不降级。单产品AI解释暂为not_requested;“查看资料准备说明”只切到条件栏,10页尚未创建。已验证手机/桌面、刷新同一评估、三态详情、公共资料、无ID引导及越权。
|
||||
|
||||
当前返回会重新读取首屏,不保证保留原滚动位置;group/tab按URL初始参数恢复,栏内切换尚不写URL;登录失效返回登录但尚无原路恢复。from尚不参与导航决策,不接收returnUrl。后续按第3节完善导航体验。07对比、08上下文助手、09三栏/PDF、10行动保持未开始/待开发,不将基础接入等同全04—10验收。
|
||||
|
||||
## 7. 2026-09-28 原型07实施记录
|
||||
|
||||
compare/compare已注册,当前26页。列表加入对比阻止卡片冒泡;最多选择3项且保留顺序,可跨三态分组选择;详情带本次选择进入对比。补选/返回匹配带原ID集合,详情返回优先navigateBack,冷启动from=compare返回同次对比,其他来源回本次匹配;from按白名单校验。列表返回首屏及登录后自动原路恢复仍待完善。
|
||||
|
||||
每列读取本人冻结详情并校验assessmentId/产品ID;列间比较resultVersion、catalogSnapshotId、ruleVersion、orderingPolicyVersion。版本冲突、404和网络失败都不会补用公共资料;单列可重试,不完整结果明确提示。重复或超过3项、非法ID不发请求。0/1项提供补选,移除通过redirectTo替换URL,刷新不恢复已移除的ID。
|
||||
|
||||
首列在横向滚动区外固定;各行等高,长文本/表头内部纵向滚动,避免错行和长标题遮挡。桌面列宽扩展到可用空间;App保留受支持的rpx尺寸。金额仍精确转万元,缺失范围显示未提供;状态和三类理由直接来自规则结果,无新增评分或AI生成解释。
|
||||
|
||||
本地验证和剩余边界见[开发进度6.16](开发进度.md)。07基础不代表08上下文助手、09报告三栏/PDF、10行动页完成。
|
||||
|
||||
## 9. 2026-09-28 原型09三栏实施记录
|
||||
|
||||
report/report的overview/matches/improvements已接现有报告与匹配只读接口。切栏使用redirectTo更新URL,刷新重新鉴权,读取失败不跳最新评估;概况不提前请求产品。完整度进度条只用已保存百分比;生成时间按客户端当地时间展示,无时间标“未记录”;旧v1不補造需求或评分。没有候选与未执行匹配分别提示。
|
||||
|
||||
匹配栏默认eligible前3项,改善栏分别读取ineligible/unknown前3项,各有完整列表和产品详情入口,不把摘要当全部结果。关联产品证据直接展示规则理由、字段值和来源;AI改善文字保留报告中的字段/准备依据标签。读取时核对报告与列表的版本、目录标识及三态统计,异常保留其他可用区块并单独重试。
|
||||
|
||||
“重新评估”选择主体后清空流程内存进入空白表单,历史报告不编辑。PDF、下一步行动及上下文问答按钮待对应能力完成后接入。26页、63任务编号和历史估时不变;REPORT-004整体保持开发中,具体验证/剩余边界见[开发进度6.17](开发进度.md)。
|
||||
|
||||
Reference in New Issue
Block a user