Etusivu Tutki Apua
Kirjaudu sisään
longb
/
payroll
1
0
Fork 0
Tiedostot Ongelmat 0 Pull-pyynnöt 0 Wiki
Haara: master
Haarat Tagit
payroll
/
系统使用说明书.md

系统使用说明书.md 15 KB
Pysyvä linkki Historia Raaka

工资发放管理系统使用说明书

一、系统启动

1.1 启动后端服务

打开PowerShell,执行以下命令:

cd "d:\payroll system\backend"
mvn spring-boot:run

等待启动成功,看到以下提示:

工资发放系统启动成功!
接口文档地址: http://localhost:8080/api/doc.html
Tomcat started on port(s): 8080

1.2 启动前端服务

打开新的PowerShell窗口,执行:

cd "d:\payroll system\frontend\payroll-web"
npm run dev

看到提示后,在浏览器访问: http://localhost:5173

二、系统登录

2.1 默认账号

  • 用户名: admin
  • 密码: 123456

2.2 登录步骤

  1. 打开浏览器访问 http://localhost:5173
  2. 输入用户名和密码
  3. 点击"登录"按钮
  4. 登录成功后自动跳转到Dashboard首页

三、功能模块使用指南

3.1 组织架构管理

3.1.1 组织管理

功能位置: 左侧菜单 → 组织管理 → 组织架构

主要操作:

  1. 查看组织树

    • 进入页面即可查看完整的组织树形结构
    • 点击节点展开/收起下级组织

  2. 新增组织

    • 点击右上角"新增组织"按钮
    • 填写必填项:
      • 组织代码(如: ORG001)
      • 组织名称(如: 总公司)
      • 组织类型(总公司/分公司/子公司)
      • 组织层级(1-5级)
      • 选择上级组织(可选)
    • 点击"确定"保存

  3. 编辑组织

    • 点击组织节点的"编辑"按钮
    • 修改信息后点击"确定"

  4. 删除组织

    • 点击组织节点的"删除"按钮
    • 确认删除(注意:有下级组织或员工时无法删除)

3.1.2 部门管理

功能位置: 左侧菜单 → 组织管理 → 部门管理

主要操作:

  1. 查看部门

    • 页面以树形表格显示所有部门
    • 顶部可按组织筛选部门
    • 支持展开/收起子部门

  2. 新增部门

    • 点击右上角“新增顶级部门”或部门行的“新增子部门”按钮
    • 填写信息:
      • 所属组织(必填)
      • 上级部门(选填,为空则为顶级部门)
      • 部门代码(必填,如: DEPT001)
      • 部门名称(必填,如: 人力资源部)
      • 部门负责人ID(选填)
      • 成本中心(选填)
      • 层级(1-10)
      • 排序(0开始)
      • 状态(启用/禁用)
    • 点击“确定”保存

  3. 编辑部门

    • 点击部门行的“编辑”按钮
    • 修改信息后点击“确定”

  4. 删除部门

    • 点击部门行的“删除”按钮
    • 确认删除(注意:有子部门或员工时无法删除)

  5. 注意事项

    • parent_id为0或null的部门为顶级部门
    • 同一组织下可以有多个顶级部门
    • 部门代码建议使用统一命名规则

3.1.3 员工管理

功能位置: 左侧菜单 → 组织管理 → 员工管理

主要操作:

  1. 查询员工

    • 可按员工姓名、工号、部门筛选
    • 点击"查询"按钮

  2. 新增员工

    • 点击"新增员工"按钮
    • 填写基本信息:
      • 工号(必填,唯一)
      • 姓名(必填)
      • 性别
      • 身份证号
      • 手机号
      • 邮箱
    • 填写组织信息:
      • 所属组织(必填)
      • 所属部门(必填)
      • 职位
      • 入职日期
    • 点击"确定"

  3. 编辑员工

    • 点击员工行的"编辑"按钮
    • 修改信息后保存

  4. 删除员工

    • 点击"删除"按钮
    • 确认删除

3.2 薪资配置管理

3.2.1 薪资项目

功能位置: 左侧菜单 → 薪资管理 → 薪资项目

主要操作:

  1. 查看薪资项目

    • 页面显示所有薪资项目列表
    • 可按项目名称、类型筛选

  2. 新增薪资项目

    • 点击"新增薪资项目"
    • 填写信息:
      • 项目编码(如: ITEM001)
      • 项目名称(如: 基本工资)
      • 项目类型(基本薪资/绩效奖金/津贴补助/加班工资/其他)
      • 计算方式(固定金额/按比例/按公式/手工录入)
      • 是否参与个税计算
      • 是否参与社保基数
    • 点击"确定"

  3. 常用薪资项目示例:

    • 基本工资(固定金额)
    • 绩效工资(按比例)
    • 全勤奖(固定金额)
    • 加班工资(按公式)
    • 交通补贴(固定金额)

3.2.2 薪资方案

功能位置: 左侧菜单 → 薪资管理 → 薪资方案

主要操作:

  1. 新增薪资方案

    • 点击"新增方案"
    • 填写基本信息:
      • 方案编码(如: SCHEME001)
      • 方案名称(如: 标准工资方案)
      • 适用范围说明
    • 选择薪资项目:
      • 从左侧列表选择需要的薪资项目
      • 添加到方案中
      • 设置每个项目的默认值或计算公式
    • 保存方案

  2. 编辑方案

    • 点击"编辑"按钮
    • 修改项目配置
    • 保存更新

  3. 方案配置建议:

    • 应发项目:基本工资、岗位工资、绩效工资、津贴补助、加班工资
    • 扣款项目:社保、公积金、个税、其他扣款

3.2.3 社保公积金

功能位置: 左侧菜单 → 薪资管理 → 社保公积金

主要操作:

  1. 新增员工社保配置

    • 点击"新增配置"
    • 填写基本信息:
      • 员工ID
      • 生效月份(选择年月)
    • 设置社保基数和比例:
      • 社保缴费基数(如: 5000)
      • 养老保险:公司16%,个人8%(默认)
      • 医疗保险:公司10%,个人2%(默认)
      • 失业保险:公司0.5%,个人0.5%(默认)
      • 工伤保险:公司0.5%(默认)
      • 生育保险:公司0.8%(默认)
    • 设置公积金:
      • 公积金缴费基数(如: 5000)
      • 公司比例:12%(默认)
      • 个人比例:12%(默认)
    • 点击"确定"
    • 系统自动计算各项金额和合计

  2. 查看配置

    • 可按员工ID、月份查询
    • 查看公司承担和个人承担金额

  3. 注意事项:

    • 同一员工同一月份只能有一条配置
    • 缴费基数和比例可根据当地政策调整

3.3 考勤管理

3.3.1 考勤记录

功能位置: 左侧菜单 → 考勤管理 → 考勤记录

主要操作:

  1. 新增考勤记录

    • 点击"新增记录"
    • 填写信息:
      • 员工ID(必填)
      • 考勤日期(必填)
      • 签到时间
      • 签退时间
      • 工作时长(小时)
      • 加班时长(小时)
      • 考勤状态(正常/迟到/早退/旷工/请假)
      • 备注
    • 点击"确定"

  2. 批量导入考勤

    • 准备Excel考勤数据
    • 点击"导入"按钮
    • 选择文件上传

  3. 查询考勤

    • 按员工ID、日期范围、状态筛选
    • 点击"查询"

3.3.2 考勤统计

功能位置: 左侧菜单 → 考勤管理 → 考勤统计

主要操作:

  1. 生成月度汇总

    • 输入员工ID
    • 选择统计月份
    • 点击"生成汇总"
    • 系统自动统计:
      • 应出勤天数
      • 实际出勤天数
      • 迟到次数
      • 早退次数
      • 旷工天数
      • 请假天数
      • 加班时长

  2. 查看汇总

    • 按员工ID、月份查询
    • 查看详细统计数据

  3. 确认汇总

    • 核对数据无误后点击"确认"
    • 确认后数据将用于工资计算

3.4 工资计算与发放

3.4.1 工资计算

功能位置: 左侧菜单 → 工资管理 → 工资计算

主要操作:

  1. 计算单个员工工资

    • 输入员工ID
    • 选择发放月份
    • 选择薪资方案
    • 点击"计算工资"
    • 系统自动:
      • 读取员工薪资方案
      • 读取考勤数据
      • 读取社保公积金配置
      • 计算应发、扣款、实发金额

  2. 批量计算工资

    • 选择发放月份
    • 选择部门或组织
    • 点击"批量计算"
    • 系统为该范围内所有员工计算工资

  3. 工资计算说明:

    • 应发工资 = 基本工资 + 岗位工资 + 绩效工资 + 津贴 + 加班工资
    • 扣款项目 = 社保个人部分 + 公积金个人部分 + 个税 + 其他扣款
    • 实发工资 = 应发工资 - 扣款合计

3.4.2 工资单查询

功能位置: 左侧菜单 → 工资管理 → 工资单查询

主要操作:

  1. 查询工资单

    • 按员工ID、月份、状态筛选
    • 点击"查询"

  2. 查看详情

    • 点击"查看详情"按钮
    • 查看完整工资单信息:
      • 基本信息
      • 应发项目明细
      • 扣款项目明细
      • 实发工资

  3. 工资单状态流转:

    • 草稿: 刚计算完成,可修改
    • 已确认: 点击"确认"后进入此状态,不可修改
    • 已发放: 点击"发放"后进入此状态

  4. 确认工资单

    • 核对草稿状态的工资单
    • 点击"确认"按钮
    • 确认后不可修改

  5. 发放工资

    • 对已确认的工资单
    • 点击"发放"按钮
    • 标记为已发放状态

  6. 删除工资单

    • 仅草稿状态可删除
    • 点击"删除"按钮

3.5 系统管理

3.5.1 用户管理

功能位置: 左侧菜单 → 系统管理 → 用户管理

主要操作:

  1. 新增用户

    • 点击"新增用户"
    • 填写信息:
      • 用户名(必填,唯一)
      • 姓名(必填)
      • 手机号
      • 邮箱
      • 员工ID(关联到具体员工)
      • 状态(启用/禁用)
    • 点击"确定"
    • 默认密码: 123456

  2. 编辑用户

    • 点击"编辑"按钮
    • 修改用户信息

  3. 重置密码

    • 点击"重置密码"按钮
    • 密码将重置为123456

  4. 删除用户

    • 点击"删除"按钮

3.5.2 角色管理

功能位置: 左侧菜单 → 系统管理 → 角色管理

主要操作:

  1. 新增角色

    • 点击"新增角色"
    • 填写信息:
      • 角色编码(如: ADMIN)
      • 角色名称(如: 系统管理员)
      • 描述
      • 状态
    • 点击"确定"

  2. 编辑/删除角色

    • 点击相应按钮操作

四、业务流程示例

4.1 新员工入职完整流程

  1. 添加组织和部门(如果是新部门)

    • 组织管理 → 新增组织
    • 部门管理 → 新增部门

  2. 添加员工信息

    • 员工管理 → 新增员工
    • 填写基本信息和组织信息

  3. 配置薪资方案

    • 薪资方案 → 为员工分配薪资方案

  4. 配置社保公积金

    • 社保公积金 → 新增配置
    • 设置缴费基数和比例

  5. 创建系统用户(如需登录系统)

    • 用户管理 → 新增用户
    • 关联到员工ID

4.2 月度工资发放流程

  1. 录入考勤(每日)

    • 考勤记录 → 新增记录
    • 或批量导入考勤数据

  2. 生成考勤汇总(月末)

    • 考勤统计 → 生成月度汇总
    • 核对并确认汇总数据

  3. 计算工资(月末)

    • 工资计算 → 选择月份
    • 批量计算或单个计算
    • 系统自动生成工资单

  4. 审核工资单

    • 工资单查询 → 查看详情
    • 核对应发、扣款、实发
    • 确认无误

  5. 确认工资单

    • 点击"确认"按钮
    • 工资单进入已确认状态

  6. 发放工资

    • 财务人员发放工资后
    • 点击"发放"按钮
    • 标记为已发放

五、常见问题FAQ

5.1 登录相关

Q: 忘记密码怎么办? A: 联系管理员通过"用户管理"模块重置密码为123456

Q: 登录后白屏? A: 检查后端服务是否正常启动(端口8080)

5.2 工资计算相关

Q: 工资计算不准确? A: 检查以下配置:

  • 薪资方案是否正确
  • 考勤汇总是否已确认
  • 社保公积金配置是否正确

Q: 无法确认工资单? A: 工资单必须是"草稿"状态才能确认

Q: 已确认的工资单能修改吗? A: 不能。如需修改请删除后重新计算

5.3 数据相关

Q: 删除员工后能恢复吗? A: 系统采用逻辑删除,数据库中仍保留,需要技术人员恢复

Q: 能导出工资单吗? A: 当前版本暂不支持导出功能

六、注意事项

6.1 数据安全

  1. 定期备份数据库
    • 建议每天备份MySQL数据库
    • 备份命令: bash mysqldump -uroot -p123456 payroll_system > backup_20250125.sql 2. 权限管理 - 不同角色分配不同权限 - 定期审查用户账号 - 及时禁用离职员工账号 ### 6.2 操作规范 1. 工资发放周期 - 建议固定每月25-30日进行工资计算 - 考勤汇总必须在工资计算前完成 2. 数据修改 - 确认前可随时修改 - 确认后不可修改 - 需要修改时删除重新计算 3. 社保公积金 - 每年检查缴费基数上下限 - 政策调整时及时更新比例 --- ## 七、技术支持 ### 7.1 系统环境 - 后端: Java 1.8 + Spring Boot 2.7.18 - 前端: Vue 3 + Element Plus - 数据库: MySQL 8.0 - 端口: 后端8080,前端5173 ### 7.2 接口文档 访问: http://localhost:8080/api/doc.html 查看完整API接口文档 ### 7.3 日志查看 后端日志在控制台实时输出,如遇问题可查看日志排查 --- ## 八、系统优化建议 ### 8.1 初次使用准备 1. 基础数据准备 - 先创建组织结构 - 再创建部门 - 然后添加员工 - 最后配置薪资和社保 2. 测试建议 - 先用1-2个测试员工测试完整流程 - 确认无误后再批量录入真实数据 ### 8.2 日常使用建议 1. 考勤管理 - 建议每天录入考勤 - 月末集中审核汇总 2. 工资计算 - 建议先计算几个员工测试 - 确认计算规则正确后批量计算 3. 数据查询 - 使用筛选条件提高查询效率 - 定期查看Dashboard了解系统数据 --- --- ## 九、系统更新记录 ### v1.0.1 (2025-12-26) 功能优化: 1. 修复部门管理对话框中所有表单字段宽度问题,优化为100%宽度 2. 修复部门树形结构构建逻辑,正确处理parent_id=0的顶级部门 3. 优化部门筛选交互,支持按组织筛选部门 Bug修复: 1. 解决部门树中部分部门不显示的问题 2. 修复对话框表单字段显示不全的问题 ### v1.0.0 (2025-12-25) 初始版本发布: 1. 完成组织架构模块(组织、部门、员工) 2. 完成薄资配置模块(薄资项目、薄资方案、社保公积金) 3. 完成考勤管理模块(考勤记录、考勤统计) 4. 完成工资管理模块(工资计算、工资单查询) 5. 完成系统管理模块(用户管理、角色管理) 6. 完成Dashboard首页统计功能 --- 系统版本: v1.0.1
      文档更新日期: 2025-12-26
      适用范围: 工资发放管理系统全体用户