完善外部人员预警与项目分析上线内容

docs/plans/backend/2026-06-24-external-person-warning-backend-implementation.md

@@ -0,0 +1,46 @@
+# 外部人员预警后端实施计划
+
+## 目标
+
+在不改变结果总览员工主口径的前提下，新增外部人员预警查询与导出能力，使中介、客户、其他外部人员作为本方流水导入后，也能在结果总览中形成预警结果。
+
+## 实施范围
+
+1. 新增外部人员预警分页接口。
+2. 新增外部人员预警导出接口。
+3. 新增外部人员模型统计接口。
+4. 新增外部人员模型命中人员分页接口。
+5. 扩展涉疑交易明细筛选，支持外部人员相关流水。
+6. 补充外部人员预警测试数据 SQL。
+
+## 业务口径
+
+1. 本方 `cret_no` 命中员工身份证号时，归入员工。
+2. 本方 `cret_no` 命中员工亲属证件号时，归入员工亲属。
+3. 本方 `cret_no` 未命中员工和员工亲属时，归入外部人员。
+4. 外部人员 `cret_no` 命中中介库本人证件号时，主体类型为中介。
+5. 外部人员 `cret_no` 命中信贷客户证件号时，主体类型为客户。
+6. 其他外部人员统一显示为外部人员。
+7. 外部人员只跑交易和关系类模型，不套用员工资产、负面征信、岗位部门类模型。
+
+## 模型范围
+
+1. `EXTERNAL_LARGE_TRANSACTION`：外部人员大额交易。
+2. `EXTERNAL_ABNORMAL_TRANSACTION`：外部人员异常交易。
+3. `EXTERNAL_SUSPICIOUS_GAMBLING`：外部人员可疑赌博。
+4. `EXTERNAL_SUSPICIOUS_RELATION`：外部人员可疑关系。
+
+## 数据实现
+
+本轮采用直接聚合现有流水和标签结果的最短路径，不新增结果快照表：
+
+1. 外部人员主体来自 `ccdi_bank_statement.cret_no`。
+2. 命中模型来自 `ccdi_bank_statement_tag_result` 中外部人员模型编码。
+3. 与员工或员工亲属的关系来自交易对手证件号、交易对手姓名、账户库命中结果。
+4. 中介识别优先使用中介库 `person_id`，不使用姓名作为主体识别依据。
+
+## 验证
+
+1. 执行新增测试数据 SQL。
+2. 运行 `mvn test -pl ccdi-project` 相关测试或至少编译 `ccdi-project`。
+3. 启动后端后验证新增接口返回外部人员预警列表、模型统计和导出接口。

docs/plans/backend/2026-06-29-special-check-project-employee-scope-backend-implementation.md

@@ -0,0 +1,29 @@
+# 专项分析项目员工范围后端实施计划
+
+## 背景
+
+专项分析原先通过项目打标命中结果解析员工范围。未命中风险规则的项目员工不会展示在专项分析中，无法满足“项目内员工即使未命中也进行专项排查”的业务要求。
+
+## 实施范围
+
+- 修改专项分析公共员工范围 SQL。
+- 范围口径调整为：项目已入库银行流水 `ccdi_bank_statement` 中 `cret_no` 能匹配员工主数据 `ccdi_base_staff.id_card` 的员工。
+- 不新增前端入口、不新增人工纳入表、不伪造打标命中结果。
+
+## 实施步骤
+
+1. 调整 `CcdiProjectSpecialCheckMapper.xml` 中 `projectEmployeeScopeSql`。
+2. 使用 `ccdi_bank_statement.project_id` 和 `cret_no` 获取项目员工范围。
+3. 关联 `ccdi_base_staff` 获取员工姓名、柜员号、部门。
+4. 保持资产负债专项核查、采购拓展、招聘拓展、调动拓展共用同一员工范围。
+
+## 影响范围
+
+- 员工家庭资产负债专项核查列表与详情。
+- 专项分析下采购拓展、招聘拓展、调动拓展查询。
+- 结果总览风险人员统计不在本次调整范围内，仍按打标结果口径。
+
+## 验证计划
+
+- 执行 Maven 编译，确认 Mapper XML 与 Java 工程可编译。
+- 检查 SQL 引用字段存在且口径与项目目标人数回填逻辑一致。