About the Project
Enterprise Attendance Manager is a Telegram-based SaaS attendance platform built for companies that manage their teams through Telegram groups. Employees clock in directly inside the group; managers review attendance, process advances, and export reports through a web admin panel — no additional app installation required. The system supports independent multi-group operation, with each group having its own attendance rules, member data, and subscription state. The platform uses a three-tier permission architecture: employee / company admin / super admin, with fully isolated access at every level.
Core Features
- Smart Clock-In: Multiple clock-in types — start of day, end of day, lunch break, short break, smoke break — group-only operation enforced
- Attendance Tracking: Auto-detects late arrivals, early departures, absences, and no-shows; daily attendance report delivered on schedule; violations automatically trigger penalty rules
- Advance Management: Employee requests → admin approves → auto-recorded; configurable monthly advance limit per employee
- Penalties and Bonuses: Initiated by admins, pushed to employees in real time; month-end auto-summary sent with individual breakdowns
- Leave and Correction: Supports sick leave, personal leave, and compensatory leave; attendance records auto-corrected upon approval
- Report Export: Attendance, advances, penalties, and bonuses all exportable to Excel, summarized by month and by person
- Bilingual Interface: Chinese and English displayed simultaneously, suitable for cross-border teams
- Company Admin Panel: Web management interface for attendance rule configuration, member management, and data overview
- Super Admin Panel: Dedicated to the platform operator — manages all group subscriptions and user permissions
Tech Stack
Python python-telegram-bot FastAPI PostgreSQL SQLAlchemy Redis Vue/React
Engineering Highlights
1. Multi-Tenant Architecture for Independent Group Operations Each Telegram group maps to an independent tenant with its own attendance rules, member list, subscription state, and data space. One deployment supports N companies simultaneously; onboarding a new company requires zero infrastructure work.
2. Clock-In Anomaly and Penalty Rule Integration Clock-in data is written to the database in real time. The rules engine evaluates each entry against the company's configured late / early / absent thresholds, and when a threshold is crossed, it writes a penalty record and pushes a notification to the employee immediately — reducing repetitive manual work for HR.
3. Three-Tier Permissions and Dual Admin Panel Isolation Employee / company admin / super admin access is strictly isolated. The company admin panel serves day-to-day business operations for the client company; the super admin panel serves the platform operator for subscription and license management. Data is fully separated at the storage layer.
4. Scheduled Tasks and Real-Time Push in Parallel Daily attendance reports and monthly summaries run as scheduled tasks. Penalty, bonus, and advance approval notifications use real-time push. The two pipelines are independent — daily reports are never missed, and real-time actions are never delayed.
Deliverables
- Employee-side Telegram bot + company web admin + super admin panel — a complete SaaS stack
- Bilingual interface supporting cross-border team operations
- Full chain: attendance, advances, penalties, bonuses, leave, and reports
- Multi-tenant architecture supporting multiple companies operating independently on one instance
