初始配置
激活 HRM 模块后，建议在开始管理员工和运行薪资之前完成一些配置步骤。所有设置都可以从侧边栏的 设置 > HRM 配置 访问。
常规设置
导航到 设置 > HRM 配置 > 常规 来配置基础选项。
财年开始月份
定义您的组织财年何时开始。这会影响假期结转处理和薪资周期计算。
- 默认值 ：一月
- 选项：任何月份（一月–十二月）
示例：如果您的财年从四月到三月，请将其设置为四月。假期结转将在每年4月1日处理。
员工编号格式
控制创建新员工时如何自动生成员工编号。
| 格式 | 示例 | 描述 |
|---|---|---|
year_increment | 2026-001, 2026-002 | 以当前年份为前缀，每年重置 |
increment | 001, 002, 003 | 简单的顺序编号 |
考勤设置
导航到 设置 > HRM 配置 > 考勤。
工作时间
| 设置 | 默认值 | 描述 |
|---|---|---|
| 每日标准工时 | 8 | 用于加班计算和薪资按比例分配 |
| 上班时间 | 09:00 | 预期签到时间 |
| 下班时间 | 17:00 | 预期签退时间 |
每周休息日
选择哪些天是非工作日。
- 默认值：周六、周日
- 用于薪资计算（工作日计数）和自动周末考勤标记
请假管理设置
导航到 设置 > HRM 配置 > 请假管理。
审批流程
| 模式 | 行为 |
|---|---|
| 单级审批（默认） | 一位审批者审查并批准/拒绝请求 |
| 多级审批 | 请求经过多个审批阶段 |
| 自动审批 | 请求在提交时自动获得批准 |
自动审批假期类型
选择应完全绕过审批流程的特定假期类型。适用于居家办公或调休等不需要审批的类型。
假期结转
| 设置 | 默认值 | 描述 |
|---|---|---|
| 启用结转 | 是 | 未使用的假期天数是否结转到下一个财年 |
| 最大结转天数 | 10 | 可以结转的最大天数 |
| 结转到期（月） | 3 | 结转天数在新财年开始后的这些月数后到期 |
假期结转通过计划命令在财年开始月份的第一天自动处理。
薪资设置
导航到 设置 > HRM 配置 > 薪资。
薪资计算基础
确定如何计算部分月份或按比例分配期间的薪资。
| 模式 | 描述 |
|---|---|
| 工作日（默认） | 根据期间内的实际工作日按比例计算薪资 |
| 工作时间 | 根据记录的工时计算薪资 |
| 固定月薪 | 无论工作日多少，支付完整月薪 |
加班
| 设置 | 默认值 | 描述 |
|---|---|---|
| 启用加班 | 是 | 加班时间是否计入薪资 |
| 加班倍率 | 1.5x | 应用于加班时间小时费率的倍率 |
通知接收人
选择在薪资运行 完成时应接收电子邮件通知的用户。通常设置为人力资源经理或财务团队成员。
部门和项目
部门
导航到 设置 > HRM 配置 > 部门，在添加员工之前创建您的组织部门。每个员工都分配到一个部门。
示例：人力资源、工程、销售、市场、财务。
项目
导航到 设置 > HRM 配置 > 项目，定义员工可以在其工时表中记录时间的项目。
设置假期类型
在员工可以提交请假申请之前，您需要配置假期类型。从侧边栏导航到 请假管理 > 假期类型。
对于每种假期类型，配置：
| 字段 | 描述 |
|---|---|
| 名称 | 如：年假、病假、产假 |
| 每年天数 | 此假期类型的年度配额 |
| 是否带薪 | 此假期类型是否带薪 |
| 需要审批 | 请求是否需要经理审批 |
| 可结转 | 未使用的天数是否结转到下一年 |
| 最大结转天数 | 可以结转的天数上限 |
| 是否启用 | 启用或禁用该假期类型 |
您可以使用 php artisan hrm:seed-leave-data 命令创建一组标准假期类型（年假、病假、事假、产假、陪产假、丧假、无薪假、居家办公），并设置合理的默认值。
设置薪资组件
在运行薪资之前，在 薪资 > 薪资组件 下定义您的薪资组件。
组件分为三类：
| 类型 | 示例 |
|---|---|
| 津贴（收入） | 基本工资、住房津贴、交通津贴、奖金 |
| 扣除 | 公积金、保险费、贷款还款 |
| 税费 | 所得税、社会保障税 |
每个组件支持两种计算方法：
- 固定：固定金额（如 500 美元交通津贴）
- 百分比：基本工资或总工资的百分比（如 12% 公积金）
运行 php artisan hrm:seed-payroll-data 生成一组标准薪资组件（4个津贴、3个扣除、2个税费），具有典型配置。
员工门户配置
员工门户通过 HRM 模块目录中的 config/employee-portal.php 文件进行配置。这些设置控制员工登录时可以看到什么和可以做什么。
主要选项
| 设置 | 默认值 | 描述 |
|---|---|---|
enabled | true | 启用或禁用员工门户 |
employee_role_name | Employee | 分配给员工用户的角色名称 |
auto_create_user | true | 创建员工时自动创建 CRM 用户账户 |
landing_page | /timesheets | 员工登录后看到的页面 |
可见菜单项
默认情况下，员工可以访问：
- 工时表
- 请假申请
- 考勤
- 假期余额
- 工资条
要授予员工访问其他模块页面的权限，请在配置文件的 allowed_menu_items 数组中添加路由路径。
数据范围
门户自动过滤数据，使员工只能看到自己的记录。这适用于请假申请、假期余额、考勤、工时表、薪资结构、薪资条目和工资条。
不受范围限制的模型（对所有员工可见）：
- Employee — 以便在创建记录时 BelongsTo 下拉菜单正常工作
- Leave Type — 以便员工可以看到可用的假期类型
推荐设置顺序
- 激活模块 — 在设置 > HRM 配置 > 激活中输入您的许可证代码
- 配置常规设置 — 设置财年和员工编号格式
- 创建部门 — 添加您的组 织结构
- 创建项目 — 定义用于工时表跟踪的项目（如适用）
- 设置假期类型 — 配置假期类别和配额
- 配置考勤设置 — 设置工作时间和休息日
- 设置薪资组件 — 定义收入、扣除和税费
- 配置薪资设置 — 设置计算基础和加班规则
- 添加员工 — 开始创建员工记录（用户账户自动创建）
- 分配薪资结构 — 将薪资组件关联到每个员工
- 创建假期余额 — 分配当年的假期配额