1. 项目概述作为一名长期从事企业信息化系统开发的工程师我最近完成了一个基于微信小程序的企业考勤系统项目。这个系统完美解决了传统考勤方式存在的诸多痛点纸质签到易丢失、指纹打卡设备昂贵、人脸识别系统部署复杂等问题。通过微信小程序这一轻量级平台员工只需携带手机即可完成考勤管理人员也能实时查看考勤数据大大提升了企业考勤管理的效率和便捷性。这个系统采用了前后端分离的架构设计前端使用微信小程序原生框架后端基于Spring Boot构建数据库选用MySQL。系统不仅实现了基础的打卡功能还包含了异常考勤处理、考勤统计报表、多级审批流程等企业级功能模块。特别值得一提的是系统支持GPS定位和Wi-Fi打卡双重验证机制有效防止了代打卡等作弊行为。在开发过程中我遇到了不少技术挑战比如小程序端性能优化、高并发打卡请求处理、考勤数据一致性保证等。通过合理的架构设计和算法优化最终都得到了很好的解决。现在我将这个项目的完整开发过程和关键技术点分享出来希望能为需要开发类似系统的同行提供参考。2. 系统架构设计2.1 技术栈选型在项目启动阶段技术选型是首要考虑的问题。经过对各种技术方案的对比评估最终确定了以下技术栈前端技术微信小程序原生框架选择原生框架而非uniapp等跨平台方案主要考虑到更好的性能和官方支持WXML/WXSS小程序特有的模板语言和样式表JavaScript ES6使用Promise、async/await等现代语法Vant Weapp组件库提供丰富的UI组件加速开发后端技术Spring Boot 2.7简化配置快速构建微服务Spring Security处理认证和授权MyBatis-Plus简化数据库操作Redis缓存热点数据提高响应速度RabbitMQ异步处理考勤统计等耗时操作数据库MySQL 8.0主数据库存储核心业务数据MongoDB存储考勤打卡的轨迹数据基础设施Nginx反向代理和负载均衡Docker容器化部署Jenkins持续集成和部署技术选型心得在实际项目中技术选型需要综合考虑团队技术储备、项目规模、性能需求和后期维护成本。不要盲目追求新技术稳定性和可维护性同样重要。2.2 系统架构设计系统采用典型的三层架构设计分为表现层、业务逻辑层和数据访问层同时引入了一些微服务的设计理念。2.2.1 表现层表现层由微信小程序和Web管理端组成小程序端提供员工打卡、请假申请、考勤查询等功能Web管理端供HR和管理人员使用包含员工管理、考勤统计、审批流程等功能两者通过RESTful API与后端交互接口设计遵循以下原则资源化每个API对应一种资源如/api/attendance版本控制API路径包含版本号如/api/v1/attendance幂等性重要操作如打卡确保多次请求结果一致2.2.2 业务逻辑层业务逻辑层是系统的核心主要包含以下服务认证服务处理用户登录、权限校验考勤服务核心业务逻辑包括打卡处理、异常判断审批服务处理请假、调休等审批流程报表服务生成各类考勤统计报表通知服务发送打卡提醒、审批结果等通知服务之间通过Spring Cloud Feign进行通信关键接口都做了熔断和降级处理确保系统稳定性。2.2.3 数据访问层数据访问层采用MyBatis-Plus作为ORM框架主要优化点包括读写分离查询走从库写入走主库分库分表考勤记录按月分表减轻单表压力多级缓存本地缓存Redis减少数据库访问对于考勤轨迹这类时序数据使用MongoDB存储利用其良好的扩展性和灵活的schema。2.3 数据库设计数据库设计遵循第三范式确保数据一致性和完整性。以下是几个核心表的设计员工表(employee)CREATE TABLE employee ( id bigint NOT NULL AUTO_INCREMENT, employee_no varchar(32) NOT NULL COMMENT 工号, name varchar(64) NOT NULL COMMENT 姓名, department_id bigint NOT NULL COMMENT 部门ID, position varchar(64) DEFAULT NULL COMMENT 职位, mobile varchar(20) DEFAULT NULL COMMENT 手机号, email varchar(128) DEFAULT NULL COMMENT 邮箱, status tinyint NOT NULL DEFAULT 1 COMMENT 状态1-在职0-离职, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_employee_no (employee_no), KEY idx_department (department_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT员工表;考勤规则表(attendance_rule)CREATE TABLE attendance_rule ( id bigint NOT NULL AUTO_INCREMENT, name varchar(128) NOT NULL COMMENT 规则名称, work_time time NOT NULL COMMENT 上班时间, off_time time NOT NULL COMMENT 下班时间, late_minutes int DEFAULT 30 COMMENT 迟到分钟数阈值, early_minutes int DEFAULT 30 COMMENT 早退分钟数阈值, allow_location varchar(255) DEFAULT NULL COMMENT 允许打卡的GPS位置, allow_wifi varchar(255) DEFAULT NULL COMMENT 允许打卡的Wi-Fi名称, effective_date date NOT NULL COMMENT 生效日期, department_ids varchar(255) DEFAULT NULL COMMENT 适用部门ID多个用逗号分隔, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT考勤规则表;考勤记录表(attendance_record)CREATE TABLE attendance_record_202301 ( id bigint NOT NULL AUTO_INCREMENT, employee_id bigint NOT NULL COMMENT 员工ID, date date NOT NULL COMMENT 考勤日期, clock_in_time datetime DEFAULT NULL COMMENT 上班打卡时间, clock_out_time datetime DEFAULT NULL COMMENT 下班打卡时间, clock_in_location varchar(255) DEFAULT NULL COMMENT 上班打卡位置, clock_out_location varchar(255) DEFAULT NULL COMMENT 下班打卡位置, clock_in_wifi varchar(128) DEFAULT NULL COMMENT 上班打卡Wi-Fi, clock_out_wifi varchar(128) DEFAULT NULL COMMENT 下班打卡Wi-Fi, status tinyint DEFAULT 0 COMMENT 状态0-正常1-迟到2-早退3-缺卡, remark varchar(255) DEFAULT NULL COMMENT 备注, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_employee_date (employee_id,date), KEY idx_date (date), KEY idx_employee (employee_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT考勤记录表;数据库设计经验考勤系统的数据特点是写入频繁、查询复杂。在设计时要特别注意索引的合理使用避免全表扫描。对于考勤记录这类数据量大的表建议按月分表并建立合适的组合索引。3. 核心功能实现3.1 打卡功能实现打卡是系统的核心功能需要考虑多种场景和异常情况。下面是打卡功能的主要实现逻辑3.1.1 打卡流程设计前置检查检查员工状态是否在职检查当前时间是否在允许打卡时段检查当日否已打卡防止重复打卡位置验证获取用户当前GPS坐标计算与公司允许打卡位置的距离距离超过阈值如500米则不允许打卡Wi-Fi验证可选获取手机连接的Wi-Fi信息验证是否在公司预设的允许Wi-Fi列表中打卡记录保存记录打卡时间、位置、Wi-Fi等信息异步生成考勤状态正常、迟到、早退等结果返回返回打卡成功/失败信息提示下次打卡建议时间3.1.2 关键代码实现小程序端打卡代码// pages/clock/clock.js Page({ data: { clockType: in, // in-上班打卡out-下班打卡 location: null, wifiInfo: null, clockStatus: ready // ready, processing, success, fail }, onLoad() { this.getLocation(); this.getWifiInfo(); }, // 获取当前位置 getLocation() { wx.getLocation({ type: gcj02, success: (res) { this.setData({ location: res }); }, fail: (err) { console.error(获取位置失败, err); } }); }, // 获取Wi-Fi信息 getWifiInfo() { wx.startWifi({ success: () { wx.getConnectedWifi({ success: (res) { this.setData({ wifiInfo: res.wifi }); }, fail: (err) { console.error(获取Wi-Fi失败, err); } }); } }); }, // 执行打卡 doClock() { if (this.data.clockStatus processing) return; this.setData({ clockStatus: processing }); wx.request({ url: https://api.yourdomain.com/attendance/clock, method: POST, data: { type: this.data.clockType, longitude: this.data.location.longitude, latitude: this.data.location.latitude, wifiBSSID: this.data.wifiInfo ? this.data.wifiInfo.BSSID : null, wifiSSID: this.data.wifiInfo ? this.data.wifiInfo.SSID : null }, success: (res) { if (res.data.code 0) { this.setData({ clockStatus: success }); wx.showToast({ title: 打卡成功, icon: success }); } else { this.setData({ clockStatus: fail }); wx.showToast({ title: res.data.msg, icon: none }); } }, fail: (err) { this.setData({ clockStatus: fail }); wx.showToast({ title: 网络错误, icon: none }); } }); } });后端打卡接口实现RestController RequestMapping(/attendance) public class AttendanceController { Autowired private AttendanceService attendanceService; PostMapping(/clock) public Result clock(CurrentUser Employee employee, RequestBody ClockDTO clockDTO) { try { AttendanceRecord record attendanceService.processClock(employee, clockDTO); return Result.success(record); } catch (BusinessException e) { return Result.fail(e.getMessage()); } } } Service public class AttendanceServiceImpl implements AttendanceService { Override public AttendanceRecord processClock(Employee employee, ClockDTO clockDTO) { // 1. 检查员工状态 if (employee.getStatus() ! 1) { throw new BusinessException(员工状态异常无法打卡); } // 2. 获取当日考勤规则 LocalDate today LocalDate.now(); AttendanceRule rule getAttendanceRule(employee.getDepartmentId(), today); // 3. 验证打卡时间 LocalDateTime now LocalDateTime.now(); validateClockTime(clockDTO.getType(), now, rule); // 4. 验证位置 validateLocation(clockDTO.getLongitude(), clockDTO.getLatitude(), rule); // 5. 验证Wi-Fi如果配置 if (StringUtils.isNotBlank(rule.getAllowWifi())) { validateWifi(clockDTO.getWifiSSID(), clockDTO.getWifiBSSID(), rule); } // 6. 保存打卡记录 AttendanceRecord record new AttendanceRecord(); record.setEmployeeId(employee.getId()); record.setDate(today); if (in.equals(clockDTO.getType())) { record.setClockInTime(now); record.setClockInLocation(clockDTO.getLongitude() , clockDTO.getLatitude()); record.setClockInWifi(clockDTO.getWifiSSID()); } else { record.setClockOutTime(now); record.setClockOutLocation(clockDTO.getLongitude() , clockDTO.getLatitude()); record.setClockOutWifi(clockDTO.getWifiSSID()); } attendanceMapper.insertOrUpdate(record); // 7. 异步处理考勤状态 asyncProcessAttendanceStatus(record); return record; } private void validateClockTime(String type, LocalDateTime now, AttendanceRule rule) { LocalTime currentTime now.toLocalTime(); if (in.equals(type)) { // 上班打卡应在规定时间前后1小时内 LocalTime start rule.getWorkTime().minusHours(1); LocalTime end rule.getWorkTime().plusHours(1); if (currentTime.isBefore(start) || currentTime.isAfter(end)) { throw new BusinessException(当前不在上班打卡时段); } } else { // 下班打卡应在规定时间前后2小时内 LocalTime start rule.getOffTime().minusHours(1); LocalTime end rule.getOffTime().plusHours(2); if (currentTime.isBefore(start) || currentTime.isAfter(end)) { throw new BusinessException(当前不在下班打卡时段); } } } // 其他验证方法... }3.1.3 打卡功能优化在实际运行中我们发现打卡功能有几个需要特别注意的点高并发处理上班打卡时段通常会有大量并发请求我们采取了以下措施使用Redis分布式锁防止重复打卡打卡记录先写入Redis再异步同步到数据库数据库使用批量插入优化位置验证优化GPS定位在室内可能不准确我们允许配置多个打卡位置如公司各出入口引入Wi-Fi验证作为辅助手段对于定位失败的情况允许拍照打卡需人工审核异常处理网络不稳定是移动端常见问题我们实现打卡本地缓存网络恢复后自动重试提供打卡记录查询和补卡申请功能关键操作保证幂等性打卡功能心得打卡看似简单但要考虑各种边界情况和异常场景。特别是移动端网络不稳定、GPS信号弱等问题需要有完善的容错机制。同时防作弊也是企业考勤系统的关键需求。3.2 考勤统计功能实现考勤统计是管理人员最关注的功能之一需要从海量打卡数据中生成各类报表。3.2.1 统计维度设计系统支持多种统计维度个人维度员工个人的考勤明细、月度汇总部门维度部门整体考勤情况、异常率对比时间维度日报、周报、月报、自定义时段异常类型迟到、早、缺卡、外勤等3.2.2 统计实现方案考虑到考勤统计涉及大量数据计算我们采用了以下方案定时任务预计算每日凌晨计算前一天的考勤状态每周日生成上周的考勤周报每月初生成上月的考勤月报结果存入统计表查询时直接使用实时统计优化使用Redis缓存热门部门的统计结果大数据量查询使用分页懒加载复杂报表支持异步生成下载关键代码实现Service public class AttendanceReportServiceImpl implements AttendanceReportService { Autowired private AttendanceRecordMapper recordMapper; Autowired private AttendanceStatsMapper statsMapper; Autowired private RedisTemplateString, Object redisTemplate; Override Scheduled(cron 0 0 2 * * ?) // 每天凌晨2点执行 public void dailyStats() { LocalDate yesterday LocalDate.now().minusDays(1); statsByDate(yesterday); } Override Scheduled(cron 0 0 3 ? * SUN) // 每周日凌晨3点执行 public void weeklyStats() { LocalDate endDate LocalDate.now().minusDays(1); LocalDate startDate endDate.minusDays(6); statsByDateRange(startDate, endDate); } Override Scheduled(cron 0 0 4 1 * ?) // 每月1日凌晨4点执行 public void monthlyStats() { LocalDate endDate LocalDate.now().minusMonths(1).withDayOfMonth( LocalDate.now().minusMonths(1).lengthOfMonth() ); LocalDate startDate endDate.withDayOfMonth(1); statsByDateRange(startDate, endDate); } private void statsByDate(LocalDate date) { // 按部门统计 ListDepartment departments departmentMapper.selectAll(); for (Department dept : departments) { StatsResult result recordMapper.statsByDepartment(dept.getId(), date, date); saveStatsResult(result, daily); } // 按个人统计 ListEmployee employees employeeMapper.selectByStatus(1); for (Employee emp : employees) { StatsResult result recordMapper.statsByEmployee(emp.getId(), date, date); saveStatsResult(result, daily); } } private void saveStatsResult(StatsResult result, String statsType) { AttendanceStats stats new AttendanceStats(); stats.setStatsType(statsType); stats.setStatsDate(result.getStatsDate()); stats.setDepartmentId(result.getDepartmentId()); stats.setEmployeeId(result.getEmployeeId()); stats.setNormalCount(result.getNormalCount()); stats.setLateCount(result.getLateCount()); stats.setEarlyCount(result.getEarlyCount()); stats.setAbsentCount(result.getAbsentCount()); stats.setOutCount(result.getOutCount()); statsMapper.insert(stats); // 更新Redis缓存 String cacheKey buildCacheKey(stats); redisTemplate.opsForValue().set(cacheKey, result, 24, TimeUnit.HOURS); } // 其他方法... }3.2.3 统计报表展示系统提供多种形式的报表展示数据表格明细数据支持筛选和导出图表展示柱状图、饼图展示统计结果异常标记突出显示异常数据对比分析部门间、时段间对比前端使用ECharts实现可视化// 月度考勤统计图表 function renderMonthlyChart(statsData) { const chart echarts.init(document.getElementById(monthly-chart)); const option { tooltip: { trigger: axis, axisPointer: { type: shadow } }, legend: { data: [正常, 迟到, 早退, 缺卡, 外勤] }, grid: { left: 3%, right: 4%, bottom: 3%, containLabel: true }, xAxis: { type: category, data: statsData.days }, yAxis: { type: value, name: 人次 }, series: [ { name: 正常, type: bar, stack: total, data: statsData.normal }, { name: 迟到, type: bar, stack: total, data: statsData.late }, { name: 早退, type: bar, stack: total, data: statsData.early }, { name: 缺卡, type: bar, stack: total, data: statsData.absent }, { name: 外勤, type: bar, stack: total, data: statsData.out } ] }; chart.setOption(option); }统计功能心得考勤统计要兼顾灵活性和性能。预计算是提升查询性能的有效手段但也要考虑存储成本。对于实时性要求不高的报表采用定时任务缓存的方式可以显著减轻数据库压力。4. 系统部署与优化4.1 系统部署方案系统采用Docker容器化部署便于扩展和维护。部署架构如下前端部署微信小程序打包上传至微信平台Web管理端使用Nginx部署静态资源后端部署API服务Spring Boot应用打包为Docker镜像数据库MySQL主从集群缓存Redis哨兵模式消息队列RabbitMQ集群监控告警Prometheus Grafana监控系统指标ELK收集和分析日志关键异常通过企业微信机器人告警4.2 性能优化实践在系统运行过程中我们针对以下方面进行了优化数据库优化考勤记录表按月分表建立合适的组合索引使用EXPLAIN分析慢查询优化JOIN操作避免全表扫描缓存策略多级缓存本地缓存(Caffeine) Redis热点数据预加载缓存雪崩/穿透/击穿防护接口优化合并细粒度接口数据压缩传输异步处理非关键路径小程序优化分包加载图片懒加载减少setData数据量使用自定义组件4.3 安全防护措施企业考勤系统涉及员工隐私数据安全性至关重要数据安全敏感字段加密存储数据库脱敏查询传输层HTTPS加密定期数据备份接口安全完善的权限控制接口签名验证防重放攻击频率限制日志审计完整记录关键操作操作日志不可篡改定期审计分析5. 项目总结与展望这个微信小程序考勤系统从设计到上线历时3个月目前已在多家企业稳定运行日均处理打卡记录超过1万条。系统有效解决了传统考勤方式的痛点获得了客户的一致好评。在开发过程中我深刻体会到几个关键点边界情况处理移动端应用要特别考虑网络不稳定、定位不准等异常场景数据一致性考勤数据要求高度准确需要完善的异常处理和数据校验机制性能优化高并发场景下的系统响应速度直接影响用户体验可扩展性考勤规则多样系统设计要足够灵活以适应不同企业的需求未来我们计划在以下方面继续优化系统引入人脸识别打卡提升安全性增加智能排班功能开发数据分析模块提供更深入的考勤洞察优化移动端体验支持离线打卡这个项目的完整源码和设计文档我已经整理好如果需要参考或二次开发可以联系我获取。每个核心模块都有详细注释数据库设计文档也包含在内希望能帮助到有类似需求的开发者。
微信小程序企业考勤系统开发实践与架构设计
1. 项目概述作为一名长期从事企业信息化系统开发的工程师我最近完成了一个基于微信小程序的企业考勤系统项目。这个系统完美解决了传统考勤方式存在的诸多痛点纸质签到易丢失、指纹打卡设备昂贵、人脸识别系统部署复杂等问题。通过微信小程序这一轻量级平台员工只需携带手机即可完成考勤管理人员也能实时查看考勤数据大大提升了企业考勤管理的效率和便捷性。这个系统采用了前后端分离的架构设计前端使用微信小程序原生框架后端基于Spring Boot构建数据库选用MySQL。系统不仅实现了基础的打卡功能还包含了异常考勤处理、考勤统计报表、多级审批流程等企业级功能模块。特别值得一提的是系统支持GPS定位和Wi-Fi打卡双重验证机制有效防止了代打卡等作弊行为。在开发过程中我遇到了不少技术挑战比如小程序端性能优化、高并发打卡请求处理、考勤数据一致性保证等。通过合理的架构设计和算法优化最终都得到了很好的解决。现在我将这个项目的完整开发过程和关键技术点分享出来希望能为需要开发类似系统的同行提供参考。2. 系统架构设计2.1 技术栈选型在项目启动阶段技术选型是首要考虑的问题。经过对各种技术方案的对比评估最终确定了以下技术栈前端技术微信小程序原生框架选择原生框架而非uniapp等跨平台方案主要考虑到更好的性能和官方支持WXML/WXSS小程序特有的模板语言和样式表JavaScript ES6使用Promise、async/await等现代语法Vant Weapp组件库提供丰富的UI组件加速开发后端技术Spring Boot 2.7简化配置快速构建微服务Spring Security处理认证和授权MyBatis-Plus简化数据库操作Redis缓存热点数据提高响应速度RabbitMQ异步处理考勤统计等耗时操作数据库MySQL 8.0主数据库存储核心业务数据MongoDB存储考勤打卡的轨迹数据基础设施Nginx反向代理和负载均衡Docker容器化部署Jenkins持续集成和部署技术选型心得在实际项目中技术选型需要综合考虑团队技术储备、项目规模、性能需求和后期维护成本。不要盲目追求新技术稳定性和可维护性同样重要。2.2 系统架构设计系统采用典型的三层架构设计分为表现层、业务逻辑层和数据访问层同时引入了一些微服务的设计理念。2.2.1 表现层表现层由微信小程序和Web管理端组成小程序端提供员工打卡、请假申请、考勤查询等功能Web管理端供HR和管理人员使用包含员工管理、考勤统计、审批流程等功能两者通过RESTful API与后端交互接口设计遵循以下原则资源化每个API对应一种资源如/api/attendance版本控制API路径包含版本号如/api/v1/attendance幂等性重要操作如打卡确保多次请求结果一致2.2.2 业务逻辑层业务逻辑层是系统的核心主要包含以下服务认证服务处理用户登录、权限校验考勤服务核心业务逻辑包括打卡处理、异常判断审批服务处理请假、调休等审批流程报表服务生成各类考勤统计报表通知服务发送打卡提醒、审批结果等通知服务之间通过Spring Cloud Feign进行通信关键接口都做了熔断和降级处理确保系统稳定性。2.2.3 数据访问层数据访问层采用MyBatis-Plus作为ORM框架主要优化点包括读写分离查询走从库写入走主库分库分表考勤记录按月分表减轻单表压力多级缓存本地缓存Redis减少数据库访问对于考勤轨迹这类时序数据使用MongoDB存储利用其良好的扩展性和灵活的schema。2.3 数据库设计数据库设计遵循第三范式确保数据一致性和完整性。以下是几个核心表的设计员工表(employee)CREATE TABLE employee ( id bigint NOT NULL AUTO_INCREMENT, employee_no varchar(32) NOT NULL COMMENT 工号, name varchar(64) NOT NULL COMMENT 姓名, department_id bigint NOT NULL COMMENT 部门ID, position varchar(64) DEFAULT NULL COMMENT 职位, mobile varchar(20) DEFAULT NULL COMMENT 手机号, email varchar(128) DEFAULT NULL COMMENT 邮箱, status tinyint NOT NULL DEFAULT 1 COMMENT 状态1-在职0-离职, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_employee_no (employee_no), KEY idx_department (department_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT员工表;考勤规则表(attendance_rule)CREATE TABLE attendance_rule ( id bigint NOT NULL AUTO_INCREMENT, name varchar(128) NOT NULL COMMENT 规则名称, work_time time NOT NULL COMMENT 上班时间, off_time time NOT NULL COMMENT 下班时间, late_minutes int DEFAULT 30 COMMENT 迟到分钟数阈值, early_minutes int DEFAULT 30 COMMENT 早退分钟数阈值, allow_location varchar(255) DEFAULT NULL COMMENT 允许打卡的GPS位置, allow_wifi varchar(255) DEFAULT NULL COMMENT 允许打卡的Wi-Fi名称, effective_date date NOT NULL COMMENT 生效日期, department_ids varchar(255) DEFAULT NULL COMMENT 适用部门ID多个用逗号分隔, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT考勤规则表;考勤记录表(attendance_record)CREATE TABLE attendance_record_202301 ( id bigint NOT NULL AUTO_INCREMENT, employee_id bigint NOT NULL COMMENT 员工ID, date date NOT NULL COMMENT 考勤日期, clock_in_time datetime DEFAULT NULL COMMENT 上班打卡时间, clock_out_time datetime DEFAULT NULL COMMENT 下班打卡时间, clock_in_location varchar(255) DEFAULT NULL COMMENT 上班打卡位置, clock_out_location varchar(255) DEFAULT NULL COMMENT 下班打卡位置, clock_in_wifi varchar(128) DEFAULT NULL COMMENT 上班打卡Wi-Fi, clock_out_wifi varchar(128) DEFAULT NULL COMMENT 下班打卡Wi-Fi, status tinyint DEFAULT 0 COMMENT 状态0-正常1-迟到2-早退3-缺卡, remark varchar(255) DEFAULT NULL COMMENT 备注, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_employee_date (employee_id,date), KEY idx_date (date), KEY idx_employee (employee_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT考勤记录表;数据库设计经验考勤系统的数据特点是写入频繁、查询复杂。在设计时要特别注意索引的合理使用避免全表扫描。对于考勤记录这类数据量大的表建议按月分表并建立合适的组合索引。3. 核心功能实现3.1 打卡功能实现打卡是系统的核心功能需要考虑多种场景和异常情况。下面是打卡功能的主要实现逻辑3.1.1 打卡流程设计前置检查检查员工状态是否在职检查当前时间是否在允许打卡时段检查当日否已打卡防止重复打卡位置验证获取用户当前GPS坐标计算与公司允许打卡位置的距离距离超过阈值如500米则不允许打卡Wi-Fi验证可选获取手机连接的Wi-Fi信息验证是否在公司预设的允许Wi-Fi列表中打卡记录保存记录打卡时间、位置、Wi-Fi等信息异步生成考勤状态正常、迟到、早退等结果返回返回打卡成功/失败信息提示下次打卡建议时间3.1.2 关键代码实现小程序端打卡代码// pages/clock/clock.js Page({ data: { clockType: in, // in-上班打卡out-下班打卡 location: null, wifiInfo: null, clockStatus: ready // ready, processing, success, fail }, onLoad() { this.getLocation(); this.getWifiInfo(); }, // 获取当前位置 getLocation() { wx.getLocation({ type: gcj02, success: (res) { this.setData({ location: res }); }, fail: (err) { console.error(获取位置失败, err); } }); }, // 获取Wi-Fi信息 getWifiInfo() { wx.startWifi({ success: () { wx.getConnectedWifi({ success: (res) { this.setData({ wifiInfo: res.wifi }); }, fail: (err) { console.error(获取Wi-Fi失败, err); } }); } }); }, // 执行打卡 doClock() { if (this.data.clockStatus processing) return; this.setData({ clockStatus: processing }); wx.request({ url: https://api.yourdomain.com/attendance/clock, method: POST, data: { type: this.data.clockType, longitude: this.data.location.longitude, latitude: this.data.location.latitude, wifiBSSID: this.data.wifiInfo ? this.data.wifiInfo.BSSID : null, wifiSSID: this.data.wifiInfo ? this.data.wifiInfo.SSID : null }, success: (res) { if (res.data.code 0) { this.setData({ clockStatus: success }); wx.showToast({ title: 打卡成功, icon: success }); } else { this.setData({ clockStatus: fail }); wx.showToast({ title: res.data.msg, icon: none }); } }, fail: (err) { this.setData({ clockStatus: fail }); wx.showToast({ title: 网络错误, icon: none }); } }); } });后端打卡接口实现RestController RequestMapping(/attendance) public class AttendanceController { Autowired private AttendanceService attendanceService; PostMapping(/clock) public Result clock(CurrentUser Employee employee, RequestBody ClockDTO clockDTO) { try { AttendanceRecord record attendanceService.processClock(employee, clockDTO); return Result.success(record); } catch (BusinessException e) { return Result.fail(e.getMessage()); } } } Service public class AttendanceServiceImpl implements AttendanceService { Override public AttendanceRecord processClock(Employee employee, ClockDTO clockDTO) { // 1. 检查员工状态 if (employee.getStatus() ! 1) { throw new BusinessException(员工状态异常无法打卡); } // 2. 获取当日考勤规则 LocalDate today LocalDate.now(); AttendanceRule rule getAttendanceRule(employee.getDepartmentId(), today); // 3. 验证打卡时间 LocalDateTime now LocalDateTime.now(); validateClockTime(clockDTO.getType(), now, rule); // 4. 验证位置 validateLocation(clockDTO.getLongitude(), clockDTO.getLatitude(), rule); // 5. 验证Wi-Fi如果配置 if (StringUtils.isNotBlank(rule.getAllowWifi())) { validateWifi(clockDTO.getWifiSSID(), clockDTO.getWifiBSSID(), rule); } // 6. 保存打卡记录 AttendanceRecord record new AttendanceRecord(); record.setEmployeeId(employee.getId()); record.setDate(today); if (in.equals(clockDTO.getType())) { record.setClockInTime(now); record.setClockInLocation(clockDTO.getLongitude() , clockDTO.getLatitude()); record.setClockInWifi(clockDTO.getWifiSSID()); } else { record.setClockOutTime(now); record.setClockOutLocation(clockDTO.getLongitude() , clockDTO.getLatitude()); record.setClockOutWifi(clockDTO.getWifiSSID()); } attendanceMapper.insertOrUpdate(record); // 7. 异步处理考勤状态 asyncProcessAttendanceStatus(record); return record; } private void validateClockTime(String type, LocalDateTime now, AttendanceRule rule) { LocalTime currentTime now.toLocalTime(); if (in.equals(type)) { // 上班打卡应在规定时间前后1小时内 LocalTime start rule.getWorkTime().minusHours(1); LocalTime end rule.getWorkTime().plusHours(1); if (currentTime.isBefore(start) || currentTime.isAfter(end)) { throw new BusinessException(当前不在上班打卡时段); } } else { // 下班打卡应在规定时间前后2小时内 LocalTime start rule.getOffTime().minusHours(1); LocalTime end rule.getOffTime().plusHours(2); if (currentTime.isBefore(start) || currentTime.isAfter(end)) { throw new BusinessException(当前不在下班打卡时段); } } } // 其他验证方法... }3.1.3 打卡功能优化在实际运行中我们发现打卡功能有几个需要特别注意的点高并发处理上班打卡时段通常会有大量并发请求我们采取了以下措施使用Redis分布式锁防止重复打卡打卡记录先写入Redis再异步同步到数据库数据库使用批量插入优化位置验证优化GPS定位在室内可能不准确我们允许配置多个打卡位置如公司各出入口引入Wi-Fi验证作为辅助手段对于定位失败的情况允许拍照打卡需人工审核异常处理网络不稳定是移动端常见问题我们实现打卡本地缓存网络恢复后自动重试提供打卡记录查询和补卡申请功能关键操作保证幂等性打卡功能心得打卡看似简单但要考虑各种边界情况和异常场景。特别是移动端网络不稳定、GPS信号弱等问题需要有完善的容错机制。同时防作弊也是企业考勤系统的关键需求。3.2 考勤统计功能实现考勤统计是管理人员最关注的功能之一需要从海量打卡数据中生成各类报表。3.2.1 统计维度设计系统支持多种统计维度个人维度员工个人的考勤明细、月度汇总部门维度部门整体考勤情况、异常率对比时间维度日报、周报、月报、自定义时段异常类型迟到、早、缺卡、外勤等3.2.2 统计实现方案考虑到考勤统计涉及大量数据计算我们采用了以下方案定时任务预计算每日凌晨计算前一天的考勤状态每周日生成上周的考勤周报每月初生成上月的考勤月报结果存入统计表查询时直接使用实时统计优化使用Redis缓存热门部门的统计结果大数据量查询使用分页懒加载复杂报表支持异步生成下载关键代码实现Service public class AttendanceReportServiceImpl implements AttendanceReportService { Autowired private AttendanceRecordMapper recordMapper; Autowired private AttendanceStatsMapper statsMapper; Autowired private RedisTemplateString, Object redisTemplate; Override Scheduled(cron 0 0 2 * * ?) // 每天凌晨2点执行 public void dailyStats() { LocalDate yesterday LocalDate.now().minusDays(1); statsByDate(yesterday); } Override Scheduled(cron 0 0 3 ? * SUN) // 每周日凌晨3点执行 public void weeklyStats() { LocalDate endDate LocalDate.now().minusDays(1); LocalDate startDate endDate.minusDays(6); statsByDateRange(startDate, endDate); } Override Scheduled(cron 0 0 4 1 * ?) // 每月1日凌晨4点执行 public void monthlyStats() { LocalDate endDate LocalDate.now().minusMonths(1).withDayOfMonth( LocalDate.now().minusMonths(1).lengthOfMonth() ); LocalDate startDate endDate.withDayOfMonth(1); statsByDateRange(startDate, endDate); } private void statsByDate(LocalDate date) { // 按部门统计 ListDepartment departments departmentMapper.selectAll(); for (Department dept : departments) { StatsResult result recordMapper.statsByDepartment(dept.getId(), date, date); saveStatsResult(result, daily); } // 按个人统计 ListEmployee employees employeeMapper.selectByStatus(1); for (Employee emp : employees) { StatsResult result recordMapper.statsByEmployee(emp.getId(), date, date); saveStatsResult(result, daily); } } private void saveStatsResult(StatsResult result, String statsType) { AttendanceStats stats new AttendanceStats(); stats.setStatsType(statsType); stats.setStatsDate(result.getStatsDate()); stats.setDepartmentId(result.getDepartmentId()); stats.setEmployeeId(result.getEmployeeId()); stats.setNormalCount(result.getNormalCount()); stats.setLateCount(result.getLateCount()); stats.setEarlyCount(result.getEarlyCount()); stats.setAbsentCount(result.getAbsentCount()); stats.setOutCount(result.getOutCount()); statsMapper.insert(stats); // 更新Redis缓存 String cacheKey buildCacheKey(stats); redisTemplate.opsForValue().set(cacheKey, result, 24, TimeUnit.HOURS); } // 其他方法... }3.2.3 统计报表展示系统提供多种形式的报表展示数据表格明细数据支持筛选和导出图表展示柱状图、饼图展示统计结果异常标记突出显示异常数据对比分析部门间、时段间对比前端使用ECharts实现可视化// 月度考勤统计图表 function renderMonthlyChart(statsData) { const chart echarts.init(document.getElementById(monthly-chart)); const option { tooltip: { trigger: axis, axisPointer: { type: shadow } }, legend: { data: [正常, 迟到, 早退, 缺卡, 外勤] }, grid: { left: 3%, right: 4%, bottom: 3%, containLabel: true }, xAxis: { type: category, data: statsData.days }, yAxis: { type: value, name: 人次 }, series: [ { name: 正常, type: bar, stack: total, data: statsData.normal }, { name: 迟到, type: bar, stack: total, data: statsData.late }, { name: 早退, type: bar, stack: total, data: statsData.early }, { name: 缺卡, type: bar, stack: total, data: statsData.absent }, { name: 外勤, type: bar, stack: total, data: statsData.out } ] }; chart.setOption(option); }统计功能心得考勤统计要兼顾灵活性和性能。预计算是提升查询性能的有效手段但也要考虑存储成本。对于实时性要求不高的报表采用定时任务缓存的方式可以显著减轻数据库压力。4. 系统部署与优化4.1 系统部署方案系统采用Docker容器化部署便于扩展和维护。部署架构如下前端部署微信小程序打包上传至微信平台Web管理端使用Nginx部署静态资源后端部署API服务Spring Boot应用打包为Docker镜像数据库MySQL主从集群缓存Redis哨兵模式消息队列RabbitMQ集群监控告警Prometheus Grafana监控系统指标ELK收集和分析日志关键异常通过企业微信机器人告警4.2 性能优化实践在系统运行过程中我们针对以下方面进行了优化数据库优化考勤记录表按月分表建立合适的组合索引使用EXPLAIN分析慢查询优化JOIN操作避免全表扫描缓存策略多级缓存本地缓存(Caffeine) Redis热点数据预加载缓存雪崩/穿透/击穿防护接口优化合并细粒度接口数据压缩传输异步处理非关键路径小程序优化分包加载图片懒加载减少setData数据量使用自定义组件4.3 安全防护措施企业考勤系统涉及员工隐私数据安全性至关重要数据安全敏感字段加密存储数据库脱敏查询传输层HTTPS加密定期数据备份接口安全完善的权限控制接口签名验证防重放攻击频率限制日志审计完整记录关键操作操作日志不可篡改定期审计分析5. 项目总结与展望这个微信小程序考勤系统从设计到上线历时3个月目前已在多家企业稳定运行日均处理打卡记录超过1万条。系统有效解决了传统考勤方式的痛点获得了客户的一致好评。在开发过程中我深刻体会到几个关键点边界情况处理移动端应用要特别考虑网络不稳定、定位不准等异常场景数据一致性考勤数据要求高度准确需要完善的异常处理和数据校验机制性能优化高并发场景下的系统响应速度直接影响用户体验可扩展性考勤规则多样系统设计要足够灵活以适应不同企业的需求未来我们计划在以下方面继续优化系统引入人脸识别打卡提升安全性增加智能排班功能开发数据分析模块提供更深入的考勤洞察优化移动端体验支持离线打卡这个项目的完整源码和设计文档我已经整理好如果需要参考或二次开发可以联系我获取。每个核心模块都有详细注释数据库设计文档也包含在内希望能帮助到有类似需求的开发者。
