人力功能设计
配套学习:查看课程与图文操作手册。
这篇解决什么
人力资源怎么分层:组织与档案是主数据,考勤 / 招聘 / 薪资 / 绩效是业务闭环,审批一律交给 BPM。读完先对模块边界和表,再进组织、员工、考勤等功能篇。
默认端口 48080,前缀 /admin-api。工程启动见 快速开始。审批接入见 业务表单开发。
业务流程及架构
人事自己不算流程引擎。档案、打卡、试算在 yudao-module-hrm;入职、补卡、薪资确认等单据实现 FlowBillService,通过后回调回写。
示意图:左客户端。中间人事模块读系统部门与用户,单据提交走 Flowable。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 主数据 | 组织复用 system_dept;人在 hrm_employee | 组织架构、员工管理 |
| 考勤 | 部门规则继承、打卡、假种、补卡销假 | 考勤管理 |
| 招聘 | 需求 / 候选人 / 录用,录用后再入职 | 招聘管理 |
| 薪酬 | 方案档案 → 批次试算 → 确认 / 发薪 / 工资条 | 计薪设置、月度工资 |
| 社保 | 规则挂方案+城市,不是独立增减员引擎 | 社保管理 |
| 绩效 | 模板批次生成计划,评价 / 申诉 / 结果确认 | 绩效模板、绩效考核 |
| 移动 | 打卡、工资条、人事单 | 移动端 HRM |
不要用目录名当流程 key
入职是 hr_employee_entry_bill,不是 hrm_entry。全部 key 以 HrmBillTypeEnum 为准。
数据表 ER
主干表按本仓库 DO 画出。人事单据还有入职 / 转正 / 调动 / 离职等 hrm_employee_*_bill,招聘有职位 / 面试过程表,绩效有模板指标 / 证据,图上只留主链。
示意图:按本仓库生成的 ER。考勤配置按部门继承,不另建组织表。
前后端代码
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 模块 | api 枚举 + server 实现 | ruoyi-office/yudao-module-hrm/ |
| 单体引入 | yudao-module-hrm-server | ruoyi-office/yudao-server/pom.xml |
| 单据枚举 | 类型码 + processDefinitionKey | yudao-module-hrm-api/.../HrmBillTypeEnum.java |
| 审批回写 | 流程结束回调 | .../process/feign/HrmFeignNotificationController.java |
| 管理端 | 人力目录 | ruoyi-office-vben/apps/web-antd/src/views/hrm/ |
| 移动端 | 业务在 pages-hrm | ruoyi-office-uniapp/src/pages-hrm/ |
官方菜单:5146 人力(/hrm)。人事档案 5151,人事管理 5160,招聘 5560,薪酬 6007,绩效 6172。看不到菜单先查角色。

本系统截图:人力目录能进员工档案,说明模块和菜单已经在跑。

本系统截图:人事主数据入口。其它闭环都挂在档案 userId / deptId 上。
PC 单据页约定 list / info(档案详情是 employee-archive-info)。模型 formCustomViewPath 必须对这两处。
功能开启
单体 -P boot 时已经依赖人事实现,没有单独的「HRM 开关」页。启动 YudaoServerApplication 即可。
客户默认包 ruoyi-office-db/dump/latest/:先 schema_*.sql 再 static_data_*.sql,带 hrm_* 表、菜单、字典和已发布人事模型。以后改表走 ruoyi-office-db/update/。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
201 入职 | hr_employee_entry_bill | /hrm/employee-relation/entry-info |
202 转正 | hr_employee_regular_bill | regular-info |
203 调动 | hr_employee_transfer_bill | transfer-info |
204 离职 | hr_employee_resignation_bill | resignation-info |
205 销假 | hr_leave_cancel_bill | 考勤 |
206 补卡 | hr_card_replacement_bill | /hrm/attendance/card-replacement-info |
207 需求 | hr_recruitment_requirement_bill | 招聘 |
208 录用 | hr_recruitment_offer_bill | 招聘 |
209 薪资确认 | hr_salary_payroll_confirm_bill | 薪酬 |
210 发薪 | hr_salary_payment_bill | 薪酬 |
211 绩效结果确认 | hr_performance_result_confirm_bill | 绩效 |
212 绩效申诉 | hr_performance_assessment_appeal | 绩效 |
213 绩效评价 | hr_performance_assessment_bill | 绩效 |
214–216 | 外出培训 / 奖惩 / 培训计划 | 同枚举 |
先对模型再改页面
流程设置里能搜到已发布的 hr_employee_entry_bill 等。自定义路径对 list / info,不要指向已删的 apply/detail。
HRM_EMPLOYEE_ENTRY_BILL("201", "员工入职申请单", "hr_employee_entry_bill"),
HRM_CARD_REPLACEMENT_BILL("206", "考勤补卡申请单", "hr_card_replacement_bill"),摘自 HrmBillTypeEnum。第三段才是 Flowable 的 KEY_。
示意图:先库和菜单,再对 key,最后配业务。
旧文 HRM 功能开启 已并入本页,请收藏本篇。
