VisionEase-护眼行动考勤管理系统

一个智能化的考勤数据处理系统，基于现代 Web 技术构建，提供直观的用户界面和强大的数据处理能力。

✨ 主要功能

🚀 智能文件识别 - 自动识别 Excel 文件类型
📊 实时处理进度 - WebSocket 实时显示处理状态
🎨 现代化界面 - 基于 Vue 3 + Element Plus
⚙️ 灵活配置 - 可自定义时间节点和过滤条件
📁 批量处理 - 支持多文件同时处理
📝 博客集成 - 基于 Hexo 的文档系统

🎯 适用场景

企业考勤数据统计分析
刷卡记录数据清洗
考勤报告自动生成
人员出勤情况汇总

🛠️ 技术架构

前端

Hexo - 静态博客生成器
Vue 3 - 响应式前端框架
Element Plus - 企业级 UI 组件库
WebSocket - 实时通信

后端

FastAPI - 高性能 Python Web 框架
pandas - 数据分析处理
openpyxl - Excel 文件操作
uvicorn - ASGI 服务器

📦 快速安装

1. 环境准备

1
2
3

# 确保已安装以下软件
Node.js >= 14.0.0
Python >= 3.11.9

2. 项目安装

# 克隆项目
git clone <项目地址>
cd blog

# 安装前端依赖
npm install

# 安装后端依赖
cd server
python -m venv venv
venv\Scripts\activate  # Windows
pip install -r requirements.txt

3. 启动服务

# 启动后端 (在 server 目录)
python run.py

# 启动前端 (在项目根目录)
npm run server

4. 访问系统

博客首页: http://localhost:4000
考勤系统: http://localhost:4000/attendance/

📋 使用指南

支持的文件格式

文件类型	文件名示例	必需性	说明
人员信息表	`人员信息表.xlsx`	✅ 必需	包含员工基本信息
PPM刷卡主记录	`PPM刷卡主记录视图.xlsx`	✅ 必需	主要刷卡数据
刷卡记录表	`刷卡记录表.xlsx`	✅ 必需	详细刷卡记录
休息日表	`休息日表.xlsx`	✅ 可选	节假日配置

操作步骤

📤 上传文件
- 拖拽或点击上传 Excel 文件
- 系统自动识别文件类型
- 显示上传进度和状态
⚙️ 配置参数
- 设置过滤关键字（如部门名称）
- 调整时间节点配置
- 设置迟到早退阈值
🔄 开始处理
- 点击”开始处理”按钮
- 实时查看处理日志
- 监控处理进度
📥 下载结果
- 处理完成后自动跳转
- 预览或下载处理结果
- 支持多文件批量下载

配置说明

时间节点配置

白班时间: 08:00-11:30, 13:00-17:30
加班时间: 17:30-次日08:00
值班时间: 08:00-次日08:00
静设备班组: 16:00-次日08:00

过滤设置

关键字过滤: 支持多个关键字
时间间隔: 去重时间阈值（默认30秒）
迟到阈值: 忽略轻微迟到（默认1分钟）

🔧 常见问题

Q: 文件上传失败怎么办？

A: 检查以下几点：

文件格式是否为 .xlsx 或 .xls
文件大小是否超过 50MB
文件是否包含正确的表头
后端服务是否正常运行

Q: 处理过程中出现错误？

A: 可以通过以下方式排查：

查看实时日志了解具体错误
检查上传文件的数据格式
确认所有必需文件都已上传
验证配置参数是否合理

Q: 如何查看详细日志？

A: 日志查看方式：

前端：浏览器开发者工具 Console
后端：server/server.log 文件
实时日志：考勤系统界面的日志面板

Q: 系统支持哪些浏览器？

A: 推荐使用现代浏览器：

Chrome 80+
Firefox 75+
Safari 13+
Edge 80+

📞 技术支持

如果您在使用过程中遇到问题，可以通过以下方式获取帮助：

查看文档 - 仔细阅读本 README 文档
检查日志 - 查看系统日志了解错误详情
提交 Issue - 在项目仓库提交问题报告
联系维护者 - 通过项目联系方式获取支持

🚀 部署指南

开发环境

# 前端开发服务器
npm run server

# 后端开发服务器
python run.py

生产环境

# 构建前端静态文件
npm run build

# 使用 Nginx 代理
# 配置文件参考项目中的 nginx.conf

📈 项目状态

✅ 核心功能完成
✅ 基础测试通过
🔄 持续优化中
📋 功能扩展计划中

🤝 贡献代码

欢迎提交 Pull Request 或 Issue 来改进项目！

📄 开源协议

本项目采用 MIT 开源协议，详见 LICENSE 文件。

VisionEase-护眼行动 - 让考勤管理更简单、更智能！