更新员工资产信息归户规则设计与计划
This commit is contained in:
@@ -6,8 +6,14 @@
|
||||
本次设计基于 `2026-03-12` 确认了以下业务约束：
|
||||
|
||||
- 资产表保留字段名 `person_id`
|
||||
- `person_id` 存员工身份证号，关联 `ccdi_base_staff.id_card`
|
||||
- 资产表新增 `family_id`
|
||||
- `family_id` 存归属员工身份证号
|
||||
- `person_id` 存资产实际持有人身份证号
|
||||
- 员工本人资产：`family_id = person_id = 员工身份证号`
|
||||
- 员工亲属资产：`family_id = 员工身份证号`，`person_id = 亲属身份证号`
|
||||
- `asset_id` 改为数据库自增主键，不出现在导入模板中
|
||||
- 资产导入模板不要求填写 `family_id`
|
||||
- 导入员工资产信息时，系统根据 `person_id` 自动填充归属员工的 `id_card` 到 `family_id`
|
||||
- 资产导入失败记录入口需与员工导入失败记录入口明确区分，按钮文案为“查看员工资产导入失败记录”
|
||||
|
||||
## 目标
|
||||
@@ -80,12 +86,14 @@
|
||||
新增 `ccdi_asset_info` 表，字段来源于 `assets/资产信息表.csv`，并做以下调整：
|
||||
|
||||
- `asset_id`：`BIGINT` 自增主键
|
||||
- `person_id`：`VARCHAR(18)`，保存员工身份证号，关联 `ccdi_base_staff.id_card`
|
||||
- `family_id`：`VARCHAR(18)`，保存归属员工身份证号，关联 `ccdi_base_staff.id_card`
|
||||
- `person_id`：`VARCHAR(18)`，保存资产实际持有人身份证号
|
||||
- 审计字段沿用当前项目规范，由后端自动填充
|
||||
|
||||
建议字段如下：
|
||||
|
||||
- `asset_id`
|
||||
- `family_id`
|
||||
- `person_id`
|
||||
- `asset_main_type`
|
||||
- `asset_sub_type`
|
||||
@@ -104,6 +112,7 @@
|
||||
|
||||
建议索引：
|
||||
|
||||
- `idx_family_id(family_id)`
|
||||
- `idx_person_id(person_id)`
|
||||
- `idx_asset_main_type(asset_main_type)`
|
||||
|
||||
@@ -134,19 +143,20 @@
|
||||
|
||||
后端聚合规则：
|
||||
|
||||
- 查询员工详情时，按员工 `id_card` 查询全部资产并组装到 `assetInfoList`
|
||||
- 新增员工时，先保存员工，再以员工 `id_card` 回填并保存资产列表
|
||||
- 编辑员工时，更新员工主信息，再按员工身份证号重建资产列表
|
||||
- 删除员工时，先删资产再删员工，整个过程置于同一事务内
|
||||
- 查询员工详情时，按员工 `id_card` 查询 `family_id = 员工身份证号` 的全部资产并组装到 `assetInfoList`
|
||||
- 新增员工时，先保存员工，再以员工 `id_card` 回填资产列表中的 `family_id`
|
||||
- 编辑员工时，更新员工主信息，再按员工身份证号重建以 `family_id` 归户的资产列表
|
||||
- 删除员工时，先按 `family_id` 删除资产再删员工，整个过程置于同一事务内
|
||||
|
||||
### 编辑时的资产处理策略
|
||||
编辑员工时不要求前端传递资产行状态，直接按“当前完整列表”覆盖：
|
||||
|
||||
- 获取编辑前员工旧身份证号
|
||||
- 更新员工主信息
|
||||
- 如果身份证号变更，按旧身份证号删除旧资产
|
||||
- 按当前最新身份证号删除对应资产
|
||||
- 将前端提交的资产列表统一设置 `person_id = 当前员工身份证号`
|
||||
- 如果身份证号变更，按旧身份证号删除 `family_id = 旧身份证号` 的旧资产
|
||||
- 按当前最新身份证号删除 `family_id = 当前身份证号` 的对应资产
|
||||
- 当前员工本人资产设置 `family_id = person_id = 当前员工身份证号`
|
||||
- 当前员工亲属资产设置 `family_id = 当前员工身份证号`，`person_id = 资产实际持有人身份证号`
|
||||
- 批量插入最新资产列表
|
||||
|
||||
该策略实现简单，能直接覆盖资产新增、编辑、删除三种变化。
|
||||
@@ -171,12 +181,18 @@
|
||||
#### 员工保存时
|
||||
- 员工基础信息仍沿用现有校验规则
|
||||
- `assetInfoList` 中空行自动过滤
|
||||
- 资产必填项：`assetMainType`、`assetSubType`、`assetName`、`currentValue`、`assetStatus`
|
||||
- 资产必填项：`personId`、`assetMainType`、`assetSubType`、`assetName`、`currentValue`、`assetStatus`
|
||||
- 数值和日期格式必须合法
|
||||
- 后端强制回填 `person_id = 员工 id_card`
|
||||
- 后端强制回填 `family_id = 员工 id_card`
|
||||
- 当 `personId = 员工 id_card` 时，视为员工本人资产
|
||||
- 当 `personId != 员工 id_card` 时，视为员工亲属资产
|
||||
|
||||
#### 资产导入时
|
||||
- `person_id` 必填，且必须能匹配到员工 `id_card`
|
||||
- 模板中仅要求填写 `person_id`，不要求填写 `family_id`
|
||||
- 若 `person_id` 能匹配员工 `id_card`，视为员工本人资产，自动填充 `family_id = 该员工 id_card`
|
||||
- 若 `person_id` 不能匹配员工 `id_card`，则继续匹配员工亲属关系中的亲属身份证号，匹配成功后自动填充对应员工的 `id_card` 到 `family_id`
|
||||
- 若 `person_id` 同时匹配到多个员工家庭，则导入失败，原因标记为“资产归属员工不唯一”
|
||||
- 若 `person_id` 在员工和员工亲属关系中均无法匹配，则导入失败
|
||||
- 模板中不包含 `asset_id`
|
||||
- 允许同一员工导入多条资产
|
||||
- 失败记录仅返回失败数据，不返回成功数据
|
||||
@@ -202,6 +218,7 @@
|
||||
|
||||
子表字段：
|
||||
|
||||
- 资产实际持有人身份证号
|
||||
- 资产大类
|
||||
- 资产小类
|
||||
- 资产名称
|
||||
@@ -219,32 +236,40 @@
|
||||
- 分区右侧提供“新增资产”按钮
|
||||
- 每行支持删除
|
||||
- 编辑时回显 `assetInfoList`
|
||||
- 前端不展示 `asset_id`、`person_id`
|
||||
- 前端不展示 `asset_id`、`family_id`
|
||||
- 前端允许填写 `personId`，用于表示资产实际持有人身份证号
|
||||
- 当 `personId` 与当前员工身份证号一致时，视为本人资产；不一致时，视为亲属资产
|
||||
|
||||
### 详情弹窗
|
||||
在“员工详情”弹窗中新增“资产信息”区域，使用只读表格展示全部资产。
|
||||
|
||||
若无资产数据，显示“暂无资产信息”空状态。
|
||||
|
||||
详情表格建议增加：
|
||||
|
||||
- `personId`：资产实际持有人身份证号
|
||||
- `ownerType`：本人 / 亲属
|
||||
|
||||
## 数据流
|
||||
|
||||
### 员工新增
|
||||
前端提交员工基础信息和 `assetInfoList`，后端保存员工后按 `id_card` 批量保存资产。
|
||||
前端提交员工基础信息和 `assetInfoList`，后端保存员工后按员工 `id_card` 为每条资产回填 `family_id`，再批量保存资产。
|
||||
|
||||
### 员工编辑
|
||||
前端拉取员工详情回显基础信息和资产列表，用户修改后提交完整列表，后端按最新员工身份证号重建资产明细。
|
||||
前端拉取员工详情回显基础信息和资产列表，用户修改后提交完整列表，后端按最新员工身份证号重建 `family_id = 员工身份证号` 的资产明细。
|
||||
|
||||
### 员工详情
|
||||
后端查询员工主信息，再按 `id_card` 查询资产列表并一并返回。
|
||||
后端查询员工主信息，再按 `family_id = 员工身份证号` 查询资产列表并一并返回。
|
||||
|
||||
### 员工删除
|
||||
后端先按员工身份证号删除资产，再删除员工主记录。
|
||||
后端先按 `family_id = 员工身份证号` 删除资产，再删除员工主记录。
|
||||
|
||||
### 资产导入
|
||||
前端上传资产 Excel，后端异步校验并批量插入资产数据，失败记录通过独立入口查看。
|
||||
前端上传资产 Excel，后端根据 `person_id` 自动识别归属员工并回填 `family_id`，异步校验并批量插入资产数据，失败记录通过独立入口查看。
|
||||
|
||||
## 异常处理
|
||||
- 资产导入时，若 `person_id` 无法匹配员工，记录失败原因
|
||||
- 资产导入时，若 `person_id` 无法匹配员工本人或员工亲属，记录失败原因
|
||||
- 资产导入时，若 `person_id` 对应多个员工家庭，记录归属不唯一失败原因
|
||||
- 员工编辑时若身份证号变更，必须同步处理旧资产清理和新资产重建
|
||||
- 员工删除和员工编辑资产重建均使用事务，防止主从数据不一致
|
||||
- 前端提示文案中明确区分“员工导入”和“员工资产导入”
|
||||
@@ -256,4 +281,5 @@
|
||||
- 员工详情弹窗中可查看该员工全部资产信息
|
||||
- 删除员工后，该员工资产信息同步删除
|
||||
- 资产导入模板不包含 `asset_id`
|
||||
- 资产导入使用 `person_id` 关联员工身份证号
|
||||
- 资产导入模板不填写 `family_id`
|
||||
- 资产导入使用 `person_id` 识别资产实际持有人，并自动回填归属员工的 `family_id`
|
||||
|
||||
Reference in New Issue
Block a user