ccdi/docs/plans/misc/2026-03-24-special-check-family-asset-liability-test-data-implementation.md

专项核查家庭资产负债测试数据实施计划

For agentic workers: REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (- [ ]) syntax for tracking.

按仓库 AGENTS.md 约定，本次在当前会话直接执行，不启用 subagent。

Goal: 为 project_id = 51 的“员工家庭资产负债专项核查”补充一组可重复执行的测试数据，覆盖正常、风险、高风险和缺失信息等典型情况。

Architecture: 复用现有测试项目 51，直接向 ccdi_base_staff、ccdi_staff_fmy_relation、ccdi_asset_info、ccdi_debts_info、ccdi_bank_statement_tag_result 补充专项核查专用样本，不新增新的项目、流水文件或前端入口。测试数据脚本采用“先删后插”的幂等方式，确保重复执行不会堆积脏数据，并通过与专项核查 SQL 同口径的查询完成验证。

Tech Stack: MySQL 8、仓库脚本 bin/mysql_utf8_exec.sh、专项核查 Mapper SQL、Markdown 实施与验证文档

---

Task 1: 设计覆盖场景与金额口径

Files:

• Modify: docs/plans/misc/2026-03-24-special-check-family-asset-liability-test-data-implementation.md

• Create: sql/migration/2026-03-24-add-special-check-family-asset-liability-test-data.sql

• Step 1: 明确测试项目与入围方式

复用 project_id = 51，通过 ccdi_bank_statement_tag_result.object_type = 'STAFF_ID_CARD' + object_key = 员工身份证号 的对象命中方式将新增员工纳入专项核查范围。

• Step 2: 设计 6 类样本

1. 正常边界：收入 + 负债 = 资产 * 1.5
2. 风险边界：收入 + 负债 = 资产 * 3
3. 高风险：收入 + 负债 > 资产 * 3
4. 缺少本人负债：本人无负债记录，但家庭仍有配偶负债
5. 缺少本人资产：本人无资产记录，但家庭仍有配偶资产
6. 单身完整：无配偶，但本人资产与负债完整

• Step 3: 固化金额口径

所有资产均使用 current_value，所有负债均使用 principal_balance，缺失判断严格沿用专项核查现有逻辑：

• 本人资产记录数为 0 时输出 MISSING_INFO
• 本人负债记录数为 0 时输出 MISSING_INFO

Task 2: 编写幂等测试数据脚本

Files:

• Create: sql/migration/2026-03-24-add-special-check-family-asset-liability-test-data.sql

• Step 1: 先清理专用样本数据

删除本次样本对应的员工、配偶关系、资产、负债和项目命中记录，确保脚本可重复执行。

• Step 2: 插入专项核查员工与配偶关系

新增 6 名专项核查专用员工，其中 5 名带配偶关系，并补充本人/配偶年收入。

• Step 3: 插入资产与负债明细

按场景写入本人与配偶资产、负债，确保边界值和缺失值可直接命中现有风险判断。

• Step 4: 插入项目命中记录

向 ccdi_bank_statement_tag_result 写入对象命中数据，使样本员工进入 project_id = 51 的专项核查范围。

Task 3: 执行脚本并验证结果

Files:

• Modify: docs/reports/implementation/2026-03-24-special-check-family-asset-liability-test-data-record.md

• Create: docs/tests/records/2026-03-24-special-check-family-asset-liability-test-data-verification.md

• Step 1: 执行脚本

Run: bin/mysql_utf8_exec.sh sql/migration/2026-03-24-add-special-check-family-asset-liability-test-data.sql

Expected: 无报错返回，事务成功提交。

• Step 2: 查询列表结果

按专项核查同口径 SQL 查询 project_id = 51 下名称为 专项核查% 的员工，验证金额汇总和风险等级是否符合预期。

• Step 3: 查询缺失信息详情

验证“缺少本人负债样本”“缺少本人资产样本”的详情缺失标记是否分别返回 missingSelfDebtInfo = 1、missingSelfAssetInfo = 1。

• Step 4: 补实施与验证记录

将脚本路径、覆盖场景、执行结果与验证摘要沉淀到实施记录和验证文档中。