Evershine Academy ERP & LMS
Multi-campus educational ERP & LMS featuring live biometric fingerprint integration, 7-role portals & automated finance engine.
Public admissions landing page with multi-campus programs, shifts, and direct LMS access
System Overview & Engineering Longevity
A comprehensive enterprise-grade educational ERP and learning management system engineered for multi-campus institutions operating across morning, evening, and night shifts. Built with Next.js 16 App Router, React 19, Prisma ORM, and MySQL, the platform integrates live hardware biometric fingerprint machines for automated attendance reconciliation, alongside mission-critical academic and financial operations: multi-step online admissions, automated monthly fee invoices with printable 3-part bank challans (jsPDF), penalty policy calculations, staff payroll ledgers, continuous student performance evaluation, and 7 distinct role-based portals (Super Admin, Campus Admin, Teacher, Accountant, Student, Parent, Guardian).
Key Engineering Highlights
Architected with clean domain separation, strict TypeScript contracts, and automated telemetry logging.
Hardware Integration
On-premise fingerprint machine attendance sync
Role-Based Portals
Super Admin, Admin, Teacher, Accountant, Student, Parent, Guardian
Shift Scheduling
Morning, Evening, and Night coaching
ACID Financial Safety
Atomic Prisma transactions for fee ledgers
Production Engines
Biometrics, ERP, HR, Exams, Promotions & Portals
Verified UI Flows
Interactive walkthrough across all key dashboards
End-to-End System Data Flow
How user inputs, computer vision pipelines, and transaction protocols flow across the stack.
Multi-Role Identity & Session Verification
User authenticates through NextAuth.js; Argon2id verifies credentials and issues campus-scoped session tokens with one of 7 RBAC roles.
Hardware Biometric Sync & Attendance Pipeline
On-premise fingerprint machine punch records are uploaded/synced, parsed row-by-row, and validated against enrolled shift rosters.
Campus & Shift Scoped API Gateways
Route handlers validate request payloads via Zod schemas and enforce campus isolation barriers before querying the database.
Prisma Transactional Ledger & Penalty Engine
Financial transactions (challan creation, fee receipts, penalty assessments, payroll entries) execute inside atomic Prisma transactions.
Client-Side Vector Document Rendering
Challans, ID cards, roll number slips, and result cards compile dynamically into print-ready vector PDFs using jsPDF/html2canvas.
Automated Scheduled Cron Routines
Hostinger cron triggers protected endpoints with CRON_SECRET to calculate late penalties, sync attendance, and dispatch email notices.
System Capabilities & 14+ Functional Modules
Hardware Biometric Fingerprint Integration & Log Sync
Direct integration with on-premise biometric fingerprint attendance machines deployed across academy branches. Ingests daily check-in and check-out punch logs for both students and teaching staff. Validates timestamps row-by-row, auto-associates punches with scheduled coaching shifts (Morning, Evening, Night), and flags unexcused absences or late arrivals automatically in the centralized database.
Penalty Policies & Automated Fine Assessment Engine
Automated disciplinary governance system enforcing institutional rules for unexcused absences, consecutive late entries, uniform infractions, and overdue tuition fee grace periods. Calculates daily and monthly fines dynamically, appending penalties directly onto student monthly fee challans or executing deductions on faculty payroll.
Faculty HR, Staff Payroll & Salary Slips Ledger
Comprehensive staff compensation suite supporting multi-tier compensation models: fixed base pay, coaching shift stipends, and hourly rates. Automatically reconciles payroll against biometric attendance logs and approved leaves, calculates net disbursements, and generates printable branded salary slips.
Academic Engine & Multi-Shift Scheduling
Engineered a multi-campus, multi-shift academic structure supporting Morning, Evening, and Night coaching sessions. Manages student batch enrollment (Shaheen, Parwaaz, Junoon), section allocations, subject offerings, teacher assignments, and classroom room capacity allocations.
Finance & Automated 3-Part Bank Fee Challan ERP
Automated financial billing pipeline that generates monthly fee invoices and printable 3-part bank fee challans (Student Copy, Bank Copy, Academy Copy) rendered via jsPDF and html2canvas. Handles partial payments, proof-of-payment image uploads, late fee penalty calculations, operational expense ledgers, and profit & loss statements.
Teacher Classroom Suite: Daily Scores & Targets
Comprehensive continuous evaluation suite for teaching faculty. Teachers record daily classroom participation, homework marks, and quiz scores. Tracks individual student target performance against monthly monitoring benchmarks and provides a fast grade entry portal with draft and declared result publication states.
Examination Engine, Date Sheets & Digital Roll No. Slips
Complete examination management system handling term examination schedules, room allocations, and invigilation rosters. Automatically compiles and renders printable digital roll number slips (hall tickets) with student photographs, seat numbers, and examination guidelines.
End-of-Term Student Promotion & Session Rollover
Automated student lifecycle transition engine evaluating cumulative academic scores, exam results, and attendance percentages against promotion criteria. Orchestrates batch student promotions to the next class grade, handles section reassignments, and initializes new academic sessions.
7-Tier Role-Based Access Control & Role Assumptions
A strict permission-based architecture isolating access across 7 user roles: Super Admin, Campus Admin, Teacher, Accountant, Student, Parent, and Guardian. Features campus-scoped data isolation and a specialized Super Admin role assumption tool for administrative troubleshooting.
Dual-Tier Attendance Telemetry & Daily Roster
Comprehensive attendance tracking for both student bodies and teaching faculties. Features one-click bulk status marking (Present, Absent, Late, Excused), shift-specific rosters, and automated monthly attendance percentage calculations feeding into student report cards.
Guardian Telemetry & Student Self-Service Portals
Dedicated portals for students and guardians. Guardians monitor linked child profiles, attendance percentages, exam schedules, and fee status. Students access active courses, submit elective choices, download roll number slips, and file leave requests.
Grievance Resolution Registry & Staff Leave Desk
Centralized institutional governance portal for filing formal concerns and evaluating staff leave requests. Provides administrative evaluation desks, instant applicant notification dispatch, and immutable audit logs.
Document Printing Vault: QR ID Cards & Certificates
Automated vector document generation engine compiling high-resolution student and teacher ID cards with dynamic scannable QR verification codes, official Bonafide Student Certificates, Character Certificates, and terminal Report Cards.
Public Admissions Pipeline & Lead Management
Public multi-step online student admission application workflow with program and shift selection. Implements CNIC / B-Form duplicate protection, document upload support via Cloudinary, and an administrative admission queue for screening and registration issuance.
Key Engineering Bottlenecks & Solutions
Hardware Biometric Fingerprint Synchronization & Shift Auto-Matching
Physical biometric machines generate raw timestamp punches without semantic awareness of student sections or staff shifts. Engineered a high-throughput parser and reconciliation pipeline that maps punch timestamps against scheduled class and coaching windows (Morning, Evening, Night), accounting for grace periods, unexcused absences, and half-day thresholds.
Multi-Campus Data Segregation Without Complex Multi-Database Overhead
Rather than spinning up disconnected databases per campus, engineered a unified Prisma relational schema enforcing campus-scoped compound foreign keys and middleware-level tenancy checks. This guarantees total data isolation while enabling Super Admins to view aggregated cross-campus financial and academic metrics.
Financial Consistency & High-Volume Fee Challan Generation
Generating monthly invoices across hundreds of students with differing fee packages, discounts, and previous balances risks data race conditions. Built an idempotent batch generation engine that operates inside sequential database transactions, generating unique Challan IDs (e.g. CHL/MBE_261018/2627/JUN) and preventing duplicate billing.
Pixel-Perfect Branded 3-Copy Bank Challans & Result Cards
Designed bespoke vector templates using jsPDF and html2canvas with exact print dimensions (A4 split into Student Copy, Bank Copy, and Academy Copy). Optimized rendering pipelines to eliminate font rasterization blur and ensure barcode/QR code scan reliability.
Autonomous Neural Copilot (JON OS)
Voice-activated autonomous AI copilot with Groq LLaMA 3.3 70B & Whisper Large v3.