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

docs/plans/backend/2026-07-01-external-person-detail-reason-backend-implementation.md

@@ -0,0 +1,22 @@
+# 外部人员详情原因快照后端实施计划
+
+## 背景
+
+外部人员「查看详情」的对象异常明细由前端命中标签组装，但命中标签接口未返回 `reasonDetail`，导致对象卡片只能展示模型名和规则名，缺少和员工详情一致的异常原因快照。
+
+## 实施内容
+
+- 在 `CcdiProjectRiskHitTagVO` 增加 `reasonDetail` 字段。
+- 在外部人员风险来源 SQL 中透传 `ccdi_bank_statement_tag_result.reason_detail`。
+- 在 `selectExternalRiskHitTagsByScope` 中按模型和规则聚合命中标签，并优先返回对象级原因快照；对象级为空时返回流水级原因快照。
+- 同步在员工命中标签查询中映射 JSON 内的 `reasonDetail`，保持 VO 字段语义一致。
+
+## 影响范围
+
+- 外部人员预警列表详情、命中模型外部人员详情的 `riskPointTagList/hitTagList` 响应字段增加 `reasonDetail`。
+- 不改变原有筛选、排序、风险等级和模型统计逻辑。
+
+## 验证
+
+- 执行项目风险模型人员与对象明细相关 Mapper 测试。
+- 执行后端模块编译或打包，确认 VO 与 XML 映射无编译和解析问题。

docs/plans/backend/2026-07-01-fund-graph-edge-detail-export-backend-implementation.md

@@ -0,0 +1,22 @@
+# 资金流向边明细导出后端实施计划（已取消）
+
+## 目标
+
+需求已调整：资金流向逐笔流水明细不再增加“导出明细”，本后端计划不执行。
+
+## 范围
+
+- 不新增资金流向导出 Excel 对象。
+- 不新增资金流向导出接口。
+- 保持现有 `/ccdi/project/fund-graph/edge-detail` 分页查询不变。
+
+## 实施步骤
+
+1. 回收已准备的资金流向导出前后端改动。
+2. 保持资金流向页签仅展示图谱和逐笔流水明细。
+3. 将导出需求调整到“查看详情 > 异常明细”组件内实现。
+
+## 验证
+
+- 搜索确认不存在 `/edge-detail/export`、`exportFundGraphEdgeDetail`、`CcdiFundGraphStatementExcel`。
+- 后端不再因本需求产生新增接口。

docs/plans/frontend/2026-07-01-external-person-detail-reason-frontend-implementation.md

@@ -0,0 +1,21 @@
+# 外部人员详情原因快照前端实施计划
+
+## 背景
+
+外部人员详情的「对象异常明细」展示风格已复用员工详情卡片，但内容缺少原因快照，生产页面显示为泛化文案。
+
+## 实施内容
+
+- 外部人员对象卡片优先展示命中标签中的 `reasonDetail`。
+- 流水标签补全时保留后端返回的 `reasonDetail`。
+- 历史数据缺少 `reasonDetail` 时，基于已加载的关联流水补充笔数、累计金额、最大金额、最近交易时间、主要对手方，避免只展示泛化命中文案。
+
+## 影响范围
+
+- 仅影响 `ExternalPersonDetailDialog.vue` 中「异常明细」页签的对象异常卡片内容。
+- 不调整资金流向、员工详情布局、导出按钮位置和图谱样式。
+
+## 验证
+
+- 使用项目 Node 14.21.3 执行前端构建。
+- 启动真实前后端后，在业务页面打开外部人员「查看详情」检查对象异常明细展示。

docs/plans/frontend/2026-07-01-project-analysis-abnormal-detail-export-frontend-implementation.md

@@ -0,0 +1,25 @@
+# 项目分析异常明细导出前端实施计划
+
+## 目标
+
+在员工风险人员、命中模型涉及人员、外部人员三个“查看详情”入口的“异常明细”页签中增加简洁导出按钮，导出当前弹窗已加载的异常明细数据。
+
+## 范围
+
+- 修改共用组件 `ProjectAnalysisAbnormalTab.vue`。
+- 导出流水异常与对象异常两类明细。
+- 不修改资金流向页签导出能力，资金流向不提供导出按钮。
+
+## 实施步骤
+
+1. 在异常明细页签顶部增加右对齐“导出”按钮。
+2. 使用当前 `detailData.groups` 组装 CSV 数据，覆盖分页外的全部已加载记录。
+3. 流水异常导出本方名称、本方账号、对手方名称、对手方账号、交易信息、异常标签和金额。
+4. 对象异常导出分组、标题、摘要、异常说明、异常标签和补充字段。
+5. 使用 UTF-8 BOM 生成 CSV，保证 Excel 打开中文正常显示。
+
+## 验证
+
+- 前端构建通过。
+- 搜索确认资金流向导出入口不存在。
+- 员工与外部人员详情弹窗均复用该异常明细导出按钮。

docs/plans/frontend/2026-07-01-project-analysis-sidebar-collapse-and-fund-detail-export-frontend-implementation.md

@@ -0,0 +1,28 @@
+# 项目分析详情侧栏收起与异常明细导出前端实施计划
+
+## 目标
+
+在结果总览的项目分析详情弹窗中，减少左侧“人物档案、命中模型摘要”对屏幕宽度的占用，并为“查看详情 > 异常明细”增加导出入口。
+
+## 范围
+
+- 调整 `ProjectAnalysisDialog.vue` 的左右布局，支持左侧侧栏收起和展开。
+- 调整 `ProjectAnalysisSidebar.vue` 的紧凑展示样式，使默认占宽更小。
+- 调整 `ExternalPersonDetailDialog.vue`，保持外部人员详情与员工详情布局一致。
+- 调整 `ProjectAnalysisAbnormalTab.vue`，在异常明细页签提供导出按钮。
+- 资金流向页签不提供导出按钮。
+
+## 实施步骤
+
+1. 在项目分析弹窗中维护 `sidebarCollapsed` 状态，弹窗打开时默认展开。
+2. 在弹窗布局中加入侧栏收起按钮，收起后左侧变为窄栏，右侧主区域占满剩余空间。
+3. 将左侧默认宽度由百分比大侧栏改为固定紧凑宽度，降低对资金流向内容区的挤占。
+4. 将弹窗头部压缩为单行低高度展示，去掉“结果总览”层级文案。
+5. 在异常明细页签增加“导出”按钮，导出当前弹窗已加载的异常明细数据。
+
+## 验证
+
+- 前端构建或语法检查不报错。
+- 真实页面打开项目分析详情后，侧栏可以收起和展开。
+- 员工两个“查看详情”和外部人员“查看详情”均使用同一套紧凑布局。
+- 异常明细页签可看到导出按钮，资金流向页签不出现导出按钮。

docs/reports/implementation/2026-07-01-external-person-detail-reason.md

@@ -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 元”，不再显示泛化命中文案。

docs/reports/implementation/2026-07-01-fund-graph-legend-node-category.md

@@ -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 输出“类型”说明。

docs/reports/implementation/2026-07-01-project-analysis-abnormal-flow-export.md

@@ -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` 均引用该组件。
+- 前端生产构建通过，存在项目既有包体积告警。
+- 当前浏览器控制工具未暴露可调用入口，未完成页面点击下载验证。

docs/reports/implementation/2026-07-01-project-analysis-sidebar-collapse-and-fund-detail-export.md

@@ -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` 导出接口调用。
+- 已执行：真实页面复验左侧区域、侧栏外层、右侧主区均为白色背景；档案区保留单层白色外框，外框外不再出现灰色缝隙；收起按钮在卡片内部且仅显示图标。
+- 已执行：真实页面复验“导出”按钮位于“流水异常明细”标题栏右侧，不位于异常明细整体上层。