# 员工信息维护导入模板文本格式实施记录

## 背景

- 员工信息维护导入模板中，“身份证号”“电话”列需要使用文本单元格格式，避免 Excel 将长数字或手机号自动识别为数值格式。
- 当前模板生成链路已支持 `@TextFormat` 注解并由 `TextFormatWriteHandler` 统一处理，但员工信息 Sheet 的对应字段未标注该注解。

## 修改内容

- 在 `CcdiBaseStaffExcel` 中为“身份证号”字段增加 `@TextFormat`。
- 在 `CcdiBaseStaffExcel` 中为“电话”字段增加 `@TextFormat`。
- 更新 `EasyExcelUtilTemplateTest`，在员工信息模板测试中断言第 3 列“身份证号”和第 4 列“电话”的默认列格式均为文本格式 `@`。

## 影响范围

- 影响接口：`/ccdi/baseStaff/importTemplate`。
- 影响文件：
  - `ccdi-info-collection/src/main/java/com/ruoyi/info/collection/domain/excel/CcdiBaseStaffExcel.java`
  - `ccdi-info-collection/src/test/java/com/ruoyi/info/collection/utils/EasyExcelUtilTemplateTest.java`
- 不改变导入字段、字段顺序、导入校验规则和前端页面逻辑。

## 验证情况

- 已执行定向模板单测：

```bash
MAVEN_OPTS="-javaagent:$HOME/.m2/repository/net/bytebuddy/byte-buddy-agent/1.17.8/byte-buddy-agent-1.17.8.jar" mvn -pl ccdi-info-collection -am -Dtest=EasyExcelUtilTemplateTest -Dsurefire.failIfNoSpecifiedTests=false test
```

- 验证结果：通过，`EasyExcelUtilTemplateTest` 共 5 个用例，0 失败，0 错误。
- 测试日志确认员工信息 Sheet 第 3 列、第 4 列均已执行文本格式设置。
- 本次未启动前端或后端进程，无需额外清理运行进程。
