ccdi/docs/reports/implementation/2026-04-23-enterprise-base-info-add-dialog-implementation.md

实体库管理新增弹窗与导入模板调整实施记录

文档路径确认

• 实施记录保存路径：docs/reports/implementation/
• 本文档文件名：2026-04-23-enterprise-base-info-add-dialog-implementation.md

本次修改内容

• 新增弹窗隐藏“数据来源”字段。
• 新增时后端自动写入 MANUAL，不再依赖前端传值。
• 编辑时数据来源改为只读展示，后端更新时保留原值不变。
• 经营状态改为非必填，空值统一按 null 落库。
• 导入模板移除“数据来源”列，并将“经营状态*”改为“经营状态”。
• 导入时后端自动写入 IMPORT。

影响范围

• 后端：
  • ccdi-info-collection/src/main/java/com/ruoyi/info/collection/domain/dto/CcdiEnterpriseBaseInfoAddDTO.java
  • ccdi-info-collection/src/main/java/com/ruoyi/info/collection/domain/dto/CcdiEnterpriseBaseInfoEditDTO.java
  • ccdi-info-collection/src/main/java/com/ruoyi/info/collection/domain/excel/CcdiEnterpriseBaseInfoExcel.java
  • ccdi-info-collection/src/main/java/com/ruoyi/info/collection/service/impl/CcdiEnterpriseBaseInfoServiceImpl.java
  • ccdi-info-collection/src/main/java/com/ruoyi/info/collection/service/impl/CcdiEnterpriseBaseInfoImportServiceImpl.java
• 前端：
  • ruoyi-ui/src/views/ccdiEnterpriseBaseInfo/index.vue
• 测试：
  • ccdi-info-collection/src/test/java/com/ruoyi/info/collection/service/CcdiEnterpriseBaseInfoServiceImplTest.java
  • ccdi-info-collection/src/test/java/com/ruoyi/info/collection/service/CcdiEnterpriseBaseInfoImportServiceImplTest.java
  • ccdi-info-collection/src/test/java/com/ruoyi/info/collection/utils/EasyExcelUtilTemplateTest.java

验证结果

1. 定向单元测试

• 命令： mvn -pl ccdi-info-collection -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=CcdiEnterpriseBaseInfoServiceImplTest,CcdiEnterpriseBaseInfoImportServiceImplTest,EasyExcelUtilTemplateTest test
• 结果： 17 个定向测试全部通过。

补充调整

• 根据追加要求，编辑弹窗中的数据来源已改为不可修改展示。
• 后端更新接口忽略请求里的 dataSource 变更，统一沿用数据库原值。

2. 真实后端接口验证

• 使用 /login/test 获取 token 后，调用新增接口仅传：
  • socialCreditCode
  • enterpriseName
  • riskLevel
  • entSource
• 结果：
  • 新增成功
  • 查询结果中 status=null
  • 查询结果中 dataSource=MANUAL
  • 删除测试数据成功

3. 导入模板实际下载校验

• 通过真实接口下载模板文件到 output/spreadsheet/enterprise-base-info-template-20260423.xlsx
• 核对首行表头结果：
  • 包含 经营状态
  • 包含 风险等级*
  • 包含 企业来源*
  • 不包含 数据来源

4. 浏览器实际页面验证

• 前端按仓库要求执行 nvm use，确认使用 Node v14.21.3
• 启动 ruoyi-ui 开发服务并用 Playwright 打开真实页面 实体库管理
• 实际观察结果：
  • 新增弹窗中“数据来源”字段已隐藏
  • 经营状态不再显示为必填项
  • 导入入口可正常打开

过程说明

• 验证时发现 62318 初始运行的是旧后端进程，仍返回“经营状态不能为空”，随后已按规范使用 bin/restart_java_backend.sh restart 重启后端并完成回归验证。
• 浏览器内尝试直接提交测试数据时页面没有明确反馈，因此补充了真实接口新增/查询/删除验证来完成链路闭环，并已清理测试数据。