From b32210c088a11e3dd8a79582a3e24aa5572a69ae Mon Sep 17 00:00:00 2001
From: wkc <978997012@qq.com>
Date: Fri, 20 Mar 2026 12:01:07 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E7=BB=93=E6=9E=9C=E6=80=BB?=
 =?UTF-8?q?=E8=A7=88=E6=A8=A1=E5=9E=8B=E5=88=86=E9=A1=B5=E5=8F=82=E6=95=B0?=
 =?UTF-8?q?=E7=BB=91=E5=AE=9A=E5=BC=82=E5=B8=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../mapper/ccdi/project/CcdiProjectOverviewMapper.xml         | 1 +
 .../mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java  | 1 +
 ...ults-overview-risk-model-linkage-backend-implementation.md | 2 ++
 ...esults-overview-risk-model-linkage-backend-verification.md | 4 ++++
 4 files changed, 8 insertions(+)

diff --git a/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml b/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml
index 312620e5..afa44890 100644
--- a/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml
+++ b/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml
@@ -211,6 +211,7 @@
     </select>
 
     <select id="selectRiskModelPeoplePage" resultMap="RiskModelPeopleItemResultMap">
+        <bind name="projectId" value="query.projectId"/>
         select
             base.project_id,
             base.staff_id_card,
diff --git a/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java b/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java
index 178dea5b..9a518e33 100644
--- a/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java
+++ b/ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperRiskModelPeopleTest.java
@@ -33,6 +33,7 @@ class CcdiProjectOverviewMapperRiskModelPeopleTest {
         assertTrue(xml.contains("query.modelCodes != null and query.modelCodes.size() > 0"));
         assertTrue(xml.contains("query.matchMode == 'ALL'"));
         assertTrue(xml.contains("count(distinct base.model_code) = #{query.modelCodes.size}"));
+        assertTrue(xml.contains("<bind name=\"projectId\" value=\"query.projectId\"/>"));
         assertTrue(xml.contains("base.staff_name like concat('%', trim(#{query.keyword}), '%')"));
         assertTrue(xml.contains("cast(base.staff_code as char) like concat('%', trim(#{query.keyword}), '%')"));
         assertTrue(xml.contains("base.dept_id = #{query.deptId}"));
diff --git a/docs/reports/implementation/2026-03-20-results-overview-risk-model-linkage-backend-implementation.md b/docs/reports/implementation/2026-03-20-results-overview-risk-model-linkage-backend-implementation.md
index 98288d3d..8447f277 100644
--- a/docs/reports/implementation/2026-03-20-results-overview-risk-model-linkage-backend-implementation.md
+++ b/docs/reports/implementation/2026-03-20-results-overview-risk-model-linkage-backend-implementation.md
@@ -7,6 +7,7 @@
 - 新增 [`CcdiProjectRiskModelPeopleQueryDTO.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiProjectRiskModelPeopleQueryDTO.java) 及一组风险模型区 VO，用于承载卡片、分页行和命中标签结构。
 - 在 [`CcdiProjectOverviewMapper.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapper.java) 与 [`CcdiProjectOverviewMapper.xml`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml) 新增模型卡片统计与模型人员分页 SQL。
 - 新增或扩展 [`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) 补充对应断言，防止再次出现参数绑定异常。
 
 ## 处理说明
 
@@ -15,6 +16,7 @@
 - 人员分页中的员工工号使用 `ccdi_base_staff.staff_id` 作为真实字段来源，并在 SQL 中转换为字符后映射到 `staffCode`。
 - `ANY` 模式通过模型范围过滤直接返回并集结果；`ALL` 模式通过 `having count(distinct base.model_code) = #{query.modelCodes.size}` 约束交集结果。
 - `modelNames` 与 `hitTagList` 使用同上下文子查询回填，只返回当前筛选模型范围内的数据。
+- 风险模型人员分页复用公共归并 SQL 时，必须先把 `query.projectId` 绑定到顶层 `projectId`，否则 `resolvedEmployeeRiskBaseSql` 中的 `#{projectId}` 会在 MyBatis 分页查询阶段直接报绑定异常。
 - 服务层对 `matchMode` 缺省值统一收口为 `ANY`，并确保空列表返回空数组、分页行统一附加“查看详情”。
 
 ## 验证情况
diff --git a/docs/tests/records/2026-03-20-results-overview-risk-model-linkage-backend-verification.md b/docs/tests/records/2026-03-20-results-overview-risk-model-linkage-backend-verification.md
index 86ea5edd..208d8e7c 100644
--- a/docs/tests/records/2026-03-20-results-overview-risk-model-linkage-backend-verification.md
+++ b/docs/tests/records/2026-03-20-results-overview-risk-model-linkage-backend-verification.md
@@ -28,10 +28,14 @@ mvn test -pl ccdi-project '-Dtest=CcdiProjectOverview*'
 - 2026-03-20 11:14 执行 `CcdiProjectOverviewServiceImplTest` 红灯验证，确认服务层尚未完成项目校验、分页封装和默认 `ANY` 逻辑。
 - 2026-03-20 11:15 重新执行 `CcdiProjectOverviewServiceImplTest`，9 个测试全部通过。
 - 2026-03-20 11:16 执行结果总览相关总体验证命令 `mvn test -pl ccdi-project '-Dtest=CcdiProjectOverview*'`，共 22 个测试全部通过，0 failure，0 error。
+- 2026-03-20 11:59 根据线上异常日志补充 `CcdiProjectOverviewMapperRiskModelPeopleTest` 红灯断言，确认 `selectRiskModelPeoplePage` 缺少 `query.projectId -> projectId` 绑定桥接。
+- 2026-03-20 11:59 在 `selectRiskModelPeoplePage` 增加 `<bind name="projectId" value="query.projectId"/>` 后重新执行 `CcdiProjectOverviewMapperRiskModelPeopleTest`，2 个测试全部通过。
+- 2026-03-20 12:00 再次执行结果总览相关总体验证命令 `mvn test -pl ccdi-project '-Dtest=CcdiProjectOverview*'`，共 22 个测试全部通过，0 failure，0 error。
 
 ## 结论
 
 - 结果总览模型区后端已补齐两个新接口：模型卡片统计与模型命中人员分页。
 - 人员分页查询已覆盖多模型 `ANY / ALL`、姓名/工号关键字、部门筛选，以及筛选上下文内的 `modelNames`/`hitTagList` 聚合。
+- 风险模型人员分页 SQL 已补齐 `projectId` 绑定桥接，避免公共 SQL 片段在分页查询场景下触发 MyBatis `Parameter 'projectId' not found` 异常。
 - 服务层已统一完成项目存在性校验、空列表封装和“查看详情”动作文案赋值。
 - 本轮验证仅执行 Maven 单元测试，未启动额外前后端进程，因此无需执行进程清理。