v1.1.0: Student Exit Tracking & Alumni Management

TutorHQ v1.1.0: Student Exit Tracking & Safe Discontinuation Release

This update introduces comprehensive Student Exit Tracking, Alumni Management, and Zero-Data-Loss Discontinuation Workflows across both Android and iOS.

🎓 What's New in v1.1.0

1. Student Departure & Exit Date Tracking

• Explicit Exit Dates: Accurately records leaving date (leavingDateEpoch) and structured leaving reason (leavingReason).
• Structured Departure Taxonomy: Select from predefined reasons:
  • Course / Syllabus Completed
  • School / Board Exams
  • Relocated / Moved Away
  • Schedule / Timing Conflict
  • Personal / Family Reason
  • Financial / Fee Consideration
  • Discontinued / Other (with custom note support)

2. Safe 'Mark as Left' Workflow (Zero-Data-Loss Archive)

• Zero Data Loss Guarantee: Discontinuation preserves 100% of historical transactions, fee ledgers, payment receipts, attendance rolls, and exam marks without destructive SQLite cascading deletions.
• Outstanding Dues & Fee Clearance Warnings: Automatically calculates and alerts tutors to any pending balance before marking a student as departed.
• Attendance & Dues Isolation: Left students are automatically excluded from daily attendance roll calls and future monthly fee due generation.

3. Alumni Roster & 1-Tap Re-Admission

• Status Filter Chips: Seamlessly switch between Active, Alumni / Left, and All views with live count badges.
• Discontinued Profile Banners: Prominently displays departure date and reason on student profiles.
• 1-Tap Re-Admission: Re-admit returning students instantly, assign them to an active batch, and resume tracking without re-entering student details.

4. Safe Forward Database Migration (Room v5)

• Versioned forward migrations (MIGRATION_4_5, MIGRATION_3_5, MIGRATION_2_5, MIGRATION_1_5) ensure existing student records remain 100% intact upon update.
• Universal JSON backup and restore schema upgraded to preserve exit data across Android and iOS exports.

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.
• Cross-Platform Barcode & QR Auto-Attendance:
  • Android: CameraX viewfinder with Google ML Kit Barcode Scanning.
  • iOS: Native AVFoundation (AVCaptureMetadataOutput) and CoreImage CIQRCodeGenerator.
  • 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 & Android HapticFeedbackType).
• 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 DataRecoveryManager restoring legacy databases automatically on startup.
  • android:hasFragileUserData="true" protection.
• 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.