v1.0.0: Production Release
Changelog
All notable changes to the TutorHQ tuition and academy management project are documented in this file.
The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.
[1.0.0] - 2026-09-09
Added
- Automated Fee Calculator:
- Configurable student billing cycles: Date-to-Date (join date anniversary, e.g. 16th to 16th) and 1st of Every Month.
- Automatic mid-month proration formula (
Fee × ActiveDays / TotalDaysInMonth). - Automated batch due calculation and 1-tap invoice generation.
- Multi-mode payment recording: Cash, UPI, Bank Transfer, Cheque.
- Executive Invoices & Payment Receipts:
- ISO A4 PDF rendering with dynamic UPI QR code generator (
upi://pay?pa=...). - Complete student metadata: Parent/Guardian name, residential address, and peer/sibling connection badge.
- Official digital verification badge, eliminating the need for physical ink signatures.
- ISO A4 PDF rendering with dynamic UPI QR code generator (
- Cross-Platform Barcode & QR Auto-Attendance:
- Android: CameraX viewfinder with Google ML Kit Barcode Scanning.
- iOS: Native
AVFoundation(AVCaptureMetadataOutput) and CoreImageCIQRCodeGenerator. - Scannable Student ID Cards with crisp offline QR badges (
TUTORHQ:STU-{id}). - Flexible payload matching: Formatted QR, direct ID, roll number, phone digits, or student name.
- 3-second debounce window to prevent accidental double-marking.
- Automated attendance status calculation (Present vs Late if scanned >15 minutes after batch start).
- Tactile and haptic feedback on successful scan (
UIImpactFeedbackGenerator& AndroidHapticFeedbackType).
- Optional USB OTG Scanner & Fingerprint Support (Android):
- Plug-and-play detection for USB HID barcode guns and biometric fingerprint readers (Mantra MFS100, Morpho MSO1300, SecuGen Hamster, Startek).
- Hardware scanning operates without camera access.
- Non-mandatory hardware feature (
android:required="false").
- Automated Dual-Destination Backups & Scheduled Rotation:
- Configurable automated backup schedules: Daily, Weekly, and Monthly.
- Dual-destination persistence: Internal sandbox, external app storage, and public
Documents/TutorHQ_Backups. - Universal JSON backup schema shared identically between Android and iOS.
- Data Retention & Safe Forward Migrations:
- Explicit Room forward migrations (
MIGRATION_1_2,MIGRATION_2_3,MIGRATION_3_4). - Automatic pre-update database snapshot backup (
*.pre_update.bak). - Background
DataRecoveryManagerrestoring legacy databases automatically on startup. android:hasFragileUserData="true"protection.
- Explicit Room forward migrations (
- Biometric App Lock:
- Android BiometricPrompt (Fingerprint / Face Unlock / Device PIN).
- iOS LocalAuthentication (Face ID / Touch ID).
- Modern Minimal Design System:
- High-contrast electric indigo & mint emerald theme.
- Strict 12-hour AM/PM time standard across all schedules and records.
- Accessible typography and tactile bouncy feedback components.
Security & Privacy
- Zero cloud tracking, analytics, or third-party telemetry.
- Strictly minimal permissions requested dynamically at runtime only when triggered by user action.
- 100% offline-first functionality across both mobile platforms.