# hr_system **Repository Path**: Eternitying/hr_system ## Basic Information - **Project Name**: hr_system - **Description**: 小微企业部门人事管理Web系统 - 基于Django+Vue.js - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-06 - **Last Updated**: 2026-06-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 小微企业部门人事管理Web系统 基于 Django + Vue.js + Element UI 的企业人事管理系统,涵盖员工档案、考勤、请假审批、薪资核算、奖惩管理、培训管理等核心人事功能。 ## 技术栈 | 层级 | 技术 | |------|------| | 后端框架 | Django 4.2 + Django REST Framework | | 前端框架 | Vue.js 2.x + Element UI + Axios | | 数据库(开发) | SQLite | | 数据库(生产) | MySQL 5.7 | | 跨域 | django-cors-headers | | Excel 导出 | openpyxl | ## 功能模块 | 模块 | 功能描述 | |------|----------| | 🔐 用户认证 | 登录/登出、修改密码、角色权限控制 | | 👥 用户管理 | 系统用户 CRUD(管理员专属) | | 🏗️ 部门管理 | 树形部门结构、子部门、负责人设置 | | 📋 员工档案 | 员工信息管理、部门/状态筛选、Excel 导出 | | 📅 考勤管理 | 上下班打卡、考勤记录查看、状态标记(正常/迟到/早退/旷工) | | 📝 请假管理 | 请假申请、审批流程(通过/驳回)、多类型请假(事假/病假/年假/婚假/产假) | | 💰 薪资管理 | 薪资核算(基本工资+绩效+奖金+补贴−各项扣除=实发) | | 🏆 奖惩管理 | 奖励/惩罚记录管理 | | 📚 培训管理 | 培训创建、人员分配、培训反馈 | | 📜 操作日志 | 系统操作记录追踪(管理员专属) | ## 角色权限 | 角色 | 说明 | 权限范围 | |------|------|----------| | `admin` | 系统管理员 | 全部功能,包括用户管理、操作日志 | | `hr` | HR 专员 | 员工档案、考勤、请假审批、薪资、奖惩、培训 | | `manager` | 部门负责人 | 分管部门的员工管理、请假审批 | | `employee` | 普通员工 | 打卡、请假申请、查看个人薪资、培训(员工自助平台) | 不同角色登录后看到不同的菜单:管理员可看到所有模块;HR/经理可看到除用户管理和操作日志外的管理功能;员工只能看到员工自助平台(打卡、请假、薪资查询、个人信息)。 ## 项目结构 ``` bysj_xm/ ├── manage.py # Django 入口 ├── requirements.txt # Python 依赖 ├── hr_system/ # Django 项目配置 │ ├── settings.py # 设置(数据库、DRF、CORS等) │ ├── urls.py # 主路由 │ └── wsgi.py ├── apps/ # 业务应用 │ ├── users/ # 用户认证 & 管理 │ │ ├── models.py # User(自定义用户) + OperationLog │ │ ├── views.py # 登录/用户CRUD/仪表盘/日志 │ │ └── management/commands/initdata.py # 初始化测试数据 │ ├── department/ # 部门管理(树形结构) │ ├── employee/ # 员工档案 │ ├── attendance/ # 考勤打卡 │ ├── leave/ # 请假 + 离职申请 │ ├── salary/ # 薪资核算 + 奖惩 │ └── training/ # 培训管理 ├── templates/ # 前端页面 │ ├── login.html # 登录页 │ ├── index.html # 管理后台 SPA │ └── employee.html # 员工自助平台 SPA ├── static/ # 前端静态资源 (Vue.js, Element UI, Axios) └── media/ # 上传文件 ``` ## 快速开始 ### 环境要求 - Python 3.8+ - MySQL 5.7(可选,生产环境用) ### 1. 进入项目目录 ```bash cd bysj_xm ``` ### 2. 创建并激活虚拟环境 ```bash python -m venv venv # Windows source venv/Scripts/activate # macOS / Linux source venv/bin/activate ``` ### 3. 安装依赖 ```bash pip install -r requirements.txt ``` ### 4. 数据库迁移 ```bash python manage.py migrate ``` ### 5. 初始化测试数据(可选) ```bash python manage.py initdata ``` 执行后会自动创建以下预设账号: | 用户名 | 密码 | 角色 | 说明 | |--------|------|------|------| | `admin` | `admin123` | 系统管理员 | 全部权限 | | `hrzhang` | `123456` | HR 专员 | 人事管理权限 | | `mgrwang` | `123456` | 部门负责人 | Tech Dept | | `mgrli` | `123456` | 部门负责人 | Marketing Dept | | `zhangsan` ~ `zhouba` | `123456` | 普通员工 | 员工自助平台 | ### 6. 启动开发服务器 ```bash python manage.py runserver ``` 浏览器访问 **http://127.0.0.1:8000/login/** 即可登录。 ## 数据库切换(SQLite → MySQL) 如需使用 MySQL,编辑 `hr_system/settings.py`: 1. 注释掉 SQLite 配置 2. 取消注释 MySQL 配置 3. 修改密码为实际 MySQL 密码: ```python DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'hr_system', 'USER': 'root', 'PASSWORD': '你的密码', 'HOST': 'localhost', 'PORT': '3306', 'OPTIONS': { 'charset': 'utf8mb4', 'init_command': "SET sql_mode='STRICT_TRANS_TABLES'", }, } } ``` 然后重新执行 `migrate` 和 `initdata`。 ## API 接口一览 ### 认证 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | POST | `/api/auth/login/` | 用户登录 | 公开 | | POST | `/api/auth/logout/` | 用户登出 | 登录用户 | | GET | `/api/auth/me/` | 当前用户信息 | 登录用户 | | PUT | `/api/auth/change-password/` | 修改密码 | 登录用户 | ### 用户管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/users/` | 用户列表/创建 | admin/hr | | GET/PUT/DELETE | `/api/users//` | 用户详情/编辑/删除 | admin | ### 仪表盘 & 日志 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET | `/api/dashboard/` | 仪表盘统计数据 | 登录用户 | | GET | `/api/logs/` | 操作日志列表 | admin | ### 部门管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/departments/` | 部门列表/创建 | 登录用户 | | GET/PUT/DELETE | `/api/departments//` | 部门详情/编辑/删除 | admin/hr | ### 员工管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/employees/` | 员工列表/创建 | manager以上 | | GET/PUT/DELETE | `/api/employees//` | 员工详情/编辑/删除 | manager以上 | | GET | `/api/employees/export/` | 导出 Excel | manager以上 | ### 考勤管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/attendance/` | 考勤列表/录入 | manager以上 | | GET | `/api/attendance/my-records/` | 我的考勤记录 | employee | | POST | `/api/attendance/clock-in/` | 上班打卡 | employee | | POST | `/api/attendance/clock-out/` | 下班打卡 | employee | ### 请假管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/leaves/` | 请假列表/申请 | 登录用户 | | GET | `/api/leaves/my-leaves/` | 我的请假 | employee | | PUT | `/api/leaves//approve/` | 审批请假 | manager以上 | ### 薪资管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/salaries/` | 薪资列表/核算 | manager以上 | | GET | `/api/salaries/my-salary/` | 我的薪资 | employee | ### 奖惩管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/rewards-punishments/rewards/` | 奖惩列表/添加 | manager以上 | | GET/PUT/DELETE | `/api/rewards-punishments/rewards//` | 详情/编辑/删除 | manager以上 | ### 培训管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/trainings/` | 培训列表/创建 | 登录用户 | | GET/PUT/DELETE | `/api/trainings//` | 详情/编辑/删除 | 登录用户 | | POST | `/api/trainings//feedback/` | 提交培训反馈 | 登录用户 | ### 离职管理 | 方法 | 路径 | 说明 | 权限 | |------|------|------|------| | GET/POST | `/api/resignations/` | 离职申请列表/提交 | 登录用户 | ## 前端页面 | 路径 | 页面 | 说明 | |------|------|------| | `/login/` | 登录页 | 所有用户登录入口,登录后按角色自动跳转 | | `/` | 管理后台 | 管理员/HR/经理使用,含侧边栏、仪表盘、全部管理功能 | | `/employee/` | 员工自助平台 | 普通员工使用,含打卡、请假、薪资查询、个人信息 |