本项目为前几天收费帮学妹做的一个项目，在工作环境中基本使用不到，但是很多学校把这个当作编程入门的项目来做，故分享出本项目供初学者参考。

一、项目描述

给部门文员用的内网 Web 工具，处理员工考勤打卡数据的导入、统计和异常管理。

http://127.0.0.1:5100
管理员 admin / admin123

二、项目功能

用户登录 账号密码登录，默认管理员 admin / admin123，支持注册新用户
班次管理 定义上下班时间、迟到/早退宽容分钟数（如白班 09:00-18:00）
地点管理 定义打卡地点及匹配关键词（如”主楼””北门”），导入时自动识别
员工管理 维护员工信息（工号、姓名、默认班次），支持 Excel 批量导入
数据导入 下载标准 Excel 模板，填入打卡记录后上传，系统自动统计
考勤查看 按月日历视图展示所有人出勤情况，颜色标记迟到/早退/缺卡
异常反馈 列出所有异常记录，文员可填写处理意见
统计报表 月度出勤率图表、迟到排行、异常分布
数据导出 考勤/异常/统计均可导出 Excel，支持自定义选择导出列

使用流程
第 1 步：基础配置
1. 添加班次 → 如白班 09:00-18:00，迟到宽容 15 分钟
2. 添加地点 → 如”主楼”，关键词填”主楼,办公楼”
3. 添加员工 → 逐一添加或下载模板批量导入
第 2 步：导入打卡数据
1. 在数据导入页面下载 Excel 模板
2. 按模板格式填入打卡记录（姓名、工号、日期、打卡时间、打卡地点）
3. 上传 Excel，系统自动：
– 按关键词匹配打卡地点
– 将每日首条打卡记为上班卡、末条记为下班卡
– 判定迟到/早退/缺卡状态
第 3 步：查看与处理
– 考勤查看 → 月度总览，颜色一目了然
– 异常反馈 → 处理迟到、缺卡等异常，填写备注
– 统计报表 → 月度数据图表和排行
考勤判定规则
上班打卡 ≤ 班次上班时间 + 宽容分钟数 正常
上班打卡 > 班次上班时间 + 宽容分钟数 迟到
下班打卡 < 班次下班时间 – 宽容分钟数 早退
当天仅有 1 条打卡记录 缺少下班卡
当天无打卡记录 缺勤

三、运行环境

开发环境 pycharm
运行环境 flask+mysql+python3.8

四、项目技术

开发环境 pycharm
运行环境 flask+mysql+python3.8

五、项目截图