# 对外交互方案

> 六种交互模式、十二个交互场景、38 项接口清单与必要字段、放款智能审核接口契约（材料+制度双审核）。含系统交互全景图。

---

LLMS 索引： [llms.txt](/llms.txt)

---

门户以微前端形式集成**信贷系统**与**智能信审系统**两个平级子应用：智能信审不与门户直接做前端交互，页面级互操作（悬浮按钮读取缓存、页面跳转、iframe 嵌入）均发生在信贷系统与智能信审两个微前端子应用之间；门户与智能信审之间仅存在系统级对接（主数据同步、知识库菜单集成）。外围交互系统：信贷管理系统各业务中心（授信作业中心、授信执行中心、客户中心等）、门户、调查报告系统（智能尽调系统）、企业知识平台、外部数据管理平台（EDS）、影像平台。

> [!NOTE]
> 图内支持缩放、语义视图、关系追踪与 PNG/SVG 导出。

<iframe src="/ai/arch/12-xinshen-interaction.html" title="智能信审系统对外交互全景" loading="lazy" style="width:100%;height:700px;border:1px solid #e5e7eb;border-radius:8px;"></iframe>

<a href="/ai/arch/12-xinshen-interaction.html" target="_blank">全屏打开 ↗</a>

## 1. 六种交互模式

| # | 交互模式 | 说明 |
|---|---|---|
| 1 | 前端缓存写入 | 信贷系统前端（微前端子应用）将业务上下文写入前端缓存（sessionStorage），智能信审前端（同为门户微前端子应用）的悬浮按钮读取并驱动功能显示与可用性（两子应用间内存级交互，不走 ESB） |
| 2 | 后端接口调用（ESB） | 本系统后端经 ESB 调用外围系统接口（业务信息、财务数据、企查查数据等）；外围系统亦经 ESB 调用本系统接口 |
| 3 | 影像平台 | 文件经影像平台流转：业务资料、调查报告、审查意见、批复与提醒文件 |
| 4 | 页面相互跳转 | URL 链接传参、双向跳转，包括页面嵌入方式 |
| 5 | 门户主数据同步 | ESB 实时通知 + 企业知识平台表级批量同步（五大项：机构、用户、角色、机构-用户关系、用户-角色关系；菜单不再同步） |
| 6 | ETL 数据同步与实时查询 | 企业知识平台经 ETL 同步行业财务均值、政策法规（T+1）；五级分类数据经接口实时查询 |

**缓存字段**（场景 2/4 共用）：业务流水号、合同号（合同环节必须提供）、客户号、批复编号。

## 2. 交互场景总览（12 个）

| 场景 | 名称 | 交互方式 | 发起方 → 服务方 |
|---|---|---|---|
| 1 | 业务发起与调查报告获取 | ESB + 影像平台 + ETL | 授信作业中心→本系统；本系统→调查报告系统/影像平台/客户中心/EDS |
| 2 | 审查岗查看全面风险分析（小查） | 前端缓存 | 授信作业中心前端 → 本系统前端 |
| 3 | 审查岗出具审查意见 | 页面跳转 + ESB | 授信作业中心↔本系统；本系统→客户中心 |
| 4 | 审查岗类案对比（小审） | 前端缓存 + ESB + 页面嵌入 | 授信作业中心前端→本系统前端；本系统→信贷系统/企业知识平台 |
| 5 | 终审与业务资料入库 | ESB + 影像平台 | 授信作业中心→本系统→影像平台 |
| 6 | 出账申请资料上传 | 页面跳转 + ESB + 影像平台 | 授信执行中心↔本系统；本系统↔影像平台/信贷系统 |
| 7 | 出账审核（出账审核岗） | ESB | 授信执行中心→本系统→信贷系统 |
| 8 | 放款申请资料上传 | 同场景 6 | 上传场景编码=放款申请资料上传，入口为放款申请页面 |
| 9 | 放款审核（放款审核岗） | ESB | 授信执行中心→本系统→信贷系统/EDS |
| 10 | 未评价结果门户提醒 | 影像平台文件 | 本系统→影像平台←门户 |
| 11 | 门户主数据同步 | ESB + 表级同步 | 门户/企业知识平台→本系统 |
| 12 | 知识库门户接入 | 门户菜单集成 | 门户←本系统前端（知识库提前上线，不经悬浮按钮；含对话框问答与资料管理） |

### 场景要点

- **场景 1（业务发起与调查报告获取）**：调查报告正式版保存后自动 PDF 入影像并登记索引（不感知信贷提交状态）；授信业务提交成功后授信作业中心调用**统一发起接口**（同时发起小查与审查意见生成，不再传输调查报告文件）；本系统查询文件索引并拉取 PDF 本地暂存，**先统一执行一次财务分析与制度分析**（结果供两任务复用），再分别创建任务。通知式查询替代以往准实时轮询，仅业务提交后查询一次。数据支撑：财务要素←客户中心；企查查←EDS；行业均值与政策法规←企业知识平台 ETL（T+1）。
- **场景 2（审查岗查看小查）**：审查审批页面写缓存点亮"小查"；小查已随业务提交自动执行，此时点击属**重复发起**，按运行管理配置处理（默认允许，覆盖原任务；原任务执行中自动终止）。
- **场景 3（审查岗出具审查意见）**：初稿由场景 1 自动生成；查看/编辑经 URL 的 **mode 参数**区分（同一接口）；授信作业中心跳转前完成权限校验，本系统后端查看与下载时再次校验，未授权/拼接 URL/越权下载拒绝并记审计日志。生成过程中经"客户关系查询接口"获取数据，**自行生成集团关系图谱图片**放入报告。
- **场景 4（类案对比）**：任务期间经"业务基本信息查询接口"取当前业务与关键要素快照；经"五级分类数据查询接口"实时获取历史案例贷后五级分类；查看完整贷款信息时**页面嵌入**授信作业中心贷款信息查询页面（参数含 mode=current/case、业务流水号、客户号、业务名称、客户名称、客户类型，类似案例另带案例标识）。
- **场景 5（终审与业务资料入库）**：通过→审查意见+批复入库（打标含审批通过时间）；拒绝→仅审查意见（打标不含通过时间）；再议→不通知不入库。同一材料更新再次通知并覆盖旧有效版本。统一打标 11 字段：业务流水号、企业性质、企业规模、经营年限、所属行业、贷款用途、产品（多值/无产品标"授信"）、主担保类型、所属分行、业务审批通过时间（仅通过）、审批结论。
- **场景 6/8（资料上传）**：目录维护并列两种方式（方式一：信贷修改联动差异确认同时生效；方式二〔现行〕：目录同步接口获取→候选版本→逐条确认→激活，支持回滚）；删除控制按节点/文件粒度传入不可删除标记；复用历史材料物理复制两份；映射回传含失效状态；**上传任务提交不触发审核**。
- **场景 7/9（出账/放款审核）**：以授信执行中心提交事件为唯一发起点；执行期间经"放款/出账要素查询接口"取利率、受托支付、还款方式等，合同审核经"合同信息查询接口"取合同信息；**个贷放款审核**另经 EDS 取交易对手企查查信息（重点关注经营范围与贷款用途相符性）；打回重提覆盖本场景结果，出账与放款审核相互独立。
- **场景 10（未评价提醒）**：每日批量生成提醒文件上传影像约定目录；门户设定时间后轮询获取处理为门户提醒；仅对完成时间在最大提醒天数（默认 7）内的未评价任务生成。
- **场景 11（主数据同步）**：实时（ESB 变更通知）+ 批量（企业知识平台表级同步）双通道；菜单由门户配置，本系统提供前端文件。

## 3. 接口清单（38 项）

> 业务层面接口清单。实际设计可复用/合并/拆分接口，数量、名称与出入参以接口设计文档为准。

| # | 接口名称 | 场景 | 发起方→服务方 | 方式 |
|---|---|---|---|---|
| 1 | 业务基本信息查询 | 4 | 本系统→信贷系统 | ESB |
| 2 | 放款/出账要素查询 | 7/9 | 本系统→信贷系统 | ESB |
| 3 | 合同信息查询 | 7/9 | 本系统→信贷系统 | ESB |
| 4 | 财务要素查询 | 1 | 本系统→客户中心 | ESB |
| 5 | 影像目录同步 | 6/8 | 本系统→信贷系统 | ESB |
| 6 | 目录差异确认 | 6/8 | 本系统前端→本系统后端 | 内部 |
| 7 | 目录版本激活 | 6/8 | 本系统前端→本系统后端 | 内部 |
| 8 | 审查意见/批复入库通知 | 5 | 授信作业中心→本系统 | ESB |
| 9 | 审查意见/批复文件拉取 | 5 | 本系统→影像平台 | 影像平台 |
| 10 | 客户关系查询 | 3 | 本系统→客户中心 | ESB |
| 11 | 小查自动发起 | 1 | 授信作业中心→本系统 | ESB |
| 12 | 审查意见生成自动发起 | 1 | 授信作业中心→本系统 | ESB |
| 13 | 审查意见生成状态查询 | 3 | 授信作业中心→本系统 | ESB |
| 15 | 审查意见查看/编辑 | 3 | 授信作业中心→本系统前端 | 页面跳转（只读/可编辑双模式） |
| 16/38 | 放款智能审核接口 | 7/9 | 授信执行中心→本系统 | ESB |
| 17 | 出账/放款审核状态查询 | 7/9 | 授信执行中心→本系统 | ESB |
| 18 | 出账/放款审核结果查询 | 7/9 | 授信执行中心→本系统 | ESB |
| 19 | 资料上传页面跳转 | 6/8 | 授信执行中心前端→本系统前端 | 页面跳转 |
| 20 | 资料上传任务初始化 | 6/8 | 授信执行中心/本系统前端→本系统后端 | ESB/内部 |
| 21 | 资料上传任务提交 | 6/8 | 本系统前端→本系统后端 | 内部 |
| 22 | 资料上传任务状态查询 | 6/8 | 授信执行中心→本系统 | ESB |
| 23 | 影像文件存储 | 6/8 | 本系统→影像平台 | 影像平台 |
| 24 | 业务材料预审 | 6/8 | 本系统前端→本系统后端 | 内部 |
| 25 | 业务目录影像映射回传 | 6/8 | 本系统→授信执行中心 | ESB |
| 26 | 门户主数据变更通知 | 11 | 门户→本系统 | ESB |
| 27 | 门户主数据表级同步 | 11 | 企业知识平台→本系统 | 表级同步 |
| 28 | 未评价提醒文件生成 | 10 | 本系统→影像平台 | 影像平台 |
| 29 | 未评价提醒文件获取 | 10 | 门户→影像平台 | 影像平台 |
| 30 | 调查报告文件索引查询 | 1 | 本系统→调查报告系统 | ESB |
| 31 | 调查报告文件拉取 | 1 | 本系统→影像平台 | 影像平台 |
| 32 | 行业财务均值同步 | 1 | 企业知识平台→本系统 | ETL（T+1） |
| 33 | 政策法规同步 | 1 | 企业知识平台→本系统 | ETL（T+1） |
| 34 | 五级分类数据查询 | 4 | 本系统→企业知识平台 | ESB |
| 35 | 企查查数据查询 | 1/9 | 本系统→EDS | ESB |
| 36 | 上传文件失效 | 6/8 | 本系统前端→本系统后端 | 内部 |
| 37 | 小查与审查意见生成统一发起 | 1 | 授信作业中心→本系统 | ESB |

> 注：原序号 14"审查意见下载接口"已取消——报告下载改为在审查意见查看/编辑页面内通过"报告下载"按钮完成；序号 36 上传文件失效接口、37 统一发起接口、38 放款智能审核接口（材料+制度双结果回执）为新增。

## 4. 接口必要字段（必传最小集合）

| 接口 | 必要字段 |
|---|---|
| 业务基本信息查询 | 入：业务流水号。出：客户号/名称/类型、贷款类型、授信额度分项产品或贷款产品、业务名称、个人产品种类、行业三级、企业性质/规模、经营年限、客户评级、资产负债率/毛利率/净利率、本次实际敞口、期限、贷款用途、担保方式、抵押率——须支撑类案对比相似检索并与"对比业务关键要素"一致 |
| 放款/出账要素查询 | 入：业务流水号、审核场景。出：利率、还款方式、受托支付信息、放款/出账金额、期限 |
| 合同信息查询 | 入：业务流水号、合同号。出：合同全文/影像位置、金额、期限、利率、担保信息、还款安排 |
| 财务要素查询 | 入：客户号、业务流水号、报表期次。出：财务指标及所属期次 |
| 影像目录同步 | 产品/业务类型、目录树版本号、目录节点（编码、名称、层级、状态） |
| 目录差异确认/版本激活 | 版本号、差异节点列表（编码、差异类型、绑定目标、处理方式）/ 激活或回滚操作、操作人、生效时间 |
| 审查意见/批复入库通知 | 业务流水号、终审结论、材料类型、文件名（含打标编码）、影像位置、终审时间、更新时间 |
| 客户关系查询 | 客户号、关系类型、关系层级、关联客户号/名称 |
| 小查/审查意见生成自动发起（及统一发起） | 业务流水号、提交批次/版本、客户号、流程上下文、发起时间；统一发起返回小查任务编号与审查意见任务编号 |
| 审查意见生成状态查询 | 业务流水号、场景编码；出：任务编号、状态（排队中/生成中/生成完成/生成失败） |
| 审查意见查看/编辑 | URL：业务流水号、任务编号（可选）、mode（查看/编辑） |
| 资料上传页面跳转/初始化/提交/状态查询 | 业务流水号、客户信息、上传场景编码、不可删除标记列表；任务标识、目录版本、完整度、风险项数等 |
| 业务目录影像映射回传 | 业务流水号、上传场景、目录节点编码、影像文件标识/位置、节点已传状态、更新时间 |
| 门户主数据变更通知/表级同步 | 变更类型、主数据标识、变更操作、变更时间、版本号 / 五大项表级快照、更新时间、表级版本 |
| 未评价提醒文件生成/获取 | 文件名称、目录、生成时间、提醒批次号、提醒条数 / 匹配规则、批次号、获取时间 |
| 调查报告文件索引查询/拉取 | 业务流水号、报告编号、文件名、影像位置、打标数据、提交时间 / 文件标识 |
| 行业财务均值/政策法规同步 | 行业分类、企业规模、指标编码、统计期次、均值 / 法规分类、名称、条款、关键字、版本、生效失效区间、全文标识 |
| 五级分类数据查询 | 客户号/业务标识、五级分类结果、分类时点、数据来源 |
| 企查查数据查询 | 入：查询主体类型（财务分析客户/交易对手）、客户号/企业名称/统一社会信用代码等；出：企查查数据 |
| 上传文件失效 | 业务流水号、上传场景、任务标识、文件标识/影像位置、失效时间、操作人 |

## 5. 放款智能审核接口契约（材料 + 制度双审核）

客户经理提交放款申请或出账申请后，授信执行中心调用本接口发起统一审核回执。本系统按业务流水号**幂等**创建或更新小核任务，执行材料智能审核的同时调用制度分析模块执行制度风险分析，一次性返回双结果。

### 5.1 触发节点映射

| 审核场景 | 触发节点 | 功能编码 funcId | 默认识别规则 | 制度检查范围 |
|---|---|---|---|---|
| 放款审核 | 提交放款申请 | loanReleaseApply | 业务流水号含 LOAN/LOAN-*（个人 PERSONAL-LOAN-*） | 对公放款申请节点制度映射；个人业务适用个人制度映射 |
| 出账审核 | 提交出账申请 | paymentManage | 业务流水号含 PAYOUT/PAY-* | 支付管理节点制度映射；个人业务同理 |

### 5.2 请求字段（授信执行中心 → 本系统）

| 字段 | 类型 | 必传 | 说明 |
|---|---|---|---|
| bizSeqNo | string | 是 | 业务流水号，接口幂等键 |
| funcId | string | 是 | loanReleaseApply（放款）/ paymentManage（出账） |
| businessMaterialTaskId | string | 否 | 业务材料智能审核任务标识，用于两维结果同源关联 |
| materialRiskLevel | string | 否 | 材料风险等级 high/medium/low/suspect，无风险传空 |
| materialRiskCount | number | 否 | 材料风险条数（≥0） |
| custNo / custName | string | 否 | 客户标识与名称（展示用） |
| title | string | 否 | 任务名称（缺省按业务流水号生成） |

### 5.3 响应字段（本系统 → 授信执行中心）

| 字段 | 类型 | 说明 |
|---|---|---|
| taskId | string | 小核任务编号（同业务流水号幂等复用） |
| status | string | running / finished / failed |
| materialRiskLevel | string | 材料风险等级（无风险为空） |
| materialRiskCount | number | 材料风险条数 |
| institutionRiskLevel | string | 制度风险分析等级 |
| combinedRiskLevel | string | **合并风险等级 = 材料与制度取最高者**；均无风险为空。仅制度高风险时同样按高风险驱动悬浮按钮 |
| institutionResult | object | dataSupported、model、stats（total/high/medium/low/suspect/compliant）、modules（制度合规检查条目：aspect/riskLevel/title/description/suggestion + evidence[制度条文+业务证据溯源]） |

### 5.4 页面双审核切换约定

- 任务进入分析中/已完成分析后，顶部显示"材料审核 N / 制度审核 M"分段按钮，默认材料审核；任一维度 0 条时按钮置灰仍可点击查看空态；"下载材料/评价"常驻。
- 制度审核面板整面板复用小查样式；零风险显示"审核完成，未发现制度风险"。

## 6. 影像平台角色汇总

| 场景 | 影像平台角色 |
|---|---|
| 场景 1 | 调查报告 PDF 存入，本系统按索引拉取 |
| 场景 5 | 授信作业中心放入审查意见及批复（通过）或仅审查意见（拒绝），本系统按通知拉取 |
| 场景 6/8 | 上传材料及复用复制件存入，授信执行中心从影像平台获取 |
| 场景 10 | 本系统生成提醒文件上传，门户定时轮询获取 |

## 7. 本章关联文档

- 各场景对应的业务功能：[04 风险检查（小查）](../04-risk-check/)、[05 类案对比（小审）](../05-case-compare/)、[06 审查报告](../06-review-report/)、[07 智能审核（小核）](../07-smart-audit/)、[08 评价分析](../08-evaluation/)
- 交互全景图：[arch-interaction.html（全屏 ↗）](/ai/arch/12-xinshen-interaction.html)

---

反链：

- [智能信审平台需求文档](/docs/ai/comprehensive-credit/xinshen-requirements/)