72 lines
2.0 KiB
Markdown
72 lines
2.0 KiB
Markdown
# 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 字段、页面正文均正确
|