ccdi/docs/reports/implementation/2026-05-06-staff-asset-import-and-enterprise-autofill-backend-implementation.md

员工资产导入与实体库自动补入后端实施记录

基本信息

• 实施日期：2026-05-06
• 实施范围：后端
• 关联计划：docs/plans/backend/2026-05-06-staff-asset-import-and-enterprise-autofill-fix-backend-implementation-plan.md

修改内容

双 Sheet 导入任务编排

• 员工信息维护导入入口改为由服务层统一编排员工主 Sheet 与员工资产 Sheet。
• 员工亲属关系维护导入入口改为由服务层统一编排亲属关系主 Sheet 与亲属资产 Sheet。
• 当两个 Sheet 都有数据时，仍返回两个任务 ID，并按主 Sheet 导入成功结果为资产 Sheet 提供同文件内的归属映射。
• 当只导入资产 Sheet 时，仅生成并返回资产导入任务 ID，不生成员工或亲属关系主任务 ID。
• 当两个 Sheet 都为空时，保持返回“至少需要一条数据”。

实体库自动补入

• 新增统一的实体库自动补入服务，按统一社会信用代码去重，只插入实体库不存在的记录。
• 员工企业关系、信贷客户企业关系新增和导入时自动补入实体库。
• 中介新增、编辑和导入时取消“实体库必须已存在”的阻断校验；实体库缺失时按中介来源自动补入，不要求提供机构名称。
• 招投标供应商新增、编辑和导入时，对合法统一社会信用代码的供应商自动补入实体库。
• 新增企业来源枚举 SUPPLIER，用于标识供应商来源。

影响范围

• /ccdi/baseStaff/importData
• /ccdi/staffFmyRelation/importData
• 员工企业关系、信贷客户企业关系、中介、招投标供应商的新增/编辑/导入实体库联动逻辑
• 实体库基础信息表 ccdi_enterprise_base_info

验证记录

• 执行 mvn -pl ccdi-info-collection -am -DskipTests compile，结果：BUILD SUCCESS。
• 执行 mvn -DskipTests compile，结果：BUILD SUCCESS。
• 代码路径核对：员工主 Sheet 为空时仅调用员工资产导入服务并返回 assetTaskId；亲属关系主 Sheet 为空时仅调用亲属资产导入服务并返回 assetTaskId。

备注

• 本次为后端逻辑调整，未修改前端页面代码。
• 现有前端已按 staffTaskId / relationTaskId / assetTaskId 是否存在分别启动轮询，可直接兼容只返回资产任务 ID 的结果。