完善结果总览模型区卡片展示与联动修复

docs/reports/implementation/2026-03-20-results-overview-risk-model-linkage-backend-implementation.md

@@ -9,16 +9,19 @@
 - 新增或扩展 [`CcdiProjectOverviewControllerContractTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/controller/CcdiProjectOverviewControllerContractTest.java)、[`CcdiProjectOverviewMapperRiskModelCardsTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelCardsTest.java)、[`CcdiProjectOverviewMapperRiskModelPeopleTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java)、[`CcdiProjectOverviewServiceImplTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectOverviewServiceImplTest.java) 以覆盖契约、SQL 和服务封装。
 - 根据 2026-03-20 线上分页异常，在 [`CcdiProjectOverviewMapper.xml`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml) 的 `selectRiskModelPeoplePage` 增加 `<bind name="projectId" value="query.projectId"/>`，并在 [`CcdiProjectOverviewMapperRiskModelPeopleTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java) 补充对应断言，防止再次出现参数绑定异常。
 - 根据 2026-03-20 线上 MySQL 3065 异常，将 [`CcdiProjectOverviewMapper.xml`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml) 中 `selectRiskModelNamesByScope` 从 `select distinct` 调整为 `group by scoped.model_code, scoped.model_name`，并在 [`CcdiProjectOverviewMapperRiskModelPeopleTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java) 补充兼容性断言。
+- 根据 2026-03-20 线上 `matchMode=ALL` 的 `UnsupportedOperationException`，在 [`CcdiProjectRiskModelPeopleQueryDTO.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiProjectRiskModelPeopleQueryDTO.java) 新增显式只读字段 `modelCodesCount`，并将 [`CcdiProjectOverviewMapper.xml`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml) 中 `having count(distinct base.model_code) = #{query.modelCodes.size}` 改为 `#{query.modelCodesCount}`，同时更新 [`CcdiProjectOverviewMapperRiskModelPeopleTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java) 回归断言。
+- 根据“模型触发次数为 0 也要展示卡片”的新要求，将 [`CcdiProjectOverviewMapper.xml`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml) 中 `selectRiskModelCardsByProjectId` 从命中结果直聚合改为以 `ccdi_bank_tag_rule` 启用模型为主表、左连项目命中聚合，并更新 [`CcdiProjectOverviewMapperRiskModelCardsTest.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelCardsTest.java) 回归断言。
 
 ## 处理说明
 
 - 继续复用现有 `CcdiProjectOverviewController + Service + Mapper` 结果总览链路，没有新增平行模块或补丁式接口。
-- 模型卡片统计与人员分页统一建立在“员工本人 + 亲属归并到员工名下”的基础归并 SQL 上，确保与既有风险人员口径一致。
+- 模型卡片展示口径以 `ccdi_bank_tag_rule` 中启用的全量模型定义为准，不再只返回已命中的模型；卡片命中统计与人员分页仍统一建立在“员工本人 + 亲属归并到员工名下”的基础归并 SQL 上，确保与既有风险人员口径一致。
 - 人员分页中的员工工号使用 `ccdi_base_staff.staff_id` 作为真实字段来源，并在 SQL 中转换为字符后映射到 `staffCode`。
-- `ANY` 模式通过模型范围过滤直接返回并集结果；`ALL` 模式通过 `having count(distinct base.model_code) = #{query.modelCodes.size}` 约束交集结果。
+- `ANY` 模式通过模型范围过滤直接返回并集结果；`ALL` 模式通过 `having count(distinct base.model_code) = #{query.modelCodesCount}` 约束交集结果，避免在 MyBatis 参数绑定阶段直接读取集合包装器属性。
 - `modelNames` 与 `hitTagList` 使用同上下文子查询回填，只返回当前筛选模型范围内的数据。
 - 风险模型人员分页复用公共归并 SQL 时，必须先把 `query.projectId` 绑定到顶层 `projectId`，否则 `resolvedEmployeeRiskBaseSql` 中的 `#{projectId}` 会在 MyBatis 分页查询阶段直接报绑定异常。
 - 风险模型名称子查询需要按 `model_code` 保序返回，但不能使用 `distinct + order by 非 select 列` 组合；这里改为 `group by scoped.model_code, scoped.model_name` 后再排序，以兼容当前 MySQL 配置。
+- 风险模型卡片查询改为从 `ccdi_bank_tag_rule` 先聚合出启用模型，再左连项目命中统计，`warningCount/peopleCount` 统一通过 `coalesce(..., 0)` 回填，确保 0 次模型卡片也能展示。
 - 服务层对 `matchMode` 缺省值统一收口为 `ANY`，并确保空列表返回空数组、分页行统一附加“查看详情”。
 
 ## 验证情况
@@ -38,4 +41,12 @@ mvn test -pl ccdi-project -Dtest=CcdiProjectOverviewServiceImplTest
 mvn test -pl ccdi-project '-Dtest=CcdiProjectOverview*'
 ```
 
-- 总体验证结果：22 个测试全部通过，0 failure，0 error。
+- 已执行重新打包与真实接口回归：
+
+```bash
+mvn -pl ruoyi-admin -am package -DskipTests
+java -jar ruoyi-admin/target/ruoyi-admin.jar --server.port=62319
+```
+
+- 真实接口回归覆盖 `/risk-models/cards`、人员默认分页、单模型 `ANY`、单模型 `ALL`，项目 `42` 的实际返回均为 `code=200`，其中卡片接口返回 `10` 张模型卡片，仅 `1` 张存在真实命中，其余 `9` 张为 `warningCount=0`、`peopleCount=0`。
+- 总体验证结果：22 个测试全部通过，0 failure，0 error；临时启动的 `62319` 实例已在验证完成后关闭。

docs/reports/implementation/2026-03-20-results-overview-risk-model-linkage-frontend-implementation.md

@@ -6,7 +6,7 @@
 - 在 [`PreliminaryCheck.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/PreliminaryCheck.vue) 接入模型卡片真实请求，并把模型区列表查询职责下沉到 [`RiskModelSection.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/RiskModelSection.vue)。
 - 在 [`preliminaryCheck.mock.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/preliminaryCheck.mock.js) 清理旧的模型筛选 mock 依赖，补齐模型卡片归一化逻辑和空态结构。
 - 在 [`RiskModelSection.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/RiskModelSection.vue) 实现多卡片选中/取消、`ANY / ALL` 匹配方式、关键词与部门筛选、分页请求、模型摘要和异常标签展示。
-- 新增或更新 [`preliminary-check-model-api.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-api.test.js)、[`preliminary-check-model-data-loading.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-data-loading.test.js)、[`preliminary-check-model-multiselect.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-multiselect.test.js)、[`preliminary-check-model-match-mode.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-match-mode.test.js)、[`preliminary-check-model-filters.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-filters.test.js)、[`preliminary-check-model-table-columns.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-table-columns.test.js)、[`preliminary-check-model-linkage-flow.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-linkage-flow.test.js) 与 [`preliminary-check-model-and-detail.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-and-detail.test.js)，覆盖接口、状态、筛选和联动流。
+- 新增或更新 [`preliminary-check-model-api.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-api.test.js)、[`preliminary-check-model-data-loading.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-data-loading.test.js)、[`preliminary-check-model-multiselect.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-multiselect.test.js)、[`preliminary-check-model-match-mode.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-match-mode.test.js)、[`preliminary-check-model-filters.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-filters.test.js)、[`preliminary-check-model-table-columns.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-table-columns.test.js)、[`preliminary-check-model-linkage-flow.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-linkage-flow.test.js)、[`preliminary-check-model-and-detail.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-and-detail.test.js) 与 [`preliminary-check-model-card-grid.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-card-grid.test.js)，覆盖接口、状态、筛选、联动流和卡片布局断点。
 
 ## 处理说明
 
@@ -15,6 +15,7 @@
 - 模型卡片支持多选，再次点击可取消；请求参数统一携带 `modelCodes + matchMode + keyword + deptId + pageNum + pageSize`。
 - 模型区人员列表改为展示姓名、工号、身份证号、所属部门、命中模型摘要和异常标签；异常标签复用 [`DetailQuery.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/DetailQuery.vue) 的风险等级颜色映射。
 - 部门选项复用系统现有的 `deptTreeSelect` 接口，并在前端展开为可筛选下拉项，保持最短路径实现。
+- 模型卡片网格在桌面端调整为固定 5 列，使 10 张卡片按两行展示；平板端降为 2 列，手机端降为 1 列，避免窄屏下卡片挤压。
 
 ## 验证情况
 
@@ -30,6 +31,7 @@ node tests/unit/preliminary-check-model-filters.test.js
 node tests/unit/preliminary-check-model-table-columns.test.js
 node tests/unit/preliminary-check-model-linkage-flow.test.js
 node tests/unit/preliminary-check-model-and-detail.test.js
+node tests/unit/preliminary-check-model-card-grid.test.js
 ```
 
-- 总体验证结果：8 个前端单测命令全部通过，0 failure，0 error。
+- 总体验证结果：9 个前端单测命令全部通过，0 failure，0 error。