How aaryanpartap/office_location_tracker_mobile works
PingME is a Flutter employee attendance and location-tracking app with separate employee and admin workflows. Users authenticate, employees check in and share live/background location and chat; admins monitor statuses, inspect maps and route history, configure work zones, and export reports. The README documents the main capabilities and architecture, but the Dart implementation was not sampled, so some subsystem links are documented rather than verified at call-site level.
Main entry points: employee_dashboard_screen.dart Employee dashboard · admin_dashboard_screen.dart Admin dashboard · location_tracking_dashboard_screen.dart Tracking dashboard · firebase_tracking_repository.dart Firebase repository
Components 26
App experience
- App entry
employee_location_tracker/lib/main.dart - Root app
employee_location_tracker/lib/app.dart - Login
employee_location_tracker/lib/screens/login_screen.dart - OTP verification
employee_location_tracker/lib/screens/otp_verification_screen.dart - Employee dashboard
employee_location_tracker/lib/screens/employee_dashboard_screen.dart - Admin dashboard
employee_location_tracker/lib/screens/admin_dashboard_screen.dart - Direct chat
employee_location_tracker/lib/screens/chat_screen.dart
Tracking and analytics
- Tracking dashboard
employee_location_tracker/lib/screens/location_tracking_dashboard_screen.dart - Tracking maps
employee_location_tracker/lib/widgets/location_tracking_map_widget.dart - Route history
employee_location_tracker/lib/screens/tracker_map_widget.dart - Heatmap analytics
employee_location_tracker/lib/services/heat_map_utils.dart - Work zones
employee_location_tracker/lib/models/work_zone.dart - PDF export
employee_location_tracker/lib/services/tracking_export_service.dart
State and data
- Tracking state
employee_location_tracker/lib/providers/tracking_provider.dart - Tracking repository
employee_location_tracker/lib/repositories/tracking_repository.dart - Firebase repository
employee_location_tracker/lib/repositories/firebase_tracking_repository.dart - Mock repository
employee_location_tracker/lib/repositories/mock_tracking_repository.dart - Device tracking
employee_location_tracker/lib/services/device_tracking_service.dart - Backend mode config
employee_location_tracker/lib/core/app_config.dart
External services
- Firebase Auth
- Cloud Firestore
- Google Maps
- Firebase Storage
- Geolocation services
Other components
- Employee
- Admin
Connections 25
- App entry → Root app: starts
README.md - Employee → Login: signs in
README.md - Admin → Login: signs in
README.md - Login → OTP verification: verifies phone
README.md - OTP verification → Firebase Auth: authenticates with
README.md - Employee → Employee dashboard: uses
README.md - Admin → Admin dashboard: uses
README.md - Employee dashboard → Tracking state: manages attendance
- Admin dashboard → Tracking dashboard: monitors team
README.md - Employee dashboard → Device tracking: tracks location
README.md - Device tracking → Geolocation services: gets location
README.md - Tracking dashboard → Tracking maps: shows locations
README.md - Tracking dashboard → Route history: shows routes
README.md - Tracking dashboard → Heatmap analytics: renders hotspots
README.md - Admin dashboard → Work zones: sets zones
README.md - Admin dashboard → PDF export: exports reports
README.md - Employee dashboard → Direct chat: opens chat
README.md - Tracking state → Tracking repository: uses
- Tracking repository → Firebase repository: implemented by
README.md - Tracking repository → Mock repository: implemented by
README.md - Backend mode config → Mock repository: selects demo mode
README.md - Backend mode config → Firebase repository: selects production mode
README.md - Firebase repository → Cloud Firestore: stores tracking data
README.md - Firebase repository → Firebase Storage: uses storage
README.md - Tracking maps → Google Maps: renders maps
README.md