51 lines
1.4 KiB
Markdown
51 lines
1.4 KiB
Markdown
# Attendance System - 企业考勤管理系统
|
||
|
||
## 项目概述
|
||
|
||
企业多方式考勤打卡系统，支持人脸识别、GPS定位、工牌刷卡三种打卡方式。
|
||
自动化计算迟到、早退、缺勤、加班等考勤结果，并提供异常预警、报表生成、
|
||
管理员控制台等完整功能。
|
||
|
||
## 功能模块
|
||
|
||
- **考勤打卡服务**：接收打卡请求，验证JWT令牌，记录打卡信息
|
||
- **排班规则引擎**：管理班次定义与排班规则
|
||
- **考勤计算引擎**：自动判定考勤结果
|
||
- **异常检测与通知服务**：监控异常并发送通知
|
||
- **报表生成器**：多维度统计报表（Excel/PDF）
|
||
- **管理员控制台**：员工档案、排班配置、权限管理
|
||
- **数据加密模块**：生物特征加密存储
|
||
- **外部系统对接网关**：HRMS数据同步API
|
||
|
||
## 技术栈
|
||
|
||
- C++17 + CMake
|
||
- 无外部第三方依赖（仅标准库）
|
||
|
||
## 编译与运行
|
||
|
||
```bash
|
||
# 创建构建目录
|
||
mkdir build && cd build
|
||
|
||
# 配置
|
||
cmake ..
|
||
|
||
# 编译
|
||
cmake --build .
|
||
|
||
# 运行主程序
|
||
./attendance_system
|
||
|
||
# 运行测试
|
||
./basic_test
|
||
```
|
||
|
||
## 数据结构概述
|
||
|
||
- 打卡记录 (CheckinRecord)：recordId, employeeId, method, timestamp, location
|
||
- 排班规则 (ScheduleRule)：deptId, shiftName, startTime, endTime
|
||
- 考勤结果 (AttendanceResult)：迟到/早退/缺勤/加班判定
|
||
- 异常预警 (AlertNotification)：alertType, employeeId, reason
|
||
- 系统角色 (SystemRole)：SUPER_ADMIN, HR_MANAGER, DEPT_MANAGER
|