# ClockInAnalyzer

**Repository Path**: nnnew/clock-in-analyzer

## Basic Information

- **Project Name**: ClockInAnalyzer
- **Description**: # 员工打卡记录分析系统
这是一个基于Streamlit的Web应用，用于分析员工的Excel打卡记录，自动计算工作时间并标注迟到情况。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-07
- **Last Updated**: 2025-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 员工打卡记录分析系统

这是一个用于分析员工的 Excel 打卡记录，自动计算工作时间并标注迟到情况。

## 功能特点

- 📊 **Excel 文件上传**: 支持.xlsx 和.xls 格式的打卡记录文件
- ⏰ **工作时间计算**: 自动计算每个员工的上午、下午和总工作时长
- 🚨 **迟到检测**: 根据公司标准工作时间自动标注迟到情况
- 📈 **统计分析**: 提供详细的员工考勤统计和汇总信息
- 💾 **结果导出**: 支持将分析结果导出为 Excel 文件

## 工作时间标准

- **上午班次**: 07:55 - 12:00
- **下午班次**: 13:20 - 17:30

## 安装和运行

目前有 python 和 html 两个版本，python 版本需要安装环境，html 版本直接打开 html 文件即可。具体安装方法参考目录内说明文档。

## 使用方法

1. 在 Web 界面中点击"选择 Excel 文件"按钮
2. 上传包含员工打卡记录的 Excel 文件
3. 系统会自动分析数据并显示结果
4. 查看分析结果，包括：
   - 每日详细打卡记录
   - 工作时长计算
   - 迟到情况标注
   - 员工统计汇总
5. 可以下载完整的分析结果 Excel 文件

## Excel 文件格式要求

输入的 Excel 文件应包含以下列：

- 第 1 列：员工姓名
- 第 2 列：工号（可选）
- 第 3 列：部门（可选）
- 第 4 列及以后：各日期的打卡时间记录

打卡时间格式：HH:MM（如：07:48、12:05 等），多个时间用换行分隔。

## 分析结果说明

系统会生成包含以下信息的分析报告：

- **早上到达时间**: 当日第一次上午打卡时间
- **早上离开时间**: 当日最后一次上午打卡时间
- **下午到达时间**: 当日第一次下午打卡时间
- **下午离开时间**: 当日最后一次下午打卡时间
- **工作时长**: 分别计算上午、下午和总工作时长
- **迟到标注**: 标记是否迟到、正常或缺勤

## 技术栈

（略））