# 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 字段、页面正文均正确
