feat: 完成原型04-10全链路功能开发，包括AI助手、PDF导出等
This commit is contained in:
hujun
+43
-4
@@ -1,9 +1,37 @@
|
||||
# AI 融资平台开发文档
|
||||
|
||||
> 版本：v1.14 · 基线日期：2026-09-22 · 更新日期：2026-09-28 · 状态：匹配分页/详情及公共产品详情已接通；03/04/05/06基础接入，07对比与09报告三栏本地联调通过；08助手、09PDF、10行动待开发
|
||||
> 版本：v1.18 · 基线日期：2026-09-22 · 更新日期：2026-09-28 · 状态：匹配分页/详情及公共产品详情已接通；04/05按原型还原并接通单产品DeepSeek解释，07对比与09报告三栏本地联调通过；08上下文助手本地联调通过，真实多轮语义/真机待验收；10行动本地联调通过；09PDF普通H5本地验证通过，平台/容量待验收
|
||||
> 配套台账：[开发进度](开发进度.md)。本文定义范围、接口和验收口径，台账记录实际执行与证据。
|
||||
> 文档初始规划后已开始开发；以下更新记录优先于原始基线。除明确列为已实现的部分外，计划接口和增量数据仍待开发。
|
||||
|
||||
### 0.20 2026-09-28 原型09报告PDF导出
|
||||
|
||||
REPORT-005完成本地实施，状态待验收。09报告顶部与10行动页接入同一下载组件；用户点击后才以Bearer请求`GET /api/v1/assessments/:id/report.pdf`，不提供永久公开链接、不重跑模型、不修改已存报告或产品。27页、63项任务不变。
|
||||
|
||||
后端复用本人成功报告与全部冻结匹配快照，模板包含需求、概况、结构化事实、完整度/准备状态、匹配三态/产品理由、建议、版本、时间和免责声明；旧v1不补造v2指标。排除身份、联系方式、企业名和自由填写内容，纯文本转义；引擎禁止远程资源、脚本和任意文件读取。精确元字符串转万元，PDF中文字体嵌入，页脚编号、长理由分页。
|
||||
|
||||
导出引擎Dompdf3.1.6及传递依赖单独锁定在后端extend/report-pdf，中文Noto Sans SC Sans2.004固定400字重、字体来源/哈希/许可入库；根依赖不变，无迁移。成功响应application/pdf、no-store/private、安全文件名；401/404/409/503为JSON。引擎缺失/关闭明确503，不生成空文件。
|
||||
|
||||
H5检查状态、MIME及PDF首尾标识后创建Blob下载；失败可重试且保留报告，离页取消、换账号拒绝迟到文件并清空旧报告，401白名单回登录。首版普通H5开放；微信内浏览器提示“在浏览器打开并重新登录下载”，App/小程序明确未开放，不假报成功。真实Safari/微信/原生下载未验收。
|
||||
|
||||
29项PDF检查、20项真实HTTP检查、24项浏览器检查及Android/微信编译通过，样本渲染和文字提取通过；证据与局限见开发进度6.21。下一步为08真实多轮语义、真实产品样例及跨浏览器/真机验收，生产导出容量仍需评估。
|
||||
|
||||
### 0.19 2026-09-28 原型10下一步行动
|
||||
|
||||
REPORT-006页面与入口已完成本地联调，状态待验收。新增`packages/finance/next-step/next-step`，当前27个页面、63项稳定任务。界面按原型采用白底、蓝色图标、四个行动行、重要提示和首页按钮；关键守卫与业务边界有中文注释。
|
||||
|
||||
本人成功报告与冻结产品只读展示；仅eligible且当前available展示申请准备材料，进入/返回/刷新重新读取状态，快照不一致时关闭准备。未选产品回本次匹配，不符/待核实/不可用可查看报告、优化资料与咨询。材料与来源使用冻结数据，渠道未提供时明确说明，不提交银行申请、不增加PDF假操作。
|
||||
|
||||
优化资料先展示待补/待核实项与已存建议，再清空流程内存进入同类型空白表单；不覆盖历史。AI咨询携带评估和可选产品，进入不发送。支持白名单登录返回、归属复验、离页清空及迟到响应隔离；冷启动返回本次报告，首页reLaunch。
|
||||
|
||||
H5 Chromium手机/桌面38项检查与最终Android/微信编译通过；详见进度6.20。复用已有API，未改后端业务、未迁移、未调用收费模型。下一步为09 PDF；08真实多轮语义、真实产品、微信内H5/Safari和真机仍未验收。
|
||||
|
||||
### 0.18 2026-09-28 原型08上下文AI助手
|
||||
|
||||
CHAT-001—003已实现持久会话、消息分页、固定评估/产品上下文、异步回复、原键重试和页面接入，状态待验收；CHAT-004本地异常/额度检查通过，整体仍开发中。普通问答及04/05产品、07对比、09报告入口已接通，进入页面不调用模型，快捷问题只填入输入框。关键实现增加中文注释，保留26个页面和63项任务。
|
||||
|
||||
经本轮用户明确授权，后端fa_ai_chat新增context_assessment_id/context_data及归属约束，正式assessment_id/analysis_context和已有报告不改写。模型调用默认Flash，复用analysis:work，助手/报告/产品解释共用每日预留额度。完整接口、重试、迁移恢复和验证见[上下文AI助手开发契约](上下文AI助手开发契约.md)。下一步为原型10及09 PDF；08真实多轮语义/真机与生产容量仍需验收。
|
||||
|
||||
## 0. 2026-09-22 实施更新
|
||||
|
||||
- 用户最新决定：删除fa_user_token，会员Token仅存Redis；已备份并删除本地表，当前25张表。fa_user和各业务关系保持不变。运行配置不再依赖MySQL Token驱动。
|
||||
@@ -176,6 +204,16 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
|
||||
|
||||
继续无草稿。“重新评估”选择个人/企业并清空当前流程内存，进入空白填写页；只有再次正式提交才创建新assessmentId。页面仍26个，未改后端业务、未迁移、未调用收费模型。PDF（REPORT-005）、下一步行动（REPORT-006）与上下文助手按独立任务推进，未展示虚假可用按钮。REPORT-004整体仍开发中，真实产品/外部渠道与微信内H5、真机尚未验收；证据见开发进度6.17。
|
||||
|
||||
### 0.17 2026-09-28 原型04/05与单产品AI解释
|
||||
|
||||
本轮优先完成04、05，复用product/product的eligible/ineligible/unknown三种状态。按原型恢复紧凑机构信息、AI解释/产品详情/申请条件三栏、绿色序号理由、橙色注意事项和底部双按钮；额度/年化/期限移入产品详情。每组默认最多三条，可展开全部和逐条依据。非候选的绿色区域称“已满足的条件”，不把部分满足理解为推荐。无真实Logo时沿用通用机构图标，演示产品保留标记。
|
||||
|
||||
新增已实现POST `/api/v1/assessments/:id/matches/:productId/explanation`，Bearer鉴权，JSON体仅`requestId:string`（8—64位字母/数字/下划线/短横线）；HTTP200回传与GET匹配详情相同的data，异步状态为queued/running/completed/failed，首次未请求为not_requested。GET只读；仅点击生成/重试调用POST，不自动重跑评估。状态和逐条解释保存在fa_ai_chat.match_result，fa_ai_chat_log预留并记录调用，无新表和迁移。完整接口与故障边界见[产品匹配契约第9节](产品匹配规则开发契约.md)。
|
||||
|
||||
复用analysis:work消费持久调用日志；同产品并发/成功缓存/相同请求键重放不重复调用，每评估每产品最多三次尝试，与报告共用每日用户调用额度。租约失效明确失败，手动新键重试；旧回复只补用量，不覆盖新任务。DeepSeek仅解释该产品冻结理由，逐条引用由服务端绑定；模型输出允许调整顺序，按理由ID校验无缺失/重复/外来项后恢复规则顺序。禁止模型输出数值与授信承诺。
|
||||
|
||||
已完成本地验证，PRODUCT-004整体仍开发中；原工时/依赖与63个任务编号不变。原型08上下文咨询和10行动页未完成，当前底部为产品对比、产品详情及资料准备说明，不提供假咨询/假申请。真实产品/人工业务金标准、微信内H5/Safari及真机仍待验收。
|
||||
|
||||
## 1. 项目目标与现状
|
||||
|
||||
### 1.1 已确认范围
|
||||
@@ -190,7 +228,7 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
|
||||
|
||||
| 项目 | 当前事实 | 规划用途 |
|
||||
| --- | --- | --- |
|
||||
| 前端 | uni-app x / Vue 3 / UTS，26 页，无独立 npm 构建入口 | 沿用 HBuilderX 和现有分包，不重新搭建前端 |
|
||||
| 前端 | uni-app x / Vue 3 / UTS，27 页，无独立 npm 构建入口 | 沿用 HBuilderX 和现有分包，不重新搭建前端 |
|
||||
| 后端 | FastAdmin / ThinkPHP 5.0.28 / PHP 7.4 | 复用认证、后台、模型与队列依赖，新增业务 API/服务 |
|
||||
| 数据库 | MySQL 8.0.44，删除空 Token 表后实际 25 张 InnoDB 表 | 已核对本地库并更新结构快照；恢复点见进度第0节 |
|
||||
| 当前前端模式 | 开发环境已连接本地 v1 API，模拟请求开关关闭 | 密码账户流程已接入，内容与产品匹配等页面仍有原型数据，不按页面数计算完成度 |
|
||||
@@ -217,9 +255,9 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
|
||||
|
||||
## 2. 页面与功能覆盖
|
||||
|
||||
路由以 [pages.json](../pages.json) 为准。以下覆盖现有全部 26 页；反馈表单、历史列表等优先补入所属现有页面，若交互确需新增页面，在所属分包注册并同步台账。
|
||||
路由以 [pages.json](../pages.json) 为准。以下覆盖现有全部 27 页；反馈表单、历史列表等优先补入所属现有页面，若交互确需新增页面，在所属分包注册并同步台账。
|
||||
|
||||
原型07路由`packages/finance/compare/compare`（PRODUCT-005）已注册，现共26页；`packages/finance/next-step/next-step`（REPORT-006）待开发注册，目标共27页。04/05/06均复用product/product，报告PDF不另加页面。参数与返回矩阵见专项页面方案第3节。
|
||||
原型07路由`packages/finance/compare/compare`（PRODUCT-005）与10路由`packages/finance/next-step/next-step`（REPORT-006）均已注册，现共27页。04/05/06均复用product/product，报告PDF不另加页面。参数与返回矩阵见专项页面方案第3节。
|
||||
|
||||
| 序号 | 页面路由 | 功能职责 | 主要任务 |
|
||||
| --- | --- | --- | --- |
|
||||
@@ -249,6 +287,7 @@ REPORT-004页面子项完成本地联调：report/report改为评估概况、匹
|
||||
| 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 |
|
||||
| 27 | packages/finance/next-step/next-step | 材料准备、已存报告、资料优化及同类型新评估、上下文AI与首页 | REPORT-006 |
|
||||
|
||||
## 3. 数据与架构约定
|
||||
|
||||
|
||||
Reference in New Issue
Block a user