001/README.md

智能考勤管理系统 (C++17 CMake 工程)

基于《智能考勤管理系统》软件设计说明书实现的C++示例工程。

项目概述

这是一个简化版的智能考勤管理系统，展示了核心数据结构和基本操作。项目采用模块化设计，包含以下功能：

• 员工管理（Employee）
• 排班规则管理（ScheduleRule）
• 考勤打卡记录（CheckInRecord）
• 考勤结果计算（AttendanceResult）
• 异常事件记录（AlertEvent）

编译说明

前置要求

• CMake 3.12 或更高版本
• 支持C++17的编译器（GCC 7+, Clang 5+, MSVC 2017+）

编译步骤

# 1. 创建构建目录
mkdir build
cd build

# 2. 生成构建系统
cmake ..

# 3. 编译项目
cmake --build .

# 4. 运行主程序
./bin/attendance_system

# 5. 运行测试
./bin/basic_test

项目结构

.
├── CMakeLists.txt          # CMake构建配置文件
├── README.md              # 项目说明文档
├── include/               # 头文件目录
│   ├── app.hpp           # 应用程序主头文件
│   ├── employee.hpp      # 员工数据结构
│   ├── schedule.hpp      # 排班规则结构
│   ├── checkin.hpp       # 打卡记录结构
│   ├── attendance.hpp    # 考勤结果结构
│   └── alert.hpp         # 异常事件结构
├── src/                  # 源文件目录
│   ├── main.cpp         # 程序入口
│   ├── app.cpp          # 应用程序逻辑
│   ├── employee.cpp     # 员工管理实现
│   ├── schedule.cpp     # 排班管理实现
│   ├── checkin.cpp      # 打卡记录实现
│   ├── attendance.cpp   # 考勤计算实现
│   └── alert.cpp        # 异常事件实现
└── tests/               # 测试文件目录
    └── basic_test.cpp   # 基本功能测试

核心数据结构

根据需求文档，实现了以下核心数据结构：

1. Employee（员工档案）

• employeeId：员工ID
• name：姓名
• departmentId：部门ID
• position：职位
• mobile：手机号
• email：邮箱

2. ScheduleRule（排班规则）

• ruleId：规则ID
• shiftName：班次名称
• startTime：上班时间
• endTime：下班时间
• breakDuration：休息时长
• overtimeThreshold：加班阈值

3. CheckInRecord（打卡记录）

• recordId：记录ID
• employeeId：员工ID
• method：打卡方式（FACE/GPS/CARD）
• timestamp：时间戳
• location：位置信息

4. AttendanceResult（考勤结果）

• resultId：结果ID
• employeeId：员工ID
• date：日期
• status：状态（LATE/EARLY/ABSENT/OVERTIME）
• duration：时长
• remarks：备注

5. AlertEvent（异常事件）

• eventId：事件ID
• employeeId：员工ID
• alertType：异常类型
• time：时间
• reason：原因
• notifiedChannels：通知渠道

使用示例

程序启动后会：

1. 创建示例员工和排班规则
2. 模拟员工打卡
3. 计算考勤结果
4. 检测异常事件
5. 输出统计信息

测试

项目包含基本的单元测试，验证核心数据结构的功能正确性。

注意事项

1. 这是一个演示工程，实现了核心数据结构但未包含完整业务逻辑
2. 实际生产环境需要添加数据库连接、网络通信、加密存储等功能
3. 安全约束（如TLS加密、JWT认证）需要额外实现
4. 性能约束（高并发、大数据量）需要分布式架构支持

许可证

本项目仅供学习参考使用。