Trusted HRM Bundle | Ultimate HR & Payroll System with Offline Attendance

Login Credentials

Login Here: https://demo.trustedhrm.com/

Role / User	Email / Username	Password
Admin	admin@example.com	12345678
HR	hr@example.com	12345678
Staff	staff@example.com	12345678

Support

• Support via Email : sales@onesttech.com
• Support Center : https://onesttech.com/contact
• Direct Appointment: Google Meet
• WhatsApp: +88-01959335555

# Changelog

## 2.4.1 – Addon Installer & Regular Maintenance update (Web & App)

### Addon Installer
- Improved Addon Installer to support upcoming Codecanyon addons
- Improved UX of previous addon installer
- Improved network error messages (user-friendly instead of technical timeout text) - App
- Better handling when reopening app while offline – no false “session expired” - App
- Fixes for login and dashboard error handling - App
- General stability and reliability improvements

### Bug Fix and Improvements
- Regular bug fixes and small optimizations
- Dependency updates and compatibility tweaks
- Code cleanup and small refactors

---

## 2.1.0 – Major Feature Update

### Smart Notification System (NEW)
- Intelligent Break Reminders: Progressive notifications at 15, 30, and 60 minutes to prevent excessive breaks
- Daily Check-In Reminders: Automatic notifications at shift start time with configurable buffer
- Daily Check-Out Reminders: Never forget to check out with end-of-shift notifications
- Timezone-Aware Scheduling: Accurate notification timing across different regions with automatic timezone detection
- Device Reboot Recovery: Notifications automatically reschedule after device restart via BootReceiver
- User-Configurable Settings: Individual toggles for break, check-in, and check-out reminders in Settings
- Platform-Specific Optimization: WorkManager (Android) and Background Tasks (iOS) for reliable delivery

### Complete Offline Mode (NEW)
- Offline Attendance Tracking: Check-in and check-out work without internet connection
- Offline Break Management: Start and end breaks offline with automatic sync when connected
- Smart Sync Service: Intelligent background synchronization with priority-based queuing
- Bandwidth-Aware Syncing: Adaptive batch sizes for WiFi (10 items) vs Mobile Data (3 items, 1MB limit)
- Exponential Backoff Retry: Up to 5 retry attempts with increasing delays for failed syncs
- Real-Time Sync Progress: Stream-based progress tracking with visual indicators
- Conflict Resolution: Graceful handling of sync conflicts with user feedback
- Offline History Screens: View pending and synced records with detailed status

### Advanced GPS Security (NEW)
- Multi-Layer Spoofing Detection: Prevents location fraud with 6+ detection heuristics
- Mock location detection (Android native)
- Suspicious accuracy checks (0.0m or >1000m)
- Unrealistic speed detection (>500 km/h)
- Stationary pattern analysis (>5 min without movement)
- Altitude validation (-500m to 20,000m range)
- Unreliable GPS source detection
- Progressive Retry Mechanism: 3 attempts with increasing timeouts (5s, 10s, 20s)
- User-Friendly Error Dialogs: Clear guidance for permission/service issues
- High-Accuracy GPS: Network and satellite positioning with intelligent fallback

### Break Time Management Enhancements
- Break Lock Overlay: Full-screen glassmorphic UI prevents other actions during breaks
- Animated Break Indicator: Engaging coffee break animation for better UX
- Break Start Time Display: Real-time elapsed break duration tracking
- One-Tap Break End: Universal action button to end breaks quickly

### UI/UX Improvements
- Responsive Design System: Adaptive layouts for phones and tablets with responsive utilities
- Enhanced Home Screen: Improved typography hierarchy and layout optimization
- Better Bottom Navigation: Fixed overflow issues and smoother animations
- Modern Visual Assets: Added animated icons and notification settings graphics
- Improved Error Handling: Better user feedback with contextual error messages

### Technical Enhancements
- New Dependencies: flutter_local_notifications ^19.5.0, workmanager ^0.9.0+3, timezone ^0.10.1
- Android Optimizations: ProGuard enabled for release builds (smaller APK size)
- 7 new permissions for notifications and background tasks
- Custom ProGuard rules for WorkManager and Flutter plugins
- BootReceiver for notification persistence after reboot
- iOS Enhancements: Background modes (fetch, processing, remote-notification)
- BGTaskScheduler identifiers for break/check-in/check-out reminders
- AppDelegate notification handling for foreground presentation
- Production-Ready Code: Removed all test/debug code, production notification timings (15, 30, 60 minutes)
- Enhanced error handling and recovery mechanisms

### Localization Updates
- Added notification-related translations across all 5 languages (en, ar, es, hi, zh)
- Break overlay messages and instructions
- Notification settings labels
- Offline mode status messages

### Platform Support
- Android: Full support with WorkManager background tasks and exact alarm permissions (Android 12+)
- iOS: Complete background task scheduling with UIBackgroundModes
- Cross-platform notification delivery with platform-specific optimizations

### Security & Privacy
- Google Play Store compliance with comprehensive data safety declarations
- Privacy policy updated with offline data handling disclosure
- Enhanced location permission usage descriptions
- Secure offline data storage with automatic cleanup

### Bug Fixes
- Fixed bottom navigation overflow on smaller screens
- Improved timezone handling for shift-based notifications
- Enhanced location service availability checks
- Better connectivity state monitoring for sync operations
- Fixed notification rescheduling after app updates

### Performance Improvements
- ProGuard optimization reduces APK size by ~30%
- Efficient offline queue management with automatic cleanup
- Optimized notification scheduling to reduce battery drain
- Smart location caching (uses cached location if <2 minutes old)
- Background task batching for improved efficiency

### Web Update
- Fixed salary view issue
- Fixed password reset issue
- Added Basic payroll
- Fixed monthly attendance repost month issue
- Database Backup.
- User asset issue fixing.
- Attendance devices registered
- Attendance report
- Notification issue fixing.
- Complaint Application.
- Verbal warning issue fixing.

---

## 2.0.0 – CodeCanyon Release Update

### Security & Configuration
- Removed hardcoded API URL and replaced with configurable placeholder
- Enhanced security by ensuring all sensitive data is properly handled
- Improved API configuration with clear setup instructions
- Added comprehensive `.gitignore` to exclude sensitive files (keystores, local.properties)

### Documentation Improvements
- Completely revamped README.md with detailed installation instructions
- Enhanced DOCUMENTATION.md with comprehensive setup, build, and customization guides
- Added troubleshooting section with common issues and solutions
- Created CODECANYON_CHECKLIST.md for pre-submission verification
- Improved API configuration documentation with examples for different environments

### Code Quality
- Verified all debug prints are properly guarded by `kDebugMode`
- Enhanced error handling throughout the application
- Improved code organization and structure
- Added LICENSE file (MIT License with CodeCanyon terms)

### Project Structure
- Enhanced project structure documentation
- Improved asset organization
- Better separation of concerns in code architecture

### UI/UX
- Improved error messages and user feedback
- Enhanced offline mode handling
- Better loading states and shimmer effects

### Build & Deployment
- Updated build instructions for both Android and iOS
- Added signing configuration guidelines
- Improved release build documentation

### Platform Support
- Verified Android compatibility (min SDK 21)
- Verified iOS compatibility (min iOS 12.0)
- Enhanced platform-specific configuration documentation

### Bug Fixes
- Fixed API configuration issues
- Improved network error handling
- Enhanced location permission handling

---

## 1.0.0 – Initial Release

- Initial release of Trusted HRM
- Attendance reports (daily/monthly), leave management, employee directory
- Multi-language support (en, ar, es, hi, zh)
- Provider state management, Dio networking
- Documentation, Credits, Support files added for marketplace submission