调整专项排查资产收入匹配口径

docs/plans/backend/2026-07-16-special-check-asset-income-caliber-backend-implementation.md

@@ -0,0 +1,39 @@
+# 专项排查资产收入匹配口径后端实施计划
+
+## 保存路径确认
+
+本文档保存于 `docs/plans/backend/`，用于记录专项排查后端口径调整计划。
+
+## 背景
+
+专项排查家庭资产负债原逻辑将无负债记录判为缺少信息，且使用收入、负债、资产之间的旧比较方式，无法满足“无负债仍需输出资产收入匹配判断”的业务口径。
+
+## 实施范围
+
+- 调整 `CcdiProjectSpecialCheckMapper.xml` 中家庭资产负债列表与详情查询。
+- 保留家庭总年收入、家庭总资产、家庭总负债等原字段。
+- 新增本人年收入、配偶年收入、本人入职年限、可解释收入、资产收入倍数等返回字段。
+- 风险等级统一为 `高关注`、`关注`、`正常`、`缺少信息`。
+
+## 计算口径
+
+- 本人年收入取 `ccdi_base_staff.annual_income`。
+- 本人入职年限由 `ccdi_base_staff.hire_date` 按当前日期折算，不足 1 年按 1 年。
+- 配偶年收入取配偶员工年收入或亲属关系年收入。
+- 家庭总资产取本人及配偶 `ccdi_asset_info.current_value` 合计。
+- 家庭总负债取本人及配偶 `ccdi_debts_info.principal_balance` 合计，无记录按 0。
+- 可解释收入 = 本人年收入 × 本人入职年限 + 配偶年收入 + 家庭总负债。
+- 资产收入倍数 = 家庭总资产 / 可解释收入。
+
+## 风险规则
+
+- 缺少信息：本人年收入为空或小于等于 0、入职时间为空、家庭总资产为空或小于等于 0。
+- 正常：资产收入倍数小于等于 1.5。
+- 关注：资产收入倍数大于 1.5 且小于等于 3。
+- 高关注：资产收入倍数大于 3。
+
+## 验证计划
+
+- 执行后端编译或针对 `ccdi-project` 模块的编译检查。
+- 检查 MyBatis XML 中新增字段映射与 SQL 别名一致。
+- 对典型数据进行公式复核：年收入 20 万、入职 10 年、资产 586 万、负债 0 时应为关注。

docs/plans/frontend/2026-07-16-special-check-asset-income-caliber-frontend-implementation.md

@@ -0,0 +1,42 @@
+# 专项排查资产收入匹配口径前端实施计划
+
+## 保存路径确认
+
+本文档保存于 `docs/plans/frontend/`，用于记录专项排查前端展示调整计划。
+
+## 背景
+
+专项排查家庭资产负债详情需要展示新的资产收入匹配结论，并将家庭总年收入改为万元展示，便于业务人员阅读。
+
+## 实施范围
+
+- 调整 `FamilyAssetLiabilitySection.vue` 列表中的家庭总年收入展示为万元。
+- 调整 `FamilyAssetLiabilityDetail.vue` 总收入、本人收入、配偶收入展示为万元。
+- 将详查结果结论改为分行展示。
+- 结论显示风险等级、家庭总资产、可解释收入公式和资产收入倍数。
+
+## 展示口径
+
+详查结果结论示例：
+
+```text
+关注
+
+家庭总资产：586.00 万元
+可解释收入：本人年收入 20.00 万元 × 入职年限 10 年 + 配偶年收入 0.00 万元 + 家庭总负债 0.00 万元 = 200.00 万元
+资产收入倍数：2.93
+```
+
+缺少信息时仅显示：
+
+```text
+缺少资产，暂无法判断。
+```
+
+缺少项会按实际情况展示为收入、资产或入职时间；多项同时缺失时展示“关键信息不完整，暂无法判断。”。
+
+## 验证计划
+
+- 执行前端构建或静态编译检查。
+- 页面验证专项排查列表家庭总年收入为万元。
+- 页面验证详查结果按多行展示，且长公式不溢出容器。

docs/reports/implementation/2026-07-16-special-check-asset-income-caliber.md

@@ -0,0 +1,32 @@
+# 专项排查资产收入匹配口径实施记录
+
+## 保存路径确认
+
+本文档保存于 `docs/reports/implementation/`，用于记录本次专项排查口径调整的实施内容、影响范围与验证情况。
+
+## 修改内容
+
+- 后端专项排查家庭资产负债查询新增本人年收入、配偶年收入、入职年限、可解释收入、资产收入倍数。
+- 后端风险结论改为 `高关注`、`关注`、`正常`、`缺少信息`。
+- 无负债记录不再阻断结论判断，负债金额按 0 纳入可解释收入。
+- 前端专项排查列表中家庭总年收入改为万元展示。
+- 前端详查结果改为分行展示家庭总资产、可解释收入公式与资产收入倍数。
+- 缺少信息结论按实际缺项展示收入、资产或入职时间，多项缺失时展示关键信息不完整。
+- 隐藏家庭资产负债表格内置展开箭头，保留“查看详情”按钮作为展开入口，避免展开箭头挤在序号列前导致显示异常。
+
+## 影响范围
+
+- `ccdi-project` 专项排查家庭资产负债接口。
+- `ruoyi-ui` 项目详情专项排查家庭资产负债列表与展开详情。
+- 不涉及员工信息维护、资产导入、征信负债导入和数据库结构变更。
+
+## 验证情况
+
+- 已执行 `mvn -pl ccdi-project -am compile -DskipTests`，编译通过。执行过程中 Maven 提示 `ccdi-info-collection` 中存在既有重复依赖声明警告，本次未调整该无关问题。
+- 已执行前端 Node 环境确认。`.nvmrc` 指向 `14.21.3`，但本机 PowerShell 环境下 `nvm use` 未能直接切换该版本；按仓库约定改用已验证可用的 `Node v22.22.3`、`npm 10.9.8`。
+- 已执行 `npm run build:prod`，生产构建通过。构建输出存在既有资源体积警告，本次未调整该无关问题。
+- 已重新完整打包并启动真实后端 `ruoyi-admin.jar`，确认 62318 端口由本仓库 Java 进程监听，日志出现 `Started RuoYiApplication`。
+- 已在真实页面验证项目 42：员工“模型二测试员工”有收入、有入职时间、有资产、无负债，列表家庭总年收入展示为 `12.35 万元`，风险情况为 `正常`；详查结果展示 `本人年收入 12.35 万元 × 入职年限 7 年 + 配偶年收入 0.00 万元 + 家庭总负债 0.00 万元 = 86.42 万元`。
+- 已在真实页面验证项目 44：同一项目内两名员工均可按新口径展示，列表家庭总年收入分别展示为 `24.35 万元`、`12.35 万元`，风险情况为 `正常`。
+- 已在真实页面验证项目 90629002：员工有收入和入职时间但无资产，列表风险情况为 `缺少信息`，详查结果显示 `缺少资产，暂无法判断。`
+- 已在真实页面验证家庭资产负债表格展开箭头隐藏生效，序号列前不再显示异常符号；继续通过“查看详情”展开明细。