What is Checawaa?
Checawaa is a GPS-based attendance tracking system designed for organizations that need to monitor employee check-ins, track punctuality, and automate attendance reporting. Built with simplicity and reliability in mind, Checawaa helps managers ensure accountability while providing employees with an easy way to log their attendance.The name “Checawaa” comes from combining “check” (attendance checking) with a friendly, memorable suffix - making it easy to remember and pronounce.
Who is Checawaa for?
Checawaa is ideal for:Construction Sites
Track worker attendance across multiple job sites with GPS verification
Field Teams
Monitor remote employees who work outside traditional office settings
Educational Institutions
Track teacher and staff attendance with automated tardiness reporting
Service Companies
Ensure service technicians check in at the start of their shifts
Key Features
For Employees
- One-Click Check-In: Simple interface to start shift tracking with GPS verification
- Automatic Updates: Location is recorded every 50 minutes during active shifts
- Mobile-Friendly: Responsive design works on any device with GPS capabilities
- No App Installation: Works directly in web browsers
For Administrators
- Real-Time Dashboard: Monitor who’s checked in and who’s missing
- Automated Reminders: System sends email notifications at 8:00 AM to employees who haven’t checked in
- Punctuality Tracking: Automatically flags check-ins after 8:30 AM as tardy
- PDF Reports: Generate comprehensive attendance reports with tardiness statistics
- Visual Analytics: View tardiness data through interactive charts
How It Works
Check-In
Employees click “Iniciar Turno” (Start Shift) to record their attendance with GPS coordinates.
Technology Stack
Checawaa is built with proven, reliable technologies:- Backend: Flask (Python web framework)
- Authentication: Flask-Login for secure session management
- Scheduling: APScheduler for automated 8:00 AM reminders
- Email: Flask-Mail with Gmail SMTP integration
- Reports: ReportLab for PDF generation
- Storage: JSON file-based data storage (simple and portable)
- Deployment: Gunicorn WSGI server ready for production
Core Concepts
User Roles
Admin Users- Access to monitoring dashboard
- Can send manual reminders
- Generate and download PDF reports
- View all employee attendance records
- Access to personal check-in interface
- Can start and track their own shifts
- View their last check-in time
Attendance Rules
- Check-ins before 8:30 AM are marked as PUNTUAL (On Time)
- Check-ins after 8:30 AM are marked as RETARDO (Tardy)
- Employees who haven’t checked in by 8:00 AM receive automatic reminder emails
GPS Tracking
When an employee starts their shift:- Browser requests GPS permission
- Current location (latitude/longitude) is captured
- Location is recorded with timestamp in
registros.json - Every 50 minutes, the system captures another GPS checkpoint
Privacy & Security
- Session Management: Secure Flask sessions with secret key protection
- GPS Data: Location coordinates are stored only for attendance verification
- Access Control: Login required for all system features
- Role-Based Access: Admin features restricted to admin users only
Getting Started
Ready to deploy Checawaa? Continue to our Quick Start Guide to get up and running in minutes, or check out the detailed Installation Instructions for local development setup.Quick Start
Deploy Checawaa and register your first users
Installation
Set up local development environment