项目简介
企业考勤管理系统是一套基于 Telegram 的 SaaS 考勤平台，专为在 Telegram 群组管理员工的企业设计。员工直接在群内完成打卡，管理员通过 Web 后台查看考勤、处理借支、导出报表，无需额外安装任何 App。系统支持多群组独立运营，每个群组有独立的考勤规则、成员数据和订阅状态。平台采用三级权限架构：普通员工、企业管理员、超级管理员，权限完全隔离。
核心功能
- 智能打卡：支持上下班、午休、大小厕、抽烟等多种打卡类型，仅限群内操作
- 考勤统计：自动识别迟到、早退、缺勤、旷工，每日定时推送考勤日报，异常自动触发罚款规则
- 借支管理：员工申请→管理员审批→自动记录，支持每月借支上限设置
- 罚款与奖励：管理员发起，实时推送员工，月底自动汇总发送个人明细
- 请假补卡：支持病假/事假/调休，审批后自动修正考勤记录
- 报表导出：考勤、借支、罚款、奖励全部支持 Excel 导出，按月按人汇总
- 双语界面：中英文同时显示，适合跨国团队
- 企业后台：Web 管理界面，考勤规则配置、成员管理、数据总览
- 超级后台：平台运营方专用，管理所有群组订阅和用户权限
技术栈
Python python-telegram-bot FastAPI PostgreSQL SQLAlchemy Redis Vue/React
关键技术亮点
1. 多群组独立运营的多租户架构 每个 Telegram 群组对应一个独立租户，拥有独立的考勤规则、成员名单、订阅状态、数据空间。一个实例支撑 N 家企业同时使用，新增企业零部署成本。
2. 打卡异常与罚款规则联动 打卡数据实时进库，规则引擎按企业配置的迟到 / 早退 / 旷工阈值自动识别异常，命中阈值直接写入罚款记录并推送当事人，减少 HR 的重复劳动。
3. 三级权限 + 双后台隔离 员工 / 企业管理员 / 超级管理员三级权限严格隔离，企业后台面向企业客户运营日常业务，超级后台面向平台运营方管理订阅和授权，数据层面完全隔离。
4. 定时任务 + 实时推送并行 每日考勤日报、月度汇总走定时任务；罚款、奖励、借支审批走实时推送。两套链路互不影响，保证日报不漏发，实时动作不延迟。
交付成果
- 员工端 Telegram 机器人 + 企业 Web 后台 + 超级后台一整套 SaaS
- 中英双语界面，支撑跨国团队使用
- 完整的考勤、借支、罚款、奖励、请假、报表链路
- 多租户架构，支撑多家企业独立运营
