# 🌿 H.R 人事管理系统 - 功能详细介绍与使用说明
# 版本：Max (2026)

---

## 一、系统概述

H.R 人事管理系统是一套面向中小企业的人力资源管理解决方案，采用 **Flask + Vue.js** 技术栈，提供员工档案管理、排班调度、考勤追踪、薪资核算、面试流程管理等一体化功能。系统支持 **SQLite** 和 **MySQL** 双数据库模式，可根据企业规模灵活选择。

### 技术架构
| 层级 | 技术 |
|------|------|
| 前端 | Vue.js 3 + Chart.js + XLSX |
| 后端 | Flask + SQLAlchemy |
| 数据库 | SQLite（默认）/ MySQL |
| 部署方式 | 本地部署 |

---

## 二、系统安装与启动

### 2.1 环境要求
- Python 3.8+
- 现代浏览器（Chrome / Edge / Firefox）

### 2.2 安装步骤

**1. 安装 Python 依赖**
```bash
pip install flask flask-cors flask-sqlalchemy pymysql openpyxl
```

**2. 启动后端服务**
```bash
python HR系统17 - 副本.py
```
后端服务默认运行在 `http://localhost:5000`

**3. 打开前端页面**
直接用浏览器打开 `HR系统17 - 副本.html` 文件

### 2.3 默认登录账号
| 用户名 | 密码 | 角色 |
|--------|------|------|
| admin | admin123 | 管理员 |


## 三、功能模块详解

### 3.1 仪表盘 📊
系统入口页面，提供全局数据概览：

**核心指标卡片**
- 员工总数 / 正式工 / 临时工 / 黑名单 / 在职员工
- 月薪总额 / 五险一金(公司) / 全勤奖总额 / 工龄奖总额
- 总加班费 / 总人力支出
- 迟到 / 早退 / 旷工 / 正常出勤 统计
- 处罚总金额 / 补卡次数

**面试统计卡片**
- 总面试人数 / 待面试 / 面试中 / 已面试 / 通过 / 候选 / 淘汰

**合同状态统计卡片（新增）**
- 合同在期人数 / 续期人数 / 到期人数 / 过期人数 / 合同总数

**增强版人力成本统计（新增）**
- 上月总人力支出：实际统计上月全部人力成本
- 本月预估总人力支出：按已过天数比例预估
- 本年预估总人力支出：按已过天数比例预估
- 上年总人力支出：完整统计上年全年人力成本
- 当日总时薪/日薪支出：实时排班薪资统计
- 本周总周薪支出：本周排班员工周薪汇总

**可视化图表**
- 员工类型分布（饼图）
- 部门人数（柱状图）
- 面试状态分布（饼图）
- 年龄分布（折线图）


### 3.2 正式工管理 👔

**功能列表**
| 功能 | 说明 |
|------|------|
| 员工列表 | 展示所有正式工信息，支持搜索（姓名/工号/部门）和状态筛选 |
| 添加员工 | 填写员工基本信息、薪资、社保公积金、年假、合同起止日期等 |
| 编辑员工 | 修改员工信息（黑名单员工不可编辑） |
| 删除员工 | 删除员工记录（支持批量删除） |
| 拉黑员工 | 将员工加入黑名单，记录拉黑原因和状态 |
| 年假管理 | 设置年假额度、请假审批、年假记录查询 |
| 导入/导出 | Excel 批量导入导出员工数据 |
| 黑名单姓名检测（新增） | 添加/编辑时自动检测姓名是否在黑名单中，实时提示 |

**正式工特有字段**
- 全勤奖、年终奖、工龄奖
- 社保比例、公积金比例（自动计算公司缴纳金额）
- 年假总天数 / 已休天数 / 剩余天数
- 工龄（自动计算）
- 工号 / 手机号 / 邮箱 / 身份证 / 工资卡号（新增）
- 合同开始日期 / 合同结束日期（新增）

**薪资类型动态化（新增）**
- 选择 **时薪** → 输入框显示"时薪金额 (¥/小时)"
- 选择 **日薪** → 输入框显示"日薪金额 (¥/天)"
- 选择 **周薪** → 输入框显示"周薪金额 (¥/周)"
- 选择 **月薪** → 输入框显示"月薪金额 (¥/月)"
- 选择 **年薪** → 输入框显示"年薪金额 (¥/年)"


### 3.3 临时工管理 🔧

**与正式工管理的区别**
| 项目 | 正式工 | 临时工 |
|------|--------|--------|
| 全勤奖 | ✅ | ❌ |
| 年终奖 | ✅ | ❌ |
| 工龄奖 | ✅ | ❌ |
| 社保/公积金 | ✅ | ❌ |
| 年假管理 | ✅ | ❌ |
| 入职/离职日期 | ✅ | ✅ |
| 薪资类型 | 时薪/日薪/周薪/月薪/年薪 | 时薪/日薪/周薪/月薪/年薪 |
| 请假功能 | ✅ | ❌ |
| 合同管理 | ✅ | ✅ |
| 工号/手机/邮箱/身份证/工资卡号 | ✅ | ✅ |


### 3.4 排班管理 📅

**日历视图**
- 按月展示排班情况，有排班的日期高亮显示
- 点击任意日期查看当日排班详情

**排班操作**
| 功能 | 说明 |
|------|------|
| 添加排班 | 批量选择员工、日期和班次，一键排班 |
| 修改排班 | 在日期详情页修改单个员工的班次、考勤状态（新增内联编辑） |
| 删除排班 | 删除单个或批量删除排班记录（新增批量删除） |

**班次设置**
- 预设：早班(09:00-18:00)、中班(13:00-22:00)、晚班(21:00-06:00)、休息
- 支持自定义添加/编辑/删除班次

**考勤状态**
- 正常 / 迟到 / 早退 / 旷工 / 请假

**处罚与补卡（新增补卡功能）**
- 非正常考勤可设置处罚金额和处罚时长
- 补卡管理：系统统一配置默认补卡次数（默认3次）
- 排班修改时可独立设置补卡使用次数
- 补卡次数用完强制要求设置处罚金额

**加班信息整合（新增）**
- 在排班修改中直接设置加班时长和费率
- 系统自动计算加班费


### 3.5 加班管理 ⏱️

**功能说明**
- 自动汇总所有员工的加班记录（支持正式工和临时工）
- 按姓名/部门搜索筛选
- 查看月度加班详情（日历视图 + 每日明细）

**加班数据**
| 字段 | 说明 |
|------|------|
| 总加班时长 | 所有加班记录累计小时数 |
| 总加班费 | 加班时长 × 费率 |
| 月度汇总 | 按月查看加班统计 |

**操作**
- 导出加班数据（Excel）
- 导入加班数据（Excel）
- 批量删除加班记录
- 删除单个员工的加班记录


### 3.6 面试管理 🎯

**面试候选人管理**
| 功能 | 说明 |
|------|------|
| 添加面试者 | 记录姓名、电话、面试部门、岗位、轮次、面试官等 |
| 编辑面试者 | 更新面试信息 |
| 删除面试者 | 删除候选人记录（支持批量删除） |
| 拉黑面试者 | 将面试者加入黑名单，自动创建员工档案 |
| 状态跟踪 | 待面试 → 面试中 → 通过/候选/淘汰 |

**轮次配置**
- 自定义面试轮次（如：初试、复试、终面）
- 每轮可指定面试官

**类型配置**
- 面试类型（如：面试、笔试、实操）


### 3.7 黑名单 ⚠️

**黑名单管理**
| 功能 | 说明 |
|------|------|
| 黑名单列表 | 展示所有被拉黑的员工/面试者 |
| 查看详情 | 查看黑名单员工的完整信息和拉黑原因 |
| 移出黑名单 | 将员工从黑名单移除，自动恢复为"在职"状态 |
| 搜索筛选 | 按姓名/部门/原因搜索，按日期范围筛选 |

**拉黑来源**
1. 从正式工/临时工管理 → 点击"拉黑"按钮
2. 从面试管理 → 点击"拉黑"按钮

**拉黑信息**
- 拉黑原因（必填）
- 拉黑状态（离职/自离/开除/辞退/面试未通过）
- 拉黑日期（自动记录）

**黑名单姓名检测（新增）**
- 添加/编辑员工时自动检测姓名是否在黑名单中
- 实时提示，防止误操作


### 3.8 合同管理 📄（全新模块）

**功能列表**
| 功能 | 说明 |
|------|------|
| 合同列表 | 展示所有合同，支持搜索（姓名/部门）和状态筛选 |
| 添加合同 | 为员工创建合同，记录起止日期和状态 |
| 修改合同 | 仅"续期"状态可修改合同日期 |
| 删除合同 | 删除合同记录（支持批量删除） |
| 导入/导出 | Excel 批量导入导出合同数据 |
| 自动更新状态 | 根据当前日期自动更新合同状态 |

**合同状态**
- **在期**：合同有效期内
- **到期**：合同到期当天
- **续期**：已续期（可修改日期）
- **过期**：合同已过期

**使用场景**
- 员工入职时自动创建合同（填写合同起止日期）
- 合同到期前提醒续期
- 合同续期时修改日期并标记"续期"


### 3.9 账号管理 👥

**仅管理员可访问**

| 功能 | 说明 |
|------|------|
| 新增账号 | 创建新用户，分配角色（管理员/普通用户） |
| 修改密码 | 修改用户密码 |
| 权限配置 | 为普通用户分配模块访问权限 |
| 删除账号 | 删除用户（管理员账号不可删除） |

**权限粒度**
| 权限项 | 说明 |
|--------|------|
| 正式工管理 | 访问正式工模块 |
| 临时工管理 | 访问临时工模块 |
| 面试管理 | 访问面试模块 |
| 排班管理 | 访问排班模块 |
| 加班管理 | 访问加班模块 |
| 黑名单管理 | 访问黑名单模块 |
| 合同管理（新增） | 访问合同管理模块 |


### 3.10 数据管理 🗄️

**仅管理员可访问**

**数据库模式切换**
| 模式 | 说明 |
|------|------|
| 仅SQLite | 轻量级本地存储，适合小规模企业 |
| 仅MySQL | 企业级数据库，适合中大规模企业 |
| 双库同步 | SQLite + MySQL 双写，数据双保险 |

**MySQL 配置**
- 主机 / 端口 / 数据库名
- 用户名 / 密码 / 字符集
- 支持测试连接


### 3.11 部门管理 🏢（新增）

**功能说明**
- 通过员工管理模块中的"添加部门"按钮进入
- 支持添加新部门
- 支持删除部门（需部门下无员工）
- 部门列表自动同步到所有下拉选择框


## 四、数据模型说明

### 4.1 员工 (Employee)
| 字段 | 类型 | 说明 |
|------|------|------|
| employee_code | String | 工号 |
| name | String | 姓名 |
| gender | String | 性别 |
| age | Integer | 年龄 |
| phone | String | 电话 |
| email | String | 邮箱 |
| id_card | String | 身份证号码 |
| bank_card | String | 工资卡号 |
| employee_type | String | 员工类型（正式工/临时工） |
| department | String | 部门 |
| position | String | 职位 |
| salary_type | String | 薪资类型（时薪/日薪/周薪/月薪/年薪） |
| salary | Float | 基本薪资 |
| full_attendance_bonus | Float | 全勤奖（仅正式工） |
| year_end_bonus | Float | 年终奖（仅正式工） |
| service_year_bonus | Float | 工龄奖（仅正式工） |
| social_security_rate | Float | 社保比例（仅正式工） |
| housing_fund_rate | Float | 公积金比例（仅正式工） |
| hire_date | String | 入职日期 |
| resign_date | String | 离职日期 |
| status | String | 状态（在职/离职/自离/开除/辞退/面试未通过） |
| is_blacklisted | Boolean | 是否黑名单 |
| blacklist_reason | String | 拉黑原因 |
| blacklist_date | String | 拉黑日期 |
| blacklist_status | String | 拉黑状态 |
| annual_leave_total | Float | 年假总天数（仅正式工） |
| annual_leave_used | Float | 已休年假（仅正式工） |
| contract_start_date | String | 合同开始日期（新增） |
| contract_end_date | String | 合同结束日期（新增） |

### 4.2 排班 (Schedule)
| 字段 | 说明 |
|------|------|
| employee_id | 员工ID |
| date | 日期 |
| shift_type | 班次名称 |
| start_time | 开始时间 |
| end_time | 结束时间 |
| attendance_status | 考勤状态 |
| penalty_info | 处罚信息（JSON） |
| card_fix_info | 补卡信息（JSON）（新增） |
| overtime_info | 加班信息（JSON）（新增） |

### 4.3 合同 (Contract)（新增）
| 字段 | 类型 | 说明 |
|------|------|------|
| employee_id | Integer | 员工ID |
| employee_name | String | 员工姓名 |
| department | String | 部门 |
| contract_start_date | String | 合同开始日期 |
| contract_end_date | String | 合同结束日期 |
| contract_status | String | 状态（在期/到期/续期/过期） |

### 4.4 面试候选人 (InterviewCandidate)
| 字段 | 说明 |
|------|------|
| name | 姓名 |
| phone | 电话 |
| department | 面试部门 |
| position | 面试岗位 |
| interview_round | 面试轮次 |
| interviewer | 面试官 |
| interview_type | 面试类型 |
| interview_date | 面试时间 |
| status | 面试状态 |


## 五、操作流程指南

### 5.1 添加新员工
1. 进入 **正式工管理** 或 **临时工管理**
2. 点击 **+ 添加员工** 按钮
3. 填写员工信息：
   - 必填：姓名、部门、薪资类型、基本薪资、入职日期
   - 正式工额外：全勤奖、社保公积金、年假等
   - 新增：工号、手机、邮箱、身份证、工资卡号、合同起止日期
4. 系统自动检测姓名是否在黑名单中（新增）
5. 点击 **保存**

### 5.2 批量排班
1. 进入 **排班管理**
2. 点击 **📅 添加排班**
3. 选择员工（支持多选）
4. 选择班次
5. 选择月份，点击日期选择排班日期（支持多选）
6. 点击 **💾 保存排班** 或 **✅ 确定完成排班**

### 5.3 处理考勤异常
1. 进入 **排班管理**，点击有排班的日期
2. 在排班详情页找到对应员工
3. 点击 **修改**（内联编辑，新增）
4. 将考勤状态改为：迟到/早退/旷工/请假
5. 设置处罚金额和处罚时长
6. 在补卡设置中填写已使用次数（新增）
7. 如补卡次数用完，需设置处罚金额（新增）
8. 点击 **💾 保存修改**

### 5.4 记录加班（新增整合）
1. 进入 **排班管理**，点击有排班的日期
2. 在排班详情页找到对应员工
3. 点击 **修改**
4. 在"加班设置"区域填写：
   - 加班时长（小时）
   - 加班费率（¥/小时）
5. 系统自动计算加班费
6. 点击 **💾 保存修改**

### 5.5 面试流程
1. 进入 **面试管理**
2. 点击 **+ 添加面试者**，记录候选人信息
3. 面试后更新状态：
   - **待面试** → **面试中** → **通过/候选/淘汰**
4. 通过的候选人可转为正式工或临时工
5. 淘汰的候选人可**拉黑**

### 5.6 年假管理（仅正式工）
1. 进入 **正式工管理**，点击 **🏖️ 年假管理**
2. 为员工设置年假总天数
3. 员工请假时：
   - 在员工列表点击 **请假**
   - 输入请假天数和日期
   - 系统自动扣减剩余年假
4. 查看请假记录

### 5.7 合同管理（新增）
1. 进入 **合同管理** 模块
2. 查看合同列表，了解员工合同状态
3. 点击 **🔄 自动更新状态** 刷新合同状态
4. 为员工添加合同（或在员工编辑时填写合同起止日期自动创建）
5. 合同到期前，点击 **修改** 将状态改为"续期"
6. 修改合同起止日期，保存

### 5.8 补卡管理（新增）
1. 进入 **排班管理**
2. 点击有排班的日期，进入详情页
3. 点击 **修改** 进入内联编辑
4. 将考勤状态改为非正常状态（迟到/早退/旷工/请假）
5. 在"补卡设置"区域查看总次数和已使用次数
6. 如需使用补卡，填写已使用次数
7. 补卡次数用完后，系统强制要求设置处罚金额
8. 保存修改

### 5.9 部门管理（新增）
1. 在员工管理模块点击 **🏢 添加部门**
2. 输入部门名称，点击 **添加**
3. 查看现有部门列表
4. 点击部门标签上的 **×** 删除部门（需部门下无员工）

### 5.10 黑名单姓名检测（新增）
1. 进入 **正式工管理** 或 **临时工管理**
2. 点击 **+ 添加员工** 或 **编辑**
3. 输入姓名
4. 系统自动检测，如姓名在黑名单中则显示警告提示
5. 确认无误后继续保存


## 六、特色功能

### 6.1 数据导入导出
- **导出**：将员工列表导出为 Excel 文件
- **导入**：批量导入员工数据（支持 .xlsx / .xls / .csv）
- **加班导出**：导出加班统计报表
- **合同导出**：导出合同数据报表（新增）

### 6.2 动态薪资标签（新增）
根据选择的薪资类型（时薪/日薪/周薪/月薪/年薪），基本薪资输入框的标签和提示自动变化，提升数据录入准确性。

### 6.3 自动计算
- 社保金额 = 基本薪资 × 社保比例
- 公积金金额 = 基本薪资 × 公积金比例
- 工龄 = 当前日期 - 入职日期
- 年假剩余 = 年假总天数 - 已休天数
- 合同状态自动更新（新增）

### 6.4 双数据库同步
支持 SQLite + MySQL 双写模式，数据安全性更高，可平滑迁移至企业级数据库。

### 6.5 黑名单姓名检测（新增）
添加/编辑员工时，系统实时检测姓名是否在黑名单中，防止误录黑名单人员。

### 6.6 补卡管理（新增）
系统统一配置默认补卡次数，排班修改时可独立设置使用次数，用完强制处罚。

### 6.7 增强版人力成本统计（新增）
多维度统计：上月/本月预估/本年预估/上年/当日/本周，全方位掌握人力成本。


## 七、常见问题

### Q1: 登录失败怎么办？
- 确认后端服务已启动（`python 后端.py`）
- 确认端口 5000 未被占用
- 输入完用户名和密码后直接用鼠标点击登录按钮，不要直接用键盘的Tab键切换到登录按钮并按enter键登录
- 使用默认账号 admin / admin123 尝试

### Q2: 黑名单员工可以编辑吗？
不可以。黑名单员工只能查看详情，不可编辑。如需修改，请先移出黑名单。

### Q3: 临时工可以有年假吗？
不可以。年假功能仅对正式工开放，临时工的年假相关字段在界面中隐藏。

### Q4: 如何删除部门？
进入 **部门管理**（通过"添加部门"按钮进入），点击部门标签上的 × 按钮。注意：部门下必须无员工才能删除。

### Q5: 加班费怎么计算？
加班费 = 加班时长 × 加班费率。系统不自动计算，需要用户在排班修改时手动填写。

### Q6: 数据存在哪里？
默认使用 SQLite，数据库文件为 `employees.db`。如需使用 MySQL，请在 **数据管理** 中配置。

### Q7: 合同状态不更新怎么办？（新增）
点击合同管理中的 **🔄 自动更新状态** 按钮，系统会根据当前日期自动更新所有合同状态。

### Q8: 补卡次数用完了怎么办？（新增）
排班修改时，如果补卡次数用完，系统会强制要求设置处罚金额，否则无法保存。

### Q9: 如何查看黑名单员工的完整信息？（新增）
在 **黑名单** 模块点击 **查看详情**，或在独立黑名单查询页面点击 **查看** 按钮。

### Q10: 黑名单查询系统数据不同步怎么办？（新增）
检查主系统是否正常运行（端口5000），点击 **刷新** 按钮手动同步，或等待15秒自动同步。


## 八、独立的黑名单系统文件

### 8.1 概述
系统提供了一个独立的 **黑名单查询门户（`黑名单.html`）**，主要用于对外部开放查询。

### 8.2 功能特点
- **独立页面**：与主系统分离，可独立部署
- **只读模式**：外部用户仅支持查询和查看，无增删改权限
- **自动同步**：每15秒自动从主系统同步一次黑名单数据
- **搜索筛选**：支持按姓名、工号、部门、职位、原因搜索
- **查看详情**：点击"查看"按钮查看完整员工信息
- **在线状态指示**：实时显示与主系统的连接状态

### 8.3 使用场景
- 招聘背调
- 合作方审查
- 管理层查询
- 风控审计


## 九、版本信息

| 项目 | 内容 |
|------|------|
| 系统名称 | H.R 人事管理系统 |
| 版本号 | Max |
| 发布日期 | 2026年 |
| 技术支持 | 企业版 |

### v3.0 max 新增功能一览
- ✅ 合同管理模块
- ✅ 增强版人力成本统计
- ✅ 黑名单姓名检测
- ✅ 补卡设置
- ✅ 部门管理
- ✅ 薪资类型动态化（时薪/日薪/周薪/年薪）
- ✅ 排班内联编辑
- ✅ 排班批量删除
- ✅ 独立黑名单查询系统


*本文档涵盖系统的全部功能，如有疑问请参考系统内各模块的界面提示。*