ccdi/docs/reports/implementation/2026-03-23-credit-html-mock-implementation.md

2026-03-23 征信 HTML 样本生成与 Mock 解析改造记录

本次改动

• 新增员工征信样本导出能力，从 ccdi_base_staff 读取有效员工姓名、身份证号，生成一人一份 HTML。
• 新增征信 HTML 身份解析能力，/xfeature-mngs/conversation/htmlEval 改为读取上传 HTML 中的员工姓名与身份证号。
• 保留征信其他字段的随机生成逻辑，但随机种子加入员工姓名、身份证号，保证同一员工结果稳定。

主要文件

• bin/generate_credit_staff_html.py
• lsfx-mock-server/services/staff_credit_html_export_service.py
• lsfx-mock-server/services/credit_html_identity_service.py
• lsfx-mock-server/services/staff_identity_repository.py
• lsfx-mock-server/services/credit_payload_service.py
• lsfx-mock-server/routers/credit_api.py

样本输出

• 输出目录：assets/征信解析员工样本/
• 本次生成数量：1004 个 HTML
• 文件命名规则：4位序号_员工姓名_身份证后4位.html

验证记录

自动化测试

执行命令：

python3 -m pytest \
  lsfx-mock-server/tests/test_credit_api.py \
  lsfx-mock-server/tests/test_credit_payload_service.py \
  lsfx-mock-server/tests/test_credit_html_identity_service.py \
  lsfx-mock-server/tests/test_staff_credit_html_export_service.py

结果：

• 8 个测试全部通过

语法校验

执行命令：

python3 -m py_compile \
  lsfx-mock-server/services/credit_html_identity_service.py \
  lsfx-mock-server/services/staff_credit_html_export_service.py \
  lsfx-mock-server/services/staff_identity_repository.py \
  lsfx-mock-server/services/credit_payload_service.py \
  lsfx-mock-server/routers/credit_api.py \
  bin/generate_credit_staff_html.py

结果：

• 校验通过

样本生成

执行命令：

python3 bin/generate_credit_staff_html.py

结果：

• 成功生成 1004 个员工征信 HTML 样本
• 抽查样本 0001_徐伟_2040.html，姓名和身份证 Meta 字段、页面正文均正确