优化项目分析详情与异常明细展示

This commit is contained in:
wjj
2026-07-01 11:26:01 +08:00
parent 066d850389
commit 04ede64767
17 changed files with 724 additions and 131 deletions

View File

@@ -0,0 +1,23 @@
# 外部人员详情对象异常原因快照实施记录
## 修改内容
- 后端 `CcdiProjectRiskHitTagVO` 增加 `reasonDetail` 字段。
- 后端外部人员风险命中标签查询返回 `reason_detail`,并优先取对象级原因快照。
- 前端外部人员详情对象异常卡片优先展示真实 `reasonDetail`
- 前端增加缺失原因快照时的流水统计兜底展示,包含关联流水、累计金额、最大金额、最近交易和主要对手方。
- 前端外部人员预警列表标准化命中标签时保留 `ruleCode``reasonDetail`,避免从列表进入详情时丢失原因快照。
## 影响范围
- 外部人员预警详情。
- 命中模型涉及外部人员的「查看详情」。
- 员工详情原有对象明细接口不变,仅命中标签 VO 支持原因字段。
## 验证情况
- 后端 Mapper 测试通过:`CcdiProjectOverviewMapperRiskModelPeopleTest``CcdiProjectOverviewMapperSqlTest` 共 10 个用例通过。
- 前端生产构建通过,存在项目既有包体积告警。
- 后端 `ruoyi-admin` 打包通过并已重启到 62318。
- 前端已用 Node 14.21.3 重启到 8080。
- 真实页面验证通过:外部人员详情「对象异常明细」已展示详细原因快照,例如“近一年流水交易额 52000.00 元,超过阈值 10000 元”,不再显示泛化命中文案。

View File

@@ -0,0 +1,20 @@
# 资金流向图谱图例与节点分类展示优化实施记录
## 修改内容
- 将资金流向图谱右上角图例由“人员、家庭关系、对手方、已展开”调整为“本人、关系人、其他方、已展开”。
- 将关系人节点从与本人相近的绿色人物三角改为橙色六边形人物节点,降低本人和关系人之间的视觉混淆。
- 在资金图谱节点 tooltip 中增加“类型”说明,显示本人、关系人、其他方或已展开。
## 影响范围
- 前端文件:`ruoyi-ui/src/views/ccdiProject/components/detail/graph/FundGraphSection.vue`
- 仅调整资金图谱展示文案、节点图标与 tooltip不修改接口、后端逻辑、SQL 或资金流向数据口径。
## 验证情况
- 已通过代码检查确认分类逻辑保持不变:中心节点仍为本人,有关系类型的节点仍归为关系人,已展开节点仍按展开状态展示,其余节点归为其他方。
- 已执行 `nvm use 14.21.3`,当前 Node 版本为 `v14.21.3`
- 已执行 `node node_modules\@vue\cli-service\bin\vue-cli-service.js build --mode production`,构建成功;仅存在既有资源体积 warning。
- 已在本地前端服务 `http://localhost:8080/` 进入真实项目详情页面,打开项目分析详情并切换至资金流向页签,资金图谱 canvas 正常渲染,页面无前端报错。
- 已检查资金图谱配置代码:图例为“本人、关系人、其他方、已展开”,关系人节点使用橙色六边形人物图标,节点 tooltip 输出“类型”说明。

View File

@@ -0,0 +1,24 @@
# 项目分析异常流水明细导出实施记录
## 修改内容
- 调整项目分析【查看详情】内异常明细导出逻辑,仅导出流水异常分组数据。
- 员工详情弹窗与外部人员详情弹窗均复用同一异常明细组件,本次调整同时覆盖两个入口。
- 移除导出结果中的对象异常记录,避免出现“对象异常 / 异常对象摘要”等风险对象相关内容。
- 精简导出字段,保留流水明细需要的列:分组、交易时间、本方名称、本方账号、对方名称、对方账号、摘要、交易类型、异常标签、交易金额。
- 导出文件名由“异常明细”调整为“异常流水明细”,空数据提示同步改为“暂无可导出的异常流水明细”。
## 影响范围
- 前端文件:`ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisAbnormalTab.vue`
- 覆盖入口:员工【查看详情】、外部人员【查看详情】
- 文档文件:`docs/reports/implementation/2026-07-01-project-analysis-abnormal-flow-export.md`
- 不涉及后端接口、数据库结构、菜单权限或风险明细主导出功能。
## 验证情况
- 已完成代码级检查,确认导出按钮只在流水异常分组展示。
- 已确认导出行构造逻辑只遍历 `BANK_STATEMENT` 分组,不再写入 `OBJECT` 对象异常记录。
- 已确认员工详情 `ProjectAnalysisDialog.vue` 与外部人员详情 `ExternalPersonDetailDialog.vue` 均引用该组件。
- 前端生产构建通过,存在项目既有包体积告警。
- 当前浏览器控制工具未暴露可调用入口,未完成页面点击下载验证。

View File

@@ -0,0 +1,34 @@
# 项目分析详情侧栏收起与异常明细导出实施记录
## 修改内容
1. 项目分析详情弹窗左侧“人物档案、命中模型摘要”默认改为紧凑宽度,并新增收起/展开按钮。
2. 侧栏收起后保留窄栏身份提示,右侧分析页签自动获得更多展示宽度。
3. 根据页面反馈进一步简化侧栏样式:左侧区域整体保持白底,档案区保留单层白色外框,不再呈现灰底缝隙、灰底承托或嵌套白卡,也不再把“人物档案、命中模型摘要”做成两个模块层级;收起按钮放入档案卡片内部并改为纯图标按钮。
4. 资金流向逐笔明细表补齐本方与对手方名称、账号展示,避免生产数据中名称/账号不易区分;资金流向不提供导出按钮。
5. 压缩项目分析详情与外部人员详情弹窗头部:移除“结果总览”层级文案,标题改为单行低高度展示。
6. 外部人员“查看详情”弹窗同步接入单卡侧栏、图标收起按钮和紧凑头部,确保员工风险人员、命中模型涉及人员、外部人员三个入口风格一致。
7. “查看详情 > 异常明细”页签在“流水异常明细”标题栏右侧新增“导出”按钮,导出当前弹窗已加载的流水异常和对象异常 CSV 明细。
8. 异常明细表将本方、对方列调整为“名称在上、账号在下”的展示方式,避免名称与账号含义混淆。
## 影响范围
- 前端页面:项目详情 > 结果总览 > 命中模型涉及人员 / 风险人员 / 外部人员查看详情。
- 前端组件:`ProjectAnalysisDialog.vue``ExternalPersonDetailDialog.vue``ProjectAnalysisSidebar.vue``ProjectAnalysisAbnormalTab.vue``FundGraphSection.vue`
- 后端模块:无新增接口;资金流图谱查询链路保持不变。
- 不修改资金边明细分页查询口径,不影响手工资金流向边。
## 验证情况
- 已执行:`mvn -pl ccdi-project -am compile -DskipTests`,通过。
- 已执行:按 `.nvmrc` 使用 Node `v14.21.3` 直接调用本地 `vue-cli-service build`,构建通过,仅存在既有资源体积警告。
- 已执行:侧栏单卡片与图标按钮微调后,再次执行同一前端构建,构建通过,仅存在既有资源体积警告。
- 已执行:异常明细导出、单层白色档案卡片、卡片内纯图标收起按钮调整后的前端构建,构建通过,仅存在既有资源体积警告。
- 已执行:真实页面 `http://localhost:8080/ccdiProject/detail/90342?tab=overview` 验证。
- 命中模型涉及人员“查看详情”可打开项目分析详情弹窗。
- 弹窗中出现档案卡片内纯图标收起按钮。
- 点击收起后,左侧侧栏由约 286px 收缩为约 54px右侧主区域由约 1211px 扩展为约 1453px。
- 已检查:资金流向页签可加载资金图接口 `/ccdi/project/fund-graph/graph`
- 已检查:资金流向页签不存在“导出明细”按钮和 `/edge-detail/export` 导出接口调用。
- 已执行:真实页面复验左侧区域、侧栏外层、右侧主区均为白色背景;档案区保留单层白色外框,外框外不再出现灰色缝隙;收起按钮在卡片内部且仅显示图标。
- 已执行:真实页面复验“导出”按钮位于“流水异常明细”标题栏右侧,不位于异常明细整体上层。