root/airz-uniapp
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat(融资): 新增产品对比页面及相关接口实现

Browse Source 
新增产品对比页面 compare/compare，支持同一评估下最多3个产品的横向对比，展示额度、期限、利率、适用条件等核心指标及匹配详情。
新增 matches.uts 服务层，封装匹配列表、详情、公共产品查询接口。
新增 account 分包的 latest-report.uts 服务，用于查找用户最新成功报告。
调整个人中心页面，将“评估记录”改为“开始评估”，新增最近报告直达功能。
更新文档，标记匹配相关接口及原型07、09页面已实现，调整页面数量至26页。
移除 finance 分包中旧的 fetchMatches、fetchProduct 模拟数据接口，统一使用正式API。
This commit is contained in:
hujun
2026-09-28 14:56:46 +08:00
parent 26da91b337
commit 7c252fc730
20 changed files with 1605 additions and 403 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/产品匹配规则开发契约.md
+50 -3
View File
@@ -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。
docs/原型04-10页面改造与跳转方案.md
+36 -12
View File
@@ -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&section=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)。
docs/开发文档.md
+65 -20
View File
@@ -1,6 +1,6 @@
# AI 融资平台开发文档
> 版本：v1.9 · 基线日期：2026-09-22 · 更新日期：2026-09-24 · 状态：目录冻结、规则匹配和正式任务落库已接通；本地已上架6条演示产品，匹配接口及04—10页面待接
> 版本：v1.14 · 基线日期：2026-09-22 · 更新日期：2026-09-28 · 状态：匹配分页/详情及公共产品详情已接通；03/04/05/06基础接入，07对比与09报告三栏本地联调通过；08助手、09PDF、10行动待开发
> 配套台账：[开发进度](开发进度.md)。本文定义范围、接口和验收口径，台账记录实际执行与证据。
> 文档初始规划后已开始开发；以下更新记录优先于原始基线。除明确列为已实现的部分外，计划接口和增量数据仍待开发。
@@ -132,6 +132,50 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
报告页已从固定“未执行匹配”改为读取后端统计与演示提示。匹配列表/详情API、公共查询、单产品AI解释及04—10整体改造仍未交付，不能跳转现有模拟匹配页当真实结果。465项PHP检查通过，Web/Android编译通过，H5报告统计/刷新/历史导航通过；细节见台账6.12与[规则契约](产品匹配规则开发契约.md)第7节。
### 0.12 2026-09-24 匹配读取接口与03/04/05/06页面基础接入
已新增本人匹配分页、匹配详情、会员可读公共产品详情三个GET接口。读取既有快照，不重跑模型或规则；先验证评估归属与成功状态，再解析绑定账户/评估/结果摘要/分组的加密游标。当前产品下架、过期或删除只改变currentAvailability，历史参数与理由保持不变。公共详情不附个人判定、理由或事实。
报告新增“查看本次匹配与依据”；匹配列表展示三态分组、真实统计、默认三项分页、失败重试和演示标记；详情改为匹配解释/产品详情/申请条件三栏，金额及事实以万元展示，取消固定匹配百分比。已满足理由可展开，不符/待核实理由完整保留；AI解释未生成时明确提示。无评估入口引导历史或新评估，不猜测最近记录；越权不回退公共产品。
PRODUCT-004记为开发中，不能标整项完成：07对比、08上下文助手、09报告三栏/PDF、10行动页及单产品AI解释仍待开发。当前“查看资料准备说明”仅切换条件栏，不提交申请；返回重新鉴权读取列表首屏，精确滚动位置恢复与登录后原路返回待后续完善。真实产品资料/人工金标准及微信内H5、真机验收仍未完成。具体接口见规则契约第8节，验证见进度6.13。
### 0.13 2026-09-28 融资档案恢复原卡片布局
按用户确认，融资档案恢复个人/企业切换、完整度卡片和四组资料入口，新增历史记录选择；保留无草稿、提交后只读及多次评估分别存档的规则。默认展示所选类型的最新记录，可分页切换较早记录；显式assessmentId刷新后重新鉴权查看原记录，错误不回退到最新记录。数据分组展开查看，底部进入同次报告/分析状态或空白新评估。
完整度仅取本人成功报告的冻结percent，不从当前字段重算；无记录、旧版未计算、分析中/失败、未评定及读取错误使用“—”和对应说明，不能显示成0%。各组“已记录”仅指存在已提交字段，不等同该组完整或信用核验。资料与授权保持未开放。金额仍精确显示万元。代码位于archive/archive.uvue和services/records.uts，复用已有后端type过滤与读取API，本轮无后端业务修改、迁移或新增表。
### 0.14 2026-09-28 个人中心入口去重
个人中心顶部“评估记录/查看”改为图标+“开始评估”，先选择个人/企业，再进入对应融资入口；“评估报告/查看”改为图标+“最近报告”。菜单“我的融资档案”继续作为个人/企业历史、已提交资料和对应报告的管理入口。
最近报告通过已有GET /assessments?status=succeeded&limit=1查询本人所有类型中最近提交且已成功的记录，携带assessmentId直接打开报告；不被较新的未完成评估遮挡。无成功记录才查询status=processing&limit=1，提示“报告生成中”并可查看同次进度；两者都无则提示暂无报告，可发起评估，失败记录仍在融资档案查看。请求异常提示重试，不假装没有报告。查找不创建评估、不重跑分析、不缓存个人报告。
账户分包新增latest-report.uts服务，仅依赖共享请求，不跨包导入融资服务。未登录先登录，查找中防重复，离页/Token变化后丢弃迟到响应和弹窗回调。沿用既有edit-file/file-text图标，与积分中心统一样式，无新增页面或后端接口。
### 0.15 2026-09-28 原型07产品对比基础完成
PRODUCT-005新增compare页面，注册页数由25变为26。匹配列表与本次产品详情可选择最多3项，支持跨分组选择；正式对比需2—3项，0/1项仅作补选状态。URL按顺序保存assessmentId和productIds，移除会替换URL，刷新重新鉴权。选择ID只存在按账户会话/评估隔离的内存中，不新增草稿、持久个人缓存或数据表。
每列复用GET /assessments/:id/matches/:productId，最多三项并行；校验响应assessmentId、产品ID、resultVersion、catalogSnapshotId、ruleVersion和orderingPolicyVersion。错误列独立重试，版本不一致的列不展示参数，完整对比必须所有列读取成功。越权/不存在不回退公共产品，不重跑规则或模型；401清理显示并转登录，离页/会话变化丢弃迟到响应。
指标包括需求覆盖证据、额度、期限、年化利率、主体/地区、三类条件理由、准入规则、材料、还款方式、渠道、有效期与来源。历史参数和当前可用性分开显示，金额精确转万元，缺值显示未提供；未结构化的还款方式/渠道不猜测。首列固定，手机横向滚动，桌面列宽展开；长内容在单元格内滚动。当前仅提供详情/选择入口，不提供申请提交。
状态为待验收：本地编译及合成账户真实读取接口验证完成，真实机构产品签收、微信内H5/Safari与真机仍待验收。详细证据见开发进度6.16。下一步为REPORT-004报告三栏，PDF、上下文助手及行动页独立开发。
### 0.16 2026-09-28 原型09报告三栏基础完成
REPORT-004页面子项完成本地联调：report/report改为评估概况、匹配结果、改善建议。URL中的tab限定overview/matches/improvements，默认overview；切栏替换当前路由，刷新恢复栏目并重新鉴权读取本人报告，不创建评估或重跑模型。无前页时返回融资档案；产品与匹配入口始终携带当前assessmentId。
概况保留冻结需求、准备状态、真实完整度进度条、生成时间、自填来源、AI摘要/优势、风险与免责声明；事实及逐项完整度可展开。v1明确提示当时未采集/未计算，百分比显示“—”；v2未评定与实际0%分开，不用当前规则补算历史。
匹配栏从报告读取三态统计，复用GET /assessments/:id/matches?eligibility=eligible&limit=3展示最多3项候选，提供完整列表及不符/待核实入口。改善栏组合缺失/待核实字段、准备依据、已保存AI建议及不符/待核实分组各前3项产品证据，关联产品详情并标明摘要边界；没有依据不补造建议。不符条件仅解释现状，不承诺改善后获批。
报告与列表校验assessmentId、resultVersion、catalogSnapshotId、ruleVersion、orderingPolicyVersion及三态统计；不同版本不拼接。候选和两个建议分组分别加载/重试，局部失败不隐藏已保存报告，也不显示为零候选。按可见栏目请求，概况不请求产品；离页/Token变化丢弃旧响应，401清空内容并回登录。修复匹配列表返回时的卸载挂载冲突：先关闭内容渲染，再清空资料。
继续无草稿。“重新评估”选择个人/企业并清空当前流程内存，进入空白填写页；只有再次正式提交才创建新assessmentId。页面仍26个，未改后端业务、未迁移、未调用收费模型。PDF（REPORT-005）、下一步行动（REPORT-006）与上下文助手按独立任务推进，未展示虚假可用按钮。REPORT-004整体仍开发中，真实产品/外部渠道与微信内H5、真机尚未验收；证据见开发进度6.17。
## 1. 项目目标与现状
### 1.1 已确认范围
@@ -146,7 +190,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
| 项目 | 当前事实 | 规划用途 |
| --- | --- | --- |
| 前端 | uni-app x / Vue 3 / UTS，25 页，无独立 npm 构建入口 | 沿用 HBuilderX 和现有分包，不重新搭建前端 |
| 前端 | uni-app x / Vue 3 / UTS，26 页，无独立 npm 构建入口 | 沿用 HBuilderX 和现有分包，不重新搭建前端 |
| 后端 | FastAdmin / ThinkPHP 5.0.28 / PHP 7.4 | 复用认证、后台、模型与队列依赖，新增业务 API/服务 |
| 数据库 | MySQL 8.0.44，删除空 Token 表后实际 25 张 InnoDB 表 | 已核对本地库并更新结构快照；恢复点见进度第0节 |
| 当前前端模式 | 开发环境已连接本地 v1 API，模拟请求开关关闭 | 密码账户流程已接入，内容与产品匹配等页面仍有原型数据，不按页面数计算完成度 |
@@ -173,9 +217,9 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
## 2. 页面与功能覆盖
路由以 [pages.json](../pages.json) 为准。以下覆盖现有全部 25 页；反馈表单、历史列表等优先补入所属现有页面，若交互确需新增页面，在所属分包注册并同步台账。
路由以 [pages.json](../pages.json) 为准。以下覆盖现有全部 26 页；反馈表单、历史列表等优先补入所属现有页面，若交互确需新增页面，在所属分包注册并同步台账。
原型04—10新增路由仅属计划，尚未注册：`packages/finance/compare/compare`（PRODUCT-005）与`packages/finance/next-step/next-step`（REPORT-006）；目标共27页。04/05/06均复用product/product，报告PDF不另加页面。参数与返回矩阵见专项页面方案第3节。
原型07路由`packages/finance/compare/compare`（PRODUCT-005）已注册，现共26页；`packages/finance/next-step/next-step`（REPORT-006）待开发注册，目标共27页。04/05/06均复用product/product，报告PDF不另加页面。参数与返回矩阵见专项页面方案第3节。
| 序号 | 页面路由 | 功能职责 | 主要任务 |
| --- | --- | --- | --- |
@@ -204,6 +248,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
| 23 | packages/content/article/article | 新闻、协议和说明内容 | CONTENT-001、CONTENT-002、FILE-003 |
| 24 | packages/content/classroom/classroom | 课程分类和推荐 | CONTENT-002 |
| 25 | packages/content/lesson/lesson | 图文章节、学习状态 | CONTENT-001、CONTENT-003 |
| 26 | packages/finance/compare/compare | 同次评估2—3产品冻结结果对比、补选及独立重试 | PRODUCT-005 |
## 3. 数据与架构约定
@@ -311,7 +356,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 统一请求与账户专用请求，处理认证、业务错误、重复点击、加载/空态、401回跳；首页聚合公共内容与登录后状态。
- **后端：** 新路由显式绑定控制器和方法；解析JSON并逐字段校验，不能对结构化输入机械套用HTML转义；兼容旧Token入口但新客户端只发送Bearer。
- **数据：** 以userId建立账户缓存命名空间；旧草稿键清理，不提供导入；未提交内容只在当前流程内存中传递。
- **接口：** GET /home、GET /dictionaries，以及所有接口共用协议。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** GET /home、GET /dictionaries，以及所有接口共用协议。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 生产缺API地址直接报配置错误；禁止静默降级成demo。断网不删除服务端事实。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -347,7 +392,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 按微信内/普通浏览器/桌面浏览器展示受支持登录方式，处理跳出返回、取消和短信回退。
- **后端：** 服务端code/credential交换，state和回调防重放；已有账户绑定需账户证明，禁止按昵称自动合并。
- **数据：** 独立第三方身份关系以provider/appId/subject唯一；unionid仅在取得并验证适用范围后辅助绑定。
- **接口：** GET /auth/wechat/authorize、GET /auth/wechat/callback、POST /auth/oneclick、POST /auth/bind-phone。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** GET /auth/wechat/authorize、GET /auth/wechat/callback、POST /auth/oneclick、POST /auth/bind-phone。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 渠道授权失败不创建半登录会话；不支持的网络或浏览器回到短信；只有支持矩阵中场景通过才记完成。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -365,7 +410,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 资料类型、上传进度/失败重试、已上传列表、协议全文、授权状态和撤销入口。
- **后端：** 私有文件服务、归属/MIME/内容/大小校验、鉴权下载、协议版本和授权事件；评估提交时由服务端形成快照。
- **数据：** 复用附件表与评估JSON；协议修订和独立授权事件保留历史；文件保留/删除期限在DEC-PRIVACY定稿。
- **接口：** POST /documents、GET/DELETE /documents/:id、GET /agreements/:code、GET/POST /consents、POST /consents/:id/revoke。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** POST /documents、GET/DELETE /documents/:id、GET /agreements/:code、GET/POST /consents、POST /consents/:id/revoke。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 临时路径、他人附件、无效授权全部拒绝；可选资料不强迫提交；撤销后停止新查询，历史留存按已确认规则处理。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -401,7 +446,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 展示实际可用查询种类、授权状态、查询中/成功/失败/拒绝/撤销，不把选择框当查询完成。
- **后端：** 服务商适配、签名、异步状态、回调验签/去重、对账、费用状态；原始证件标识只在必要服务端流程使用。
- **数据：** 查询记录与评估/用户/授权绑定；必要结果加密或私有存储；输入冻结后只追加查询事件。
- **接口：** GET/POST /assessments/:id/data-queries、GET /data-queries/:id、POST /callbacks/data/:provider。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** GET/POST /assessments/:id/data-queries、GET /data-queries/:id、POST /callbacks/data/:provider。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 超时收费不明先查渠道状态；未取得或已撤销授权不新调用；缺失数据标未知，不能伪装征信正常。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -419,7 +464,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 拆Product与MatchResult；显示范围而非单点额度/利率；保持历史快照并提示当前产品状态。
- **后端：** 确定性规则、白名单操作符、类型校验、版本化排序；只推荐状态/有效期/地区及硬条件满足的产品。
- **数据：** 产品独立字段+regions/eligibility_rules；个性化分数和理由放match_result，快照含产品版本。
- **接口：** GET /products、GET /products/:id、GET /assessments/:id/matches；后台沿用产品CRUD并补运营校验。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** GET /products、GET /products/:id、GET /assessments/:id/matches；后台沿用产品CRUD并补运营校验。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 暂无匹配是合法完成结果；规则未知不执行任意表达式；产品下架不删除历史快照。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -438,7 +483,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 轮询真实状态、刷新恢复、失败重试；渲染数据驱动维度、来源时间和版本；查看历史。
- **后端：** DeepSeek适配、结构校验、任务抢占/超时/漏投补偿、输入最小化、用量记录；在事务中同时落报告、匹配和成功状态。
- **数据：** result_version/rule_version/model与产品快照分别记录；模型输出不能覆盖金额、硬准入或数据来源。
- **接口：** GET /assessments/:id/status、GET /assessments/:id/report；内部worker调用complete/fail，不公开完成接口。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** GET /assessments/:id/status、GET /assessments/:id/report；内部worker调用complete/fail，不公开完成接口。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 模型输出错误/配额不足/队列故障进入可追踪失败；重试不允许旧taskId回写；供应商超时可能计费，不承诺外部零重复收费。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -458,7 +503,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 创建/切换/恢复会话、分页历史、发送状态、异步回复轮询与重试；保留requestId。
- **后端：** DeepSeek对话、上下文裁剪、所有者校验、消息和本地额度幂等；用户输入不可触发任意管理操作。
- **数据：** 普通scene的assessment_id保持NULL；context_assessment_id只引用本人可访问评估；工具结果记录来源。
- **接口：** POST/GET /assistant/chats、GET/POST /assistant/chats/:id/messages、GET /assistant/messages/:id、POST /assistant/messages/:id/retry。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** POST/GET /assistant/chats、GET/POST /assistant/chats/:id/messages、GET /assistant/messages/:id、POST /assistant/messages/:id/retry。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 失败消息保留错误和可重试状态；切换账号不带上旧会话；渠道取消不能保证停止已发生计费，一期不要求生成中强制取消。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -476,7 +521,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 新闻、文章、课堂、课程页接真实分页/详情；处理404/下架，搜索竞态和章节完成状态。
- **后端：** 发布/下架、富文本清洗、分类与首页推荐、搜索和FAQ；稳定章节ID与进度幂等。
- **数据：** 复用fa_acticle/fa_finance；章节数据结构化；用户章节完成关系独立存储；不引入视频和付费课程。
- **接口：** /content/articles、/content/lessons、/content/lessons/:id/progress、/content/search、/help/faqs。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** /content/articles、/content/lessons、/content/lessons/:id/progress、/content/search、/help/faqs。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 未发布内容不可访问；新增/重排章节不沿用索引作为进度ID；搜索慢响应不得覆盖新查询。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -494,7 +539,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 分类分页、未读数、已读/全部已读、与正确评估记录跳转。
- **后端：** 在业务事务完成后可靠生成通知，事件唯一键去重；读取和更新均限定当前用户。
- **数据：** 复用fa_user_message，补事件唯一键；is_read和read_at同步；全部已读采用最大ID水位。
- **接口：** GET /messages、GET /messages/unread-count、POST /messages/:id/read、POST /messages/read-all。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** GET /messages、GET /messages/unread-count、POST /messages/:id/read、POST /messages/read-all。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 队列重试不重复通知；全部已读期间新增消息仍未读；本期站内消息不等同App推送。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -512,7 +557,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 真实积分、流水、服务端签到状态、邀请码和任务进度，显示已发布规则版本。
- **后端：** 积分事务和并发锁、日期与任务幂等、防自邀、可信事件奖励；错误需向业务层传播。
- **数据：** 复用score及score_log，明确business_type/business_id；邀请码唯一、受邀用户一次绑定。
- **接口：** GET /points、GET /points/ledger、POST /points/check-in、GET /points/tasks、GET /invitations、POST /invitations/bind。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** GET /points、GET /points/ledger、POST /points/check-in、GET /points/tasks、GET /invitations、POST /invitations/bind。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 默认保留每日签到10分作为待业务确认建议；其他奖励金额不编造。复制文案或客户端上报完成不直接发积分。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -530,7 +575,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 反馈表单/附件/记录/回复；客服在线/排队/离线状态及失败回退。
- **后端：** 反馈归属与后台处理、服务端访客签名、客服会话关联；外部系统消息遵循渠道身份规则。
- **数据：** 复用fa_feedback补处理结果；不把反馈图片当公共文件；客服历史优先由供应商维护。
- **接口：** POST/GET /feedback、GET /feedback/:id、POST /support/session。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** POST/GET /feedback、GET /feedback/:id、POST /support/session。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 无坐席能留言且后台有责任人；SDK失败提示可使用站内反馈；退出切换账号清理客服身份。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -548,7 +593,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** FastAdmin后台增加任务、模型额度、查询状态和运营入口，非移动端新增主导航。
- **后端：** 角色授权、敏感字段掩码、任务/查询定位、受控重试和审计；不允许手改已提交评估输入及正式结果。
- **数据：** 复用管理员fa_auth_*；保留被删除会员组/规则表的删除状态；不恢复历史无关业务表。
- **接口：** 沿用后台路由与权限体系；不将管理查询、complete/fail或密钥管理暴露到用户API。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** 沿用后台路由与权限体系；不将管理查询、complete/fail或密钥管理暴露到用户API。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 权限不足不可越权；重试需要有效状态和当前taskId；日志不得输出证件或模型密钥。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -566,7 +611,7 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
- **前端：** 普通桌面/手机/微信内H5、上传/键盘/回跳/弱网、深链接和版本更新回归。
- **后端：** 全链路、并发、权限、真实渠道、迁移和恢复；部署队列守护及错误/费用监控。
- **数据：** 使用脱敏测试数据与独立环境；新增迁移先预检/备份/演练；禁止用旧备份覆盖新业务数据。
- **接口：** 对本章所有一期API及渠道执行自动与手动验收，记录版本、环境和证据。 具体方法和字段见第5章；均按计划新增/改造处理。
- **接口：** 对本章所有一期API及渠道执行自动与手动验收，记录版本、环境和证据。 具体方法和字段见第5章；匹配分页/详情、公共产品详情已实现，公共产品列表仍计划新增。
- **异常与边界：** 未完成任一必做能力不能标首发完成；生产配置不允许模拟Token、固定报告和占位协议。
| 任务编号 | 任务与交付范围 | 优先级 | 前置任务/外部条件 | 验收条件 | 人日 |
@@ -720,10 +765,10 @@ eligibility_rules完整格式、字段映射与发布限制见[产品规则契
| POST /callbacks/data/:provider | 渠道验签 | 供应商原始格式 | 供应商要求的ACK | 原始体验签、防重放、单号映射、幂等；不适用用户Bearer |
| GET /assessments/:id/report | 所有者 | 无 | Report（v1/v2自填版本） | 已实现；未成功409 REPORT_NOT_READY，不存在/越权404，旧结构409 REPORT_FORMAT_UNAVAILABLE；Cache-Control:no-store |
| GET /assessments/:id/report.pdf | 所有者 | 无 | application/pdf流；错误为JSON | 计划新增REPORT-005；401/404/409沿用报告语义，503 REPORT_EXPORT_UNAVAILABLE；no-store、安全文件名，不重跑模型 |
| GET /assessments/:id/matches | 所有者 | eligibility默认eligible、limit默认3上限50、cursor可空 | assessmentId、resultVersion、matching、items、hasMore、nextCursor | 计划新增，三态分组、冻结快照与游标绑定，见专项契约第5.3节；当前尚未实现 |
| GET /assessments/:id/matches/:productId | 所有者 | 无 | 该次匹配结果、理由、证据和快照 | 计划新增；只读本次已评估项；越权/快照无该产品404；不从当前公共产品拼历史 |
| GET /assessments/:id/matches | 所有者 | eligibility默认eligible、limit默认3上限50、cursor可空 | assessmentId、resultVersion、matching、items、hasMore、nextCursor | 已实现；三态分组、冻结快照与游标绑定，见专项契约第5.3节和规则契约第8节 |
| GET /assessments/:id/matches/:productId | 所有者 | 无 | 该次匹配结果、理由、证据和快照 | 已实现；只读本次已评估项；越权/快照无该产品404；不从当前公共产品拼历史 |
| GET /products | 公开 | type/regionCode可选、page/pageSize | Product分页 | 仅当前有效上架产品；不返回用户分数 |
| GET /products/:id | 公开 | 无 | Product | 下架/过期返回不可用语义；历史快照从本人匹配接口读取 |
| GET /products/:id | 会员Bearer | 无 | 公共产品DTO | 已实现；公共指不含个人结果，并非匿名；下架/过期404；历史快照从本人匹配接口读取 |
当前已实现自填分析支线（提交→数据库queued→Redis→DeepSeek→报告）；以下授权查询和产品规则主流程仍待实现：提交后检查授权 → 获取选定的外部结果 → 冻结查询引用 → 规则匹配 → DeepSeek解释 → 原子保存正式结果。未选择可选外部授权时使用自填资料并标记来源；已选择查询但失败时是否允许降级到自填，需要DEC-QUERY形成明确规则。该规则未定稿前，相应错误按失败处理，不静默忽略。
docs/开发进度.md
+153 -14
View File
@@ -1,6 +1,6 @@
# AI 融资平台开发进度
基线日期：2026-09-22。文档版本：1.9。最新规划及实施见0.11节与6.12节；此前章节保留阶段记录。技术方案和接口说明见[开发文档](./开发文档.md)。本台账现有63项任务，编号与开发文档保持一致。
基线日期：2026-09-22。文档版本：1.14。最新规划及实施见0.16节与6.17节；此前章节保留阶段记录。技术方案和接口说明见[开发文档](./开发文档.md)。本台账现有63项任务，编号与开发文档保持一致。
## 0. 2026-09-22 首轮实施更新（优先于初始基线）
@@ -131,6 +131,50 @@ PRODUCT-003进入开发中：新增ProductPublication及Product模型发布校
报告适配器已读取后端匹配统计和演示提示，后端465项检查通过，Web/Android编译及H5报告→刷新→历史导航通过。匹配列表/详情接口、04—10页面及真实业务验收仍待实施，未将整模块改为已完成。下一步先接只读匹配接口，再改造产品详情和匹配页面。
### 0.12 2026-09-24 匹配读取接口与03/04/05/06页面基础接入
已新增本人匹配分页、匹配详情、会员可读公共产品详情三个GET接口。读取既有快照，不重跑模型或规则；先验证评估归属与成功状态，再解析绑定账户/评估/结果摘要/分组的加密游标。当前产品下架、过期或删除只改变currentAvailability，历史参数与理由保持不变。公共详情不附个人判定、理由或事实。
报告新增“查看本次匹配与依据”；匹配列表展示三态分组、真实统计、默认三项分页、失败重试和演示标记；详情改为匹配解释/产品详情/申请条件三栏，金额及事实以万元展示，取消固定匹配百分比。已满足理由可展开，不符/待核实理由完整保留；AI解释未生成时明确提示。无评估入口引导历史或新评估，不猜测最近记录；越权不回退公共产品。
PRODUCT-004记为开发中，不能标整项完成：07对比、08上下文助手、09报告三栏/PDF、10行动页及单产品AI解释仍待开发。当前“查看资料准备说明”仅切换条件栏，不提交申请；返回重新鉴权读取列表首屏，精确滚动位置恢复与登录后原路返回待后续完善。真实产品资料/人工金标准及微信内H5、真机验收仍未完成。具体接口见规则契约第8节，验证见进度6.13。
### 0.13 2026-09-28 融资档案恢复原卡片布局
按用户确认，融资档案恢复个人/企业切换、完整度卡片和四组资料入口，新增历史记录选择；保留无草稿、提交后只读及多次评估分别存档的规则。默认展示所选类型的最新记录，可分页切换较早记录；显式assessmentId刷新后重新鉴权查看原记录，错误不回退到最新记录。数据分组展开查看，底部进入同次报告/分析状态或空白新评估。
完整度仅取本人成功报告的冻结percent，不从当前字段重算；无记录、旧版未计算、分析中/失败、未评定及读取错误使用“—”和对应说明，不能显示成0%。各组“已记录”仅指存在已提交字段，不等同该组完整或信用核验。资料与授权保持未开放。金额仍精确显示万元。代码位于archive/archive.uvue和services/records.uts，复用已有后端type过滤与读取API，本轮无后端业务修改、迁移或新增表。
### 0.14 2026-09-28 个人中心入口去重
个人中心顶部“评估记录/查看”改为图标+“开始评估”，先选择个人/企业，再进入对应融资入口；“评估报告/查看”改为图标+“最近报告”。菜单“我的融资档案”继续作为个人/企业历史、已提交资料和对应报告的管理入口。
最近报告通过已有GET /assessments?status=succeeded&limit=1查询本人所有类型中最近提交且已成功的记录，携带assessmentId直接打开报告；不被较新的未完成评估遮挡。无成功记录才查询status=processing&limit=1，提示“报告生成中”并可查看同次进度；两者都无则提示暂无报告，可发起评估，失败记录仍在融资档案查看。请求异常提示重试，不假装没有报告。查找不创建评估、不重跑分析、不缓存个人报告。
账户分包新增latest-report.uts服务，仅依赖共享请求，不跨包导入融资服务。未登录先登录，查找中防重复，离页/Token变化后丢弃迟到响应和弹窗回调。沿用既有edit-file/file-text图标，与积分中心统一样式，无新增页面或后端接口。
### 0.15 2026-09-28 原型07产品对比基础完成
PRODUCT-005新增compare页面，注册页数由25变为26。匹配列表与本次产品详情可选择最多3项，支持跨分组选择；正式对比需2—3项，0/1项仅作补选状态。URL按顺序保存assessmentId和productIds，移除会替换URL，刷新重新鉴权。选择ID只存在按账户会话/评估隔离的内存中，不新增草稿、持久个人缓存或数据表。
每列复用GET /assessments/:id/matches/:productId，最多三项并行；校验响应assessmentId、产品ID、resultVersion、catalogSnapshotId、ruleVersion和orderingPolicyVersion。错误列独立重试，版本不一致的列不展示参数，完整对比必须所有列读取成功。越权/不存在不回退公共产品，不重跑规则或模型；401清理显示并转登录，离页/会话变化丢弃迟到响应。
指标包括需求覆盖证据、额度、期限、年化利率、主体/地区、三类条件理由、准入规则、材料、还款方式、渠道、有效期与来源。历史参数和当前可用性分开显示，金额精确转万元，缺值显示未提供；未结构化的还款方式/渠道不猜测。首列固定，手机横向滚动，桌面列宽展开；长内容在单元格内滚动。当前仅提供详情/选择入口，不提供申请提交。
状态为待验收：本地编译及合成账户真实读取接口验证完成，真实机构产品签收、微信内H5/Safari与真机仍待验收。详细证据见开发进度6.16。下一步为REPORT-004报告三栏，PDF、上下文助手及行动页独立开发。
### 0.16 2026-09-28 原型09报告三栏基础完成
REPORT-004页面子项完成本地联调：report/report改为评估概况、匹配结果、改善建议。URL中的tab限定overview/matches/improvements，默认overview；切栏替换当前路由，刷新恢复栏目并重新鉴权读取本人报告，不创建评估或重跑模型。无前页时返回融资档案；产品与匹配入口始终携带当前assessmentId。
概况保留冻结需求、准备状态、真实完整度进度条、生成时间、自填来源、AI摘要/优势、风险与免责声明；事实及逐项完整度可展开。v1明确提示当时未采集/未计算，百分比显示“—”；v2未评定与实际0%分开，不用当前规则补算历史。
匹配栏从报告读取三态统计，复用GET /assessments/:id/matches?eligibility=eligible&limit=3展示最多3项候选，提供完整列表及不符/待核实入口。改善栏组合缺失/待核实字段、准备依据、已保存AI建议及不符/待核实分组各前3项产品证据，关联产品详情并标明摘要边界；没有依据不补造建议。不符条件仅解释现状，不承诺改善后获批。
报告与列表校验assessmentId、resultVersion、catalogSnapshotId、ruleVersion、orderingPolicyVersion及三态统计；不同版本不拼接。候选和两个建议分组分别加载/重试，局部失败不隐藏已保存报告，也不显示为零候选。按可见栏目请求，概况不请求产品；离页/Token变化丢弃旧响应，401清空内容并回登录。修复匹配列表返回时的卸载挂载冲突：先关闭内容渲染，再清空资料。
继续无草稿。“重新评估”选择个人/企业并清空当前流程内存，进入空白填写页；只有再次正式提交才创建新assessmentId。页面仍26个，未改后端业务、未迁移、未调用收费模型。PDF（REPORT-005）、下一步行动（REPORT-006）与上下文助手按独立任务推进，未展示虚假可用按钮。REPORT-004整体仍开发中，真实产品/外部渠道与微信内H5、真机尚未验收；证据见开发进度6.17。
## 1. 项目状态与维护规则
当前已具备25个页面原型、部分本机交互、优化后的数据库结构和评估内部生命周期服务；密码账户基础已完成本地前后端联调，短信、评估、报告、匹配等完整业务仍待完成。AI供应商确定为DeepSeek，模型已确定为deepseek-v4-pro-0813和deepseek-v4-flash-0731，两个模型权限及自填报告已真实验证，商业预算、余额及生产容量仍待核验；其他服务商待定。
@@ -158,7 +202,7 @@ P0 表示核心流程、安全、首发外部能力或发布门槛；P1 表示
- 初始工程量基线为 **69–117 人日**（取消草稿及本轮实现后的实际剩余量待重估），按每周 5 个工作日约 **14–24 周**；不等于承诺上线日期，不含供应商开通、资质、审核与商务等待。
- 每类第三方暂按 1 个服务商估算；能力不足、增加渠道或调整业务范围时，修改受影响任务估算并在更新日志说明。
- 不用页面数、SQL 表数、代码行数计算业务完成率。文档完成也不计为下面 60 个业务任务完成。
- 不用页面数、SQL 表数、代码行数计算业务完成率。文档完成也不计为下面 63 个业务任务完成。
- 每次开发结束同步状态、实际证据、日期、依赖变化与下一步；保留原任务编号。任务跨模块时不得重复统计工时。
- 证据优先包含代码文件或版本、脱敏接口记录、测试报告、截图/录屏、第三方请求编号、验收人；不写 Token、验证码、密钥或证件原文。
- 接口与范围调整先同步开发文档，再同步本台账。新增需求单独变更评审，不能通过扩大既有任务标题掩盖新增成本。
@@ -175,7 +219,7 @@ P0 表示核心流程、安全、首发外部能力或发布门槛；P1 表示
| FILE 资料授权 | 选图本机预览、授权勾选与占位说明 | documents/consent_data 仅预留 | 通用公共上传不能代替私有证件服务 | 私有上传、下载、授权事件待开发 | 私有存储待定 | 未完成 |
| ASSESS 评估档案 | 个人/企业填写流程已有；未提交不持久化 | 一次评估一条记录及状态/幂等字段已有 | Assessment 内部服务已有 | 正式提交、状态、历史API已接通；不提供草稿接口 | 依赖上传/授权/数据渠道 | 内部历史测试已有，真实闭环未完成 |
| DATA 外部查询 | 查询选项为意向或占位 | 查询事件持久化待增量设计 | 渠道、回调和对账待开发 | 待开发 | 数据渠道待定 | 未完成 |
| PRODUCT 产品匹配 | 产品/匹配页使用模拟数据 | 范围字段、规则 JSON、版本/有效期已有 | 产品后台基础已有，规则执行器未完成 | 公共查询与评估匹配读取待开发 | 真实产品及规则待确认 | 结构/版本历史测试已有，业务匹配未验收 |
| PRODUCT 产品匹配 | 03/04/05/06已接正式快照及公共详情；本地产品为演示资料 | 范围/规则/版本及快照已有 | 发布预检、规则/冻结/排序/持久化已实现 | 匹配分页/详情、公共详情已接；公共列表待开发 | 真实产品及金标准待确认 | 本地接口和H5验证通过；整模块未验收 |
| REPORT AI 报告 | 已接真实自填报告，移除固定评分/雷达 | 报告快照、调用用量及任务元数据已接入 | Redis任务、补投/租约、重试已实现 | 自填报告支线已联调 | 指定Pro/Flash均真实可用 | 完整产品/查询范围未完成 |
| CHAT AI 助手 | 模拟对话 | 会话/消息/使用量字段已有 | 调用、上下文、配额待开发 | 待开发 | 依赖 DeepSeek | 未完成 |
| CONTENT 内容课堂 | 新闻/课程/搜索/FAQ 本地数据，学习进度本机 | 文章/融资课堂表已有，课程进度待增量设计 | 内容后台基础需补齐 | 真实列表/详情/进度/搜索待开发 | 内容运营素材待准备 | 未完成 |
@@ -200,9 +244,9 @@ P0 表示核心流程、安全、首发外部能力或发布门槛；P1 表示
| 编译与页面金额检查 | 上一轮 Web 与 Android 编译通过；手机 390×844、桌面 1280×900 浏览器检查金额输入、超限、确认、模拟提交和产品显示 | [前端 README](../README.md)、[页面注册](../pages.json)；前序任务会话验证记录 | 不是短信/AI/上传真实联调；无 iOS/Xcode 或 Android 真机上线结论；独立历史日志路径未留档，后续回归须新增证据 |
| 迁移与恢复基础 | 本机迁移及仓库外备份已完成 | [数据库迁移说明](D:/AAdesk/202609/airz/database/README.md) | 旧迁移限定业务空表，不得直接用于已有业务数据环境；未完成通用部署和恢复演练 |
### 2.2 全部 25 个页面的验收归属
### 2.2 全部 26 个页面的验收归属
页面路径以[pages.json](../pages.json)为准。下表记录页面真实业务的主要收口任务；其内部依赖仍需全部完成。当前 25 页均未通过一期真实业务验收。
页面路径以[pages.json](../pages.json)为准。下表记录页面真实业务的主要收口任务；其内部依赖仍需全部完成。当前 26 页均未通过一期真实业务验收。
| 页面 | 注册路径 | 主要任务 | 当前状态 |
| --- | --- | --- | --- |
@@ -211,9 +255,10 @@ P0 表示核心流程、安全、首发外部能力或发布门槛；P1 表示
| 评估填写 | packages/finance/assessment/assessment | ASSESS-004、FILE-004、DATA-004 | 当前流程内存填写/本机图片预览 |
| 评估确认 | packages/finance/confirm/confirm | ASSESS-004 | 元/万元转换、正式提交及网络重试幂等 |
| 分析中 | packages/finance/analyzing/analyzing | REPORT-004 | 按assessmentId轮询状态、失败重试、成功后打开真实报告 |
| 评估报告 | packages/finance/report/report | REPORT-004 | 按assessmentId读取真实自填报告、金额万元，无固定评分 |
| 匹配结果 | packages/finance/matches/matches | PRODUCT-004、REPORT-004 | 模拟匹配 |
| 产品详情 | packages/finance/product/product | PRODUCT-004 | 模拟产品/申请准备 |
| 评估报告 | packages/finance/report/report | REPORT-004 | 三栏已接本人冻结报告、匹配候选与改善证据；真实业务及平台验收未完成 |
| 匹配结果 | packages/finance/matches/matches | PRODUCT-004、REPORT-004 | 已接本人冻结结果、三态/分页及对比选择；演示产品联调 |
| 产品详情 | packages/finance/product/product | PRODUCT-004 | 已接历史理由/证据和参数、对比入口；单产品AI解释待开发 |
| 产品对比 | packages/finance/compare/compare | PRODUCT-005 | 2—3项冻结对比本地联调通过，真实产品与平台待验收 |
| AI 助手 | packages/finance/assistant/assistant | CHAT-004 | 模拟对话 |
| 融资档案 | packages/finance/archive/archive | ASSESS-004、REPORT-004 | 本人历史分页、脱敏只读详情、刷新恢复 |
| 启动引导 | packages/account/index/index | BASE-003、AUTH-002 | 原型/本机引导 |
@@ -379,16 +424,16 @@ DEC-DEMAND已确认并发布，需求录入/提交/历史子范围已实现；
| PRODUCT-001 | 规则字典与评分口径 | 确定准入三态、来源要求、单产品需求覆盖、用途规则、证据结构和版本化排序；评分未发布时null。 | P0 | ASSESS-001、DEC-MATCH | 1.5–2 | 开发中 |
| PRODUCT-002 | 准入与排序执行器 | 执行上架/有效期/对象/地区及需求硬规则；保存pass/fail/unknown证据，生成eligibility和稳定rank。 | P0 | PRODUCT-001 | 2–3 | 开发中 |
| PRODUCT-003 | 产品后台与公共查询 | 补规则条件编辑、来源/用途依据、发布预检、版本与公共详情；录入真实产品，缺依据阻止发布。 | P0 | PRODUCT-001、BASE-002、DEC-PRODUCT | 1.5–2 | 开发中 |
| PRODUCT-004 | 匹配页面与快照 | 按assessmentId展示三态分组、最多三个候选及分页；结果详情展示依据/注意项/AI解释，保留产品快照与申请准备。 | P0 | PRODUCT-002、PRODUCT-003、ASSESS-004、REPORT-003 | 1–2 | 未开始 |
| PRODUCT-005 | 同类产品对比 | 新增compare页，同评估2—3项冻结产品、状态/范围/条件对照、补选与返回、刷新恢复。 | P1 | PRODUCT-004 | 1.5–2.5 | 未开始 |
| PRODUCT-004 | 匹配页面与快照 | 按assessmentId展示三态分组、最多三个候选及分页；结果详情展示依据/注意项/AI解释，保留产品快照与申请准备。 | P0 | PRODUCT-002、PRODUCT-003、ASSESS-004、REPORT-003 | 1–2 | 开发中 |
| PRODUCT-005 | 同类产品对比 | 新增compare页，同评估2—3项冻结产品、状态/范围/条件对照、补选与返回、刷新恢复。 | P1 | PRODUCT-004 | 1.5–2.5 | 待验收 |
| 任务编号 | 负责人 | 验收条件 | 证据 | 更新时间 |
| --- | --- | --- | --- | --- |
| PRODUCT-001 | 全栈开发（待指定） | 发布规则与人工样例可审阅；非法字段/操作符阻止发布；fail优先于unknown，匹配指标不作为审批概率。 | 首版字段/操作符/来源门槛已形成规则契约；64项内存测试；真实产品发布依据与业务样例待验收 | 2026-09-24 |
| PRODUCT-002 | 全栈开发（待指定） | 同输入/快照结果稳定；未知不当满足，配置错误不归咎用户；需求不拆额、不改期；未运行与零候选区分。 | 目录冻结/排序/理由已接正式worker；51项内存和19项任务测试通过；真实产品金标准、规模/生产验收仍待完成 | 2026-09-24 |
| PRODUCT-003 | 全栈开发（待指定） | 产品用途/地区/额度/期限有真实依据；规则可配置并启停，版本变化留依据；公共详情无个人分数。 | 发布预检及模型保存已实现；本地6条演示产品已授权上架，重复录入不覆盖；真实资料/发布验收、结构化编辑和公共查询待完成 | 2026-09-24 |
| PRODUCT-004 | 全栈开发（待指定） | 每条解释可追溯且不凑三正三反；当前产品变化不改历史；跨账户拒绝；unavailable/零候选/failed不混淆。 | 未验收；无真实业务验收证据；本次v2契约已补，新增业务尚未开始，原测试不覆盖v2 | 2026-09-23 |
| PRODUCT-005 | 全栈开发（待指定） | 不跨评估/混用现价；缺值不同于0；手机横向表格可读，单项失败明确；不重跑模型。 | 04—10方案第2—4节已定义，尚无运行页面证据 | 2026-09-24 |
| PRODUCT-003 | 全栈开发（待指定） | 产品用途/地区/额度/期限有真实依据；规则可配置并启停，版本变化留依据；公共详情无个人分数。 | 发布预检及模型保存已实现；本地6条演示产品已授权上架，重复录入不覆盖；公共详情已接；真实资料/发布验收、结构化编辑和公共列表待完成 | 2026-09-24 |
| PRODUCT-004 | 全栈开发（待指定） | 每条解释可追溯且不凑三正三反；当前产品变化不改历史；跨账户拒绝；unavailable/零候选/failed不混淆。 | 匹配分页/详情和03/04/05/06基础已接；62项HTTP/快照检查及H5验证见6.13；单产品AI解释、真实业务验收待完成 | 2026-09-24 |
| PRODUCT-005 | 全栈开发（待指定） | 不跨评估/混用现价；缺值不同于0；手机横向表格可读，单项失败明确；不重跑模型。 | compare页面及6.16本地编译/真实读取与异常注入证据；真实机构产品和微信内H5/真机待验收 | 2026-09-28 |
剩余门槛：DEC-MATCH开发口径已采用既有契约，真实产品规则/金标准业务签收待完成；PRODUCT-003真实发布仍依赖DEC-PRODUCT。纯规则、后台模型预检及字段编译已实施，未解除整模块验收依赖。
@@ -410,7 +455,7 @@ DEC-DEMAND已确认并发布，需求录入/提交/历史子范围已实现；
| REPORT-001 | 全栈开发（待指定） | 模型可配置；密钥不下发；失败与使用量可追踪；数值事实不被模型改写。 | 两个指定模型真实连通；v2修正后Flash3例/Pro1例格式及语义检查通过；合成输入隐私过滤，调用tokens已记录；商业预算/生产稳定性待验收 | 2026-09-24 |
| REPORT-002 | 全栈开发（待指定） | 漏投/中断可恢复或明确失败；旧任务不可回写；输入/目标结果/策略/产品快照重试不隐式变化。 | 54项报告检查覆盖目标版本冻结、超时重试快照不变、旧v2输入仍v1、损坏快照先于模型失败；产品快照/生产守护未完成，旧29项任务证据保留 | 2026-09-24 |
| REPORT-003 | 全栈开发（待指定） | 完整度按发布字段集复算，等级有依据且非审批；null rank/score按状态验证；格式错误不成功，产品/规则更新不改旧报告。 | v2自填支线已实现；本轮58项回归及Flash3例/Pro1例真实样例通过；真实产品/外部查询、生产与业务人工签收待完成 | 2026-09-24 |
| REPORT-004 | 全栈开发（待指定） | 个人/企业真实链路按版本展示；未发布无分或等级，100%不等于授信；旧报告不重算；新复评新assessmentId。 | Chromium手机/桌面个人79%、企业100%、档案→报告→刷新、未发布无分和旧v1不重算通过；Web/Android编译通过；微信内/Safari/真机待验收 | 2026-09-24 |
| REPORT-004 | 全栈开发（待指定） | 个人/企业真实链路按版本展示；未发布无分或等级，100%不等于授信；旧报告不重算；新复评新assessmentId。 | 6.17三栏/局部重试/旧版/权限及生命周期验证；真实产品与外部渠道仍待验收 | 2026-09-28 |
| REPORT-005 | 全栈开发（待指定） | 本人成功报告可导出；金额/理由与历史一致；不重跑模型/泄露身份；中文分页可读，JSON错误不保存成PDF。 | 04—10方案定义导出接口与失败/隐私边界；PDF引擎及中文字体待选型锁定，未生成样本 | 2026-09-24 |
| REPORT-006 | 全栈开发（待指定） | 根据判定及当前可用性开放行动；无银行申请提交；新评估不改历史、无草稿；上下文和返回正确。 | 04—10方案已定义全部按钮去向和条件，尚未注册路由/实施页面 | 2026-09-24 |
@@ -878,3 +923,97 @@ Browser插件/browser技能未提供，按frontend-testing-debugging及Playwrigh
未验收：新提示的真实DeepSeek语义、真实产品与渠道、微信内H5和真机、匹配列表/详情接口及04—10页面。下一步：按评估ID提供冻结匹配分页/详情，校验归属和游标，再接产品详情三栏及匹配结果页面。
收尾验证：正式worker已恢复（本次PID34404，错误日志为空）；原1会员、2条成功评估/会话、25表保留，测试账户及队列清理。6条演示产品保留，种子文件预检再次通过。63项任务编号/依赖/工时一致且无环、25条现有路由、文档链接、UTF-8无BOM和diff检查通过。
### 6.13 2026-09-24 匹配读取API与03/04/05/06页面验证
本轮完成范围：本人匹配分页/详情、会员公共产品详情，报告入口、匹配三态列表、产品解释/资料/条件三栏。任务PRODUCT-004保持开发中，PRODUCT-003公共详情部分有实现证据，其他工时和依赖未改。
| 检查 | 环境/结果 | 覆盖及限制 |
| --- | --- | --- |
| match_records.php --worker-stopped | PHP7.4/MySQL/Redis，62项通过 | HTTP鉴权/所有权/GET限制、分页三态/游标、旧报告、损坏快照、重复GET无副作用；下架/过期/删除/改价的历史稳定性用事务回滚验证；假模型不调用供应商 |
| Web编译 | HBuilderX5.26，成功 | 开发服务初始存在layout.uts既有类型提示，不是本轮新增；浏览器业务运行正常 |
| Android编译 | HBuilderX5.26，成功 | 修复分组对象Any?类型后Kotlin/class通过；未做真机测试 |
| H5主链路 | Chromium，390×844、1280×900，通过 | 登录→报告→本次匹配→详情三栏→展开理由→返回→不符/待核实；刷新同一评估、万元精度0.800001/12.345678；无框架错误遮罩 |
| H5边界 | 同浏览器，通过 | 公共模式无个人解释、无ID引导及新评估、越权404不回退、查看更多无重复、网络失败后重新加载成功 |
浏览器使用Playwright CLI，原因：本会话没有Browser插件及browser技能（Browser plugin not available）。分页UI测试仅将真实API请求limit改为1，使现有两个候选产生第二页，不伪造响应。网络失败为一次主动abort，用于验证重试；控制台出现预期net::ERR_FAILED，正常主链路无运行错误/警告。测试工具脚本曾因运行环境没有URL构造器失败，改用字符串替换后复验通过，未因此修改业务代码。
截图：[手机匹配](<C:/Users/JUN/AppData/Local/Temp/airz-match-pages-qa/matches-mobile.png>)、[手机产品](<C:/Users/JUN/AppData/Local/Temp/airz-match-pages-qa/product-mobile.png>)、[待核实原因](<C:/Users/JUN/AppData/Local/Temp/airz-match-pages-qa/unknown-mobile.png>)、[桌面产品](<C:/Users/JUN/AppData/Local/Temp/airz-match-pages-qa/product-desktop.png>)。临时截图不是正式发布验收档案。
剩余：单产品AI解释尚未生成；真实产品与人工样例签收、微信内H5/Safari/真机未验证；返回列表首屏/原路登录恢复待完善。下一步按既定页面方案推进PRODUCT-005同评估2—3产品对比，再接REPORT-004报告三栏；PDF、行动页和上下文助手独立验收。本轮无迁移/新增表，无收费模型调用。
收尾：合成账户/评估/会话/队列和隔离HTTP服务已清理；原1会员、2条成功评估/会话、25张表保留，syntheticUsers=0。正式分析worker已恢复（本轮PID21560），错误日志为空；6条本地演示产品继续保留。63项任务编号/依赖/工时一致且无环，25条路由、文档链接、UTF-8无BOM及git diff --check通过。
### 6.14 2026-09-28 融资档案布局恢复与只读交互验证
对应ASSESS-004、REPORT-004的档案展示子项，原任务编号/依赖/估时不变，不将页面改造计为一期整体验收。保留截图中的分段切换、蓝色完整度卡片、四组图标/资料卡及蓝色主按钮；与旧图的有意差异为新增历史选择、只读展开、查看报告/新评估双入口，移除草稿保存与继续编辑。旧assessmentId深链仍可读取本人记录。
| 检查 | 结果与证据 | 范围限制 |
| --- | --- | --- |
| Web、Android、微信小程序编译 | HBuilderX5.26通过；Android将不支持的baseline对齐修正为flex-end | Web保留layout.uts既有类型提示；小程序未进行微信开发者工具/真机验证，Android未真机运行 |
| 主流程 | Chromium，http://localhost:5175/，390×844与1280×900通过；有页面标题、非空内容、无框架遮罩 | Browser plugin not available，沿用已有Playwright CLI，无安装新依赖 |
| 真实接口链路 | 随机合成账户+2条个人/1条企业记录+假模型报告：类型过滤、历史选择/刷新、分组只读展开、金额12.345678/0.800001/100.000001万元、0经营月数、同次报告入口、新评估入口通过 | 真实本地PHP/MySQL/Redis读接口，假模型不调用供应商；非真实用户资料 |
| 分页与边界 | 历史请求limit临时转为1验证第二页、无重复；他人评估161返回真实404且无最新记录回退 | 仅测试请求改limit，业务默认20；不改数据库已有历史 |
| UI异常分支 | 浏览器响应拦截验证空记录、v1未计算、processing/failed不请求报告、报告断网后可看资料并重试、401清除页面资料并转登录 | 这些分支为受控响应/网络故障注入，不代表供应商或生产环境验收 |
| 控制台 | 正常操作无业务错误/警告；故障注入对应预期网络错误、越权404及会话401 | 初次浏览器导航受启动时序影响中断、重复登录脚本在已登录页等待超时；回到正确页面后重新验证通过 |
[手机档案](<C:/Users/JUN/AppData/Local/Temp/airz-archive-20260928/archive-mobile.png>)、[企业档案](<C:/Users/JUN/AppData/Local/Temp/airz-archive-20260928/archive-enterprise-mobile.png>)、[空档案](<C:/Users/JUN/AppData/Local/Temp/airz-archive-20260928/archive-empty-mobile.png>)、[桌面档案](<C:/Users/JUN/AppData/Local/Temp/airz-archive-20260928/archive-desktop.png>)。截图为临时验证证据。
尚未验证：微信内置浏览器、小程序与Android/iOS真机；账户切换并发采用代码中的Token/请求序号/离页清理防护，本轮通过401清理验证但未做完整双账户并发压力测试。后续计划仍为PRODUCT-005产品对比及REPORT-004报告三栏，不恢复草稿功能。
收尾记录：本轮合成账户、3条评估/会话和测试队列已清理，隔离HTTP服务已停止；保留原1会员、2条成功评估/会话、25张表，syntheticUsers=0。正式分析worker已恢复（PID44028），错误日志为空。最终Android编译通过，UTF-8无BOM、文档63项任务/依赖/估时一致及diff检查通过。
### 6.15 2026-09-28 个人中心入口去重验证
对应ASSESS-004/REPORT-004的入口体验，任务编号/依赖/工时不变。修改profile/profile.uvue、新增账户分包services/latest-report.uts；未改后端、未执行迁移或数据库写入、未调用模型。
- HBuilderX5.26：Web、Android、微信小程序本地编译通过；微信/Android/iOS真机尚未验证。
- Chromium，http://localhost:5175/，390×844及1280×900：页面标题/内容正确，三个图标入口对齐，无框架遮罩。使用已有Playwright CLI，原因Browser plugin not available。
- 浏览器使用拦截的合成登录/账户/评估/报告响应验证入口行为，没有使用真实账户或写库：未登录跳登录；个人/企业选择进入对应entry；最近成功报告直接打开指定ID；无成功时提示处理中并进入该任务；全空/无可用报告提示后可取消；融资档案仍进入历史；网络失败后再次点击成功。
- 检查成功路径只请求status=succeeded&limit=1，空成功路径再请求processing；通过延迟响应验证连续点击只发一次请求、离页后响应不抢跳；401回到登录。真实服务已有status筛选/ID倒序/limit实现，本轮未增加后端逻辑，也未将合成响应验证视为生产联调。
- 正常路径无业务控制台错误/警告；故障注入的net::ERR_FAILED与401为预期。最终文本UTF-8无BOM、diff检查及文档63项任务一致性检查通过。
截图：[手机个人中心](<C:/Users/JUN/AppData/Local/Temp/airz-profile-20260928/profile-mobile.png>)、[桌面个人中心](<C:/Users/JUN/AppData/Local/Temp/airz-profile-20260928/profile-desktop.png>)。测试脚本及截图在临时目录，不引入生产模拟数据。浏览器测试会话完成后关闭。
### 6.16 2026-09-28 原型07产品对比验证
PRODUCT-005基础实现，状态待验收；原依赖PRODUCT-004、1.5–2.5人日估算及63个任务编号不变。新增compare页面和选择服务，修改匹配列表/详情入口、冻结详情元数据适配及pages.json。26个注册页面（融资分包10页），不新增后端接口、业务表或数据库迁移。
| 检查 | 结果与证据 | 验证边界 |
| --- | --- | --- |
| 编译 | HBuilderX5.26的Web、Android、微信小程序本地编译通过 | Web已有layout.uts类型提示保留；Android不支持百分比min-width，已将该桌面样式限制为非App；非真机运行结论 |
| 主流程 | Chromium，http://localhost:5173/；390×844及1280×900。列表跨分组加入2/3项→对比→详情→返回→补选；上限提示、3→2→1→0移除、单产品详情加入、URL刷新均通过 | 使用已有Playwright CLI，Browser plugin not available，无新安装依赖 |
| 真实接口 | 临时随机合成账户与假模型完成的个人评估，经真实PHP/MySQL/Redis读取；符合22、不符23、待核实24各列正确，产品顺序保持，金额12.345678/0.800001万元精度保留 | 6条演示产品，无真实机构资料验收，不调用收费模型，不更改原2条成功评估 |
| 权限与参数 | 非法评估ID、重复/超3/带前导零/空段产品ID拦截；无效产品参数不发详情请求；他人评估161和不在本次目录的产品25真实404，无公共产品回退 | 不将错误结果当作完整对比，不自动改查最新评估 |
| 故障注入 | 单列断网仅重试该列；assessmentId错配与catalogSnapshotId不同拒绝；缺失额度/期限显示未提供；下架保留历史且标识当前不可用；401跳登录 | 以上变体通过浏览器拦截，不改数据库或供应商服务；最多3个详情请求并行 |
| 生命周期 | 延迟列在离页后明确释放并收到响应，页面保持在匹配列表，不恢复旧列；刷新重新鉴权 | 尚未做双真实账户并发压力测试；选择内存按账户/Token/评估隔离 |
| 视觉及控制台 | 页面标题/内容非空、无框架遮罩；首列横向不移动，产品区可横滚，桌面列宽展开。正常流程无业务控制台错误/警告 | 故障注入的ERR_FAILED、404、401为预期；长单元格内部上下滚动，微信内H5/Safari及真机待测 |
脚本和截图位于临时目录airz-compare-20260928：flow.js、interactions.js、edges.js、late.js；其中异常深链测试通过完整导航/刷新独立载入各参数。初次滚动检测误选嵌套单元格滚动容器，修正选择器后验证通过；不把脚本定位失败计为业务通过。图示：[手机对比](<C:/Users/JUN/AppData/Local/Temp/airz-compare-20260928/compare-mobile.png>)、[手机横向滚动](<C:/Users/JUN/AppData/Local/Temp/airz-compare-20260928/compare-mobile-scrolled.png>)、[桌面对比](<C:/Users/JUN/AppData/Local/Temp/airz-compare-20260928/compare-desktop.png>)、[失败列](<C:/Users/JUN/AppData/Local/Temp/airz-compare-20260928/compare-failed-column.png>)。
下一步：REPORT-004报告三栏；单产品AI解释、PDF、上下文助手和行动页仍分别开发与验收。真实产品/人工金标准及微信内H5、真机尚未验收，不将PRODUCT-005记为整体已完成。
收尾：合成账户、评估/会话、会话Token及隔离队列已清理；测试HTTP服务与浏览器会话已关闭。正式分析worker已恢复（本轮PID28124），错误日志为空；原1会员、2条成功评估/会话、25张表保留，syntheticUsers=0。63项任务编号/依赖/工时一致且无环，当前26路由、相对链接、UTF-8无BOM与diff检查通过；无提交、推送或发布。
### 6.17 2026-09-28 原型09报告三栏验证
REPORT-004三栏页面子项完成本地联调，整体仍开发中。改动report/report.uvue、records.uts报告适配、matches.uts列表元数据及matches/matches.uvue离页渲染守卫；保留26个页面、63项任务、原依赖与估时。后端业务未修改，无迁移、无新增表、无收费模型调用。
| 检查 | 结果与证据 | 范围限制 |
| --- | --- | --- |
| 编译 | HBuilderX5.26的Web、Android、微信小程序本地编译通过 | Web既有layout.uts类型提示保留；没有微信开发者工具、Android/iOS真机或发行验证 |
| 主流程与视觉 | Chromium，http://localhost:5173/，390×844与1280×900；标题、非空页面、无框架遮罩；三栏切换/刷新、展开事实/逐项完整度、产品详情返回、分组入口、历史入口通过 | Browser plugin not available，沿用现有Playwright CLI；无新依赖安装，未做微信内H5/Safari验收 |
| 真实接口数据 | 随机合成账号，2份个人/1份企业评估，假模型报告；读取真实PHP/MySQL/Redis，金额12.345678、0.800001、100.000001万元与经营0个月保留；企业100%及个人缺失字段正确 | 不使用真实用户资料，演示产品不代表真实机构资料验收；原2条历史报告未修改 |
| 请求与跳转 | 概况不查询匹配；候选limit=3，改善分组各limit=3；流程登录后只有GET，无提交/重试分析写请求；重新评估选择主体进入空白表单 | 未恢复草稿或复制旧报告资料；PDF/下一步行动/上下文助手独立排期 |
| 旧版与空状态 | 浏览器受控响应验证v1三栏兼容且不请求匹配，未发布完整度显示“—”，真实0%不当缺失；未匹配与已匹配零候选区分，不补假卡片 | v1/策略变体为合成响应，没有重写已有报告；不据此认定所有生产历史格式均已覆盖 |
| 独立失败与边界 | 候选失败只重试候选，建议某组失败保留另组；目录版本不一致不显示卡片；下架保留历史参数；AI建议显示关联字段；不支持报告版本提示错误，报告断网可重试 | 异常为浏览器故障注入，非真实供应商故障；三态统计/冻结版本校验使用真实DTO |
| 权限与生命周期 | 无效ID/tab不请求API；他人评估161真实404不回退；401清理并回登录；候选延迟响应在切到概况后释放，不能恢复旧卡片 | 本轮未做双真实账户并发压力；Token/请求序号/可见性守卫保留 |
| 返回回归 | 定位Matches卸载时重建空状态引发的attachVmProps挂载错误；增加pageActive守卫，先关闭渲染再清理；重新加载后连续3次列表→返回→切栏无控制台错误/警告，延迟测试同样无错误 | 热更新期间旧页面实例仍可能保留旧生命周期；最终证据来自完整重新载入后的脚本 |
脚本和截图位于临时目录airz-report-tabs-20260928：flow.js、edges.js、navigation.js、late.js、capture.js。最初API路由拦截未命中，改用**/api/v1/**并确认隔离HTTP服务收到请求后重跑通过。正常流程最终无业务控制台错误，故障注入ERR_FAILED/404/401为预期；未将前期失败掩盖为通过。
截图：[概况手机](<C:/Users/JUN/AppData/Local/Temp/airz-report-tabs-20260928/overview-mobile.png>)、[匹配手机](<C:/Users/JUN/AppData/Local/Temp/airz-report-tabs-20260928/matches-mobile.png>)、[改善手机](<C:/Users/JUN/AppData/Local/Temp/airz-report-tabs-20260928/improvements-mobile.png>)、[产品依据](<C:/Users/JUN/AppData/Local/Temp/airz-report-tabs-20260928/improvements-evidence-mobile.png>)、[概况桌面](<C:/Users/JUN/AppData/Local/Temp/airz-report-tabs-20260928/overview-desktop.png>)、[匹配桌面](<C:/Users/JUN/AppData/Local/Temp/airz-report-tabs-20260928/matches-desktop.png>)。
后续建议按页面方案推进08上下文AI助手（CHAT模块），再衔接10行动页与09 PDF独立任务。真实产品/人工金标准、外部渠道、微信内H5及真机均仍待验收，不标整体验收完成。
收尾：随机合成账户、3条评估/会话、Token和隔离队列已清理，测试HTTP服务和浏览器会话已关闭；原1会员、2条成功评估/会话、25张表保持，syntheticUsers=0。本轮开始时未发现运行中的analysis:work，清理后已启动正式worker（PID33796），错误日志为空。文本编码、diff检查、63任务一致性与26条路由检查通过；未提交、推送或发布。
docs/需求与评估结果数据契约.md
+5 -5
View File
@@ -1,6 +1,6 @@
# 融资需求与评估结果数据契约
版本：v1.5（需求/报告v2、目录冻结及规则匹配落库已实施；匹配读接口与页面待接）。日期：2026-09-24。配套：[开发文档](开发文档.md)、[开发进度](开发进度.md)。
版本：v1.6（匹配读接口及03/04/05/06基础已接，单产品AI解释与07—10扩展待开发）。日期：2026-09-24。配套：[开发文档](开发文档.md)、[开发进度](开发进度.md)。
本文补充融资需求字段、资料完整度与准备等级、产品匹配解释三个范围，作为后续前后端、数据迁移及验收的共同依据。依据为[开发说明书](开发说明书.docx)第2—5节及[原型图](原型.jpg)第02—05、09屏，并遵循用户后续确认的无草稿、H5优先、数据库存元及复用评估/报告表的约定。
@@ -202,11 +202,11 @@ unknown不是建议申请；ineligible不是永久拒绝。展示应为“本次
| 方法/路径（/api/v1前缀） | 实施状态 | data与行为 |
| --- | --- | --- |
| GET /assessments/:id/report | 已支持v1/v2自填支线 | 本人成功记录；resultVersion辨识格式，未完成409、越权/不存在404；no-store |
| GET /assessments/:id/matches | 计划新增 | 参数eligibility默认eligible，可选ineligible/unknown；limit默认3、1—50，cursor可空。data={assessmentId,resultVersion,matching,items,hasMore,nextCursor}；unavailable返回200＋空数组及明确状态，不冒充零候选 |
| GET /assessments/:id/matches/:productId | 计划新增 | 只返回本次已评估的产品结果/全部理由/快照；未在快照内或越权404。不能拿公共当前产品临时拼出旧评估结论 |
| GET /products/:id | 计划新增 | 公开当前产品资料；无用户等级、理由或匹配分；与个人化结果分离 |
| GET /assessments/:id/matches | 已实现 | 参数eligibility默认eligible，可选ineligible/unknown；limit默认3、1—50，cursor可空。data={assessmentId,resultVersion,matching,items,hasMore,nextCursor}；unavailable返回200＋空数组及明确状态，不冒充零候选 |
| GET /assessments/:id/matches/:productId | 已实现 | 只返回本次已评估的产品结果/全部理由/快照；未在快照内或越权404。不能拿公共当前产品临时拼出旧评估结论 |
| GET /products/:id | 已实现，会员Bearer鉴权 | 当前公共产品资料（非匿名）；无用户等级、理由或匹配分；与个人化结果分离 |
matches只读成功评估，未成功409；参数错误422。服务端先鉴权归属，再解析游标；游标绑定assessmentId、resultVersion、冻结结果摘要、eligibility和偏移量，非法/不匹配游标422。快照不可变，分页不能混用当前产品列表。v1成功报告也可返回matching.status=unavailable/reasonCode=LEGACY_INPUT；不回填历史match_result。
本轮请求/响应示例、错误码及公共DTO范围见[规则契约第8节](产品匹配规则开发契约.md)。matches只读成功评估，未成功409；参数错误422。服务端先鉴权归属，再解析游标；游标绑定assessmentId、resultVersion、冻结结果摘要、eligibility和偏移量，非法/不匹配游标422。快照不可变，分页不能混用当前产品列表。v1成功报告也可返回matching.status=unavailable/reasonCode=LEGACY_INPUT；不回填历史match_result。
当前产品是否下架单列 `currentAvailability=available|unavailable|unknown`，由读取时受限查询得到，不写回productSnapshot、不改历史rank；当前不可用或查询失败时，申请准备页说明状态，不能继续显示“立即申请”。本项目仍只做资料引导，不向银行提交申请。