员工管理
这篇解决什么
员工档案存在哪、和系统用户怎么绑，入职 / 转正 / 调动 / 离职四张单如何回写档案。读完能对上 hrm_employee、userId，以及四条 hr_employee_*_bill 流程 key。
默认端口 48080，管理端前缀 /admin-api。PC 开发页 http://127.0.0.1:5800。组织树见 组织架构。
示意图：档案是主数据。入职等单据审批通过后回写档案，不另存一套人员。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 档案接口 | @RequestMapping("/hrm/employee-archive") | ruoyi-office/yudao-module-hrm/.../controller/admin/employee/EmployeeController.java |
| 档案表 | hrm_employee | .../dal/dataobject/employee/EmployeeDO.java |
| 学历等子表 | hrm_employee_education、证书、入职材料 | .../dal/dataobject/employee/ |
| 入职单 | hrm_employee_entry_bill，key hr_employee_entry_bill | EmployeeEntryBillController |
| 转正 / 调动 / 离职 | 对应 regular / transfer / resignation | 同包 Controller |
| 合同快照 | currentContractId 指向合同台账 | EmployeeDO |
| PC 列表 | 路由 /hrm/employee/employee-archive-list | ruoyi-office-vben/apps/web-antd/src/views/hrm/employee/list/index.vue |
| 详情 | /hrm/employee/employee-archive-info | .../employee/info/index.vue |
官方菜单：5151 人事档案，5152 员工档案。按钮 hrm:employee-archive:query / create / update / delete / export。人事管理 5160 下挂入职、转正、调动、离职列表。
本系统截图：人力 → 人事档案 → 员工档案。编号、部门、人员状态在这一张主表。
本系统截图：员工档案详情。学历、合同快照等子表在这里，不要只看列表。
档案主表
EmployeeDO 是人事主数据，不是 system_users 的别名。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
employeeNo | 工号 | hrm_employee |
deptId / companyId | 挂系统部门 | 同上 |
employeeStatus | 1 正式 2 试用 3 实习 4 兼职 5 临时 | 同上 |
userId | 绑定后台用户 | 同上 |
userGenerated | 是否已由档案生成过账号 | 同上 |
| 合同快照 | 生效合同编号和起止日 | currentContract* |
CREATE TABLE hrm_employee (
id bigint NOT NULL AUTO_INCREMENT,
employee_no varchar(64) DEFAULT NULL,
name varchar(64) DEFAULT NULL,
dept_id bigint DEFAULT NULL,
user_id bigint DEFAULT NULL,
employee_status tinyint DEFAULT NULL,
PRIMARY KEY (id)
);列很多，上表只标联算和登录用得到的。完整字段看 DO。
档案和账号不是自动一人一行
userId 空着也能存档案。生成用户后才有登录名。考勤、薪资按档案算，待办按用户算，两边没绑上会「有人没待办」。
四张人事单
状态变更不要手改档案状态充数，走单据 + 流程。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
入职 201 | 通过后写档案 | hr_employee_entry_bill |
转正 202 | 改试用 → 正式，写 formalDate | hr_employee_regular_bill |
调动 203 | 改部门 / 岗位 | hr_employee_transfer_bill |
离职 204 | 停用档案，处理账号 | hr_employee_resignation_bill |
提交走 FlowBillService，回写在审批通过回调。流程模型自定义路径见 人力功能设计。
配置与操作
先在员工档案建人（部门、工号、人员状态），再决定是否生成 userId。打卡、待办都要账号，档案可以先空着。
状态变更走 人事管理 下入职 / 转正 / 调动 / 离职的 list / info，不要在档案页手改 employeeStatus 充数。详情页 employee-archive-info 看学历、合同快照等子表。
示意图：四张单都写回同一行档案，不要平行维护两套状态。
