Attendance System - 企业考勤管理系统

项目概述

企业多方式考勤打卡系统，支持人脸识别、GPS定位、工牌刷卡三种打卡方式。 自动化计算迟到、早退、缺勤、加班等考勤结果，并提供异常预警、报表生成、 管理员控制台等完整功能。

功能模块

• 考勤打卡服务：接收打卡请求，验证JWT令牌，记录打卡信息
• 排班规则引擎：管理班次定义与排班规则
• 考勤计算引擎：自动判定考勤结果
• 异常检测与通知服务：监控异常并发送通知
• 报表生成器：多维度统计报表（Excel/PDF）
• 管理员控制台：员工档案、排班配置、权限管理
• 数据加密模块：生物特征加密存储
• 外部系统对接网关：HRMS数据同步API

技术栈

• C++17 + CMake
• 无外部第三方依赖（仅标准库）

编译与运行

# 创建构建目录
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