本工具适用于**IT人力外包、软件技术服务、劳务派遣、财务结算**等行业场景，尤其适合需要将**公司内部考勤**与**客户方（甲方）考勤**进行逐日核对、人天费用结算的外包服务型企业。典型业务场景包括：项目组驻场人员考勤汇总、加班与请假工时统计、入离职人员工时折算、甲乙双方考勤差异比对、月度人天费用核算等。工具能够自动解析不同格式的考勤文件（公司考勤表、甲方考勤明细、人员进出记录），按自然月生成基础工时、加班人时/人天、请假人时/人天，并输出双方差异报表，帮助财务、项目经理和HR快速完成结算核对，大幅减少人工比对耗时和差错率。
本工具是一款基于 Python 开发的考勤数据处理与核对系统，提供从多源 Excel 文件读取、数据清洗、逐日比对到报表自动生成的全流程自动化处理。主要功能如下：
- **多源数据导入**：支持批量上传公司考勤表（按月）、甲方考勤明细、人员进出记录，自动识别表头与日期列。
- **智能符号解析**：内置考勤符号映射引擎，支持“√、假、假半、调休、调休半、加班、另班、纯数字”等多种格式，自动折算正常工时与加班工时。
- **入离职工时计算**：根据人员进出记录，自动计算入离职当月的应出勤基准工时，避免因人员变动造成的统计偏差。
- **四维报表输出**：一键生成“公司考勤”“甲方考勤”“双方比对”“考勤核对”四个 Sheet。其中双方比对逐日计算差异（行方-公司），差异单元格红色高亮；考勤核对按月汇总双方工时，高于标黄、低于标红。
- **自动统计与公式**：自动生成基础工时、加班人时/人天、请假人时/人天、合计工时等统计列，并写入合计行公式，可直接用于财务结算。
- **可配置规则**：节假日、调休工作日、考勤符号映射均可灵活配置，适配不同企业的考勤制度。
- **日志与错误处理**：运行过程自动记录日志，便于排查异常；对缺失文件、格式错误等情况生成友好提示。
- **可视化上传界面**：基于 Streamlit 提供网页端操作，上传文件、点击处理、下载报表，无需命令行操作。
该工具可将原本需要数小时的人工比对工作缩短至数分钟，适用于 IT 外包、人力结算、劳务派遣等场景。
本项目采用 **Python** 作为核心开发语言，结合 **Streamlit** 构建 Web 交互界面，使用 **pandas** 进行数据清洗与多表关联，**openpyxl** 完成 Excel 的读写、样式设置和公式写入。整体架构分为数据读取层、业务处理层、报表生成层和前端交互层，模块化设计，便于维护和扩展。
**核心实现要点：**
1. **多源文件解析**：针对公司考勤（`.xlsx`，按月分文件）、客户方考勤（`.xls`，含多个月份块）、人员进出（`.xlsx`）三类文件，分别编写独立的读取函数。自动定位表头行、识别姓名列与日期列，兼容不同格式的考勤表。
2. **考勤符号解析引擎**：通过正则与字符串匹配，将“√、假、假半、调休、调休半、加班、另班、纯数字”等符号统一转换为“正常工时+加班工时”二元组。支持复合格式（如“假4加班2”），并根据工作日/节假日动态调整解析逻辑。
3. **入离职工时折算**：结合人员进出记录中的入职、离职日期，计算员工在当月应出勤的基准工时，避免因人员变动导致统计偏差。对于新入职员工，还支持按实际打卡次数折算基础工时。
4. **逐日比对与条件格式**：在“双方比对”Sheet 中，逐日计算客户方工时与公司工时的差值，差值不为 0 的单元格自动标红；在“考勤核对”Sheet 中，按月汇总双方工时，客户方高于公司方标黄、低于标红，便于快速定位差异。
5. **报表自动生成**：一次性输出“公司考勤”“客户方考勤”“双方比对”“考勤核对”四个 Sheet，每个 Sheet 均包含完整表头、数据填充、合计行及 SUM 公式，可直接用于财务结算。
6. **日志与临时文件管理**：使用 `logging` 记录运行过程，`tempfile` 管理上传文件的临时存储，并在处理完成后主动关闭日志句柄，
评论