新增征信员工HTML样本并改造Mock解析

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

@@ -0,0 +1,71 @@
+# 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`
+
+## 验证记录
+
+### 自动化测试
+
+执行命令：
+
+```bash
+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 个测试全部通过
+
+### 语法校验
+
+执行命令：
+
+```bash
+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
+```
+
+结果：
+
+- 校验通过
+
+### 样本生成
+
+执行命令：
+
+```bash
+python3 bin/generate_credit_staff_html.py
+```
+
+结果：
+
+- 成功生成 1004 个员工征信 HTML 样本
+- 抽查样本 `0001_徐伟_2040.html`，姓名和身份证 Meta 字段、页面正文均正确