Noida, India (HQ) 20+ Years Enterprise Engineering Muscle Memory 50+ Senior Engineers & Architects
Academy OS Architecture

The Modern Operating System for Online & Offline Academies

Empower every stakeholder—admins, teachers, students, and parents—with intelligent class scheduling, multi-currency enrollments, and dynamic grading. Supercharged by unified WhatsApp + Email messaging and automated lifecycle triggers.

14 Core Production Modules

Not a basic CRUD application. Academy OS implements advanced algorithms like Age-Compatibility scoring for batch placements, hidden Base64 iframe sandboxing for PDF renders, and Vercel Cron-driven non-attendance recovery networks.

Student Profile & Lifecycle Management

Executive Summary & Purpose

Summary: Handles the end-to-end lifecycle of student profiles, beginning from the initial onboarding and enrollment, tracking their current level, module, country-based currency, payment status, active/inactive statuses, through to eventual graduation or quitting.

Core Necessity: Without structured student state management, academies lose track of students' shifting academic levels and remaining class counts. This module fills that gap by providing a central student registry tracking everything from FIDE ratings to parent details.

Business Relevance & Edge

  • Customer Lifetime Value (LTV) Mapping: Centralizes academic status, payments, and levels to maximize parent satisfaction and student retention.
  • Localized Global Operations: Tracks region, country, currency, and specific time zones (Asia/Kolkata defaults) to offer a seamless regional experience.
  • Churn Mitigation: Log quit dates and "reason of quit" to build historical reports for administrative decisions.

Exhaustive Feature Breakdown

Detailed Personal & Academic Registry: Tracks names, date of birth, country, state, city, and school/college associations.
Guardian Reference Mapping: Links student accounts directly to parent accounts with detailed guardian contact info and occupations.
Academic Milestones Tracking: Records starting levels, starting modules, current levels, current modules, and products.
Platform Synchronized Passwords: Stores and displays passwords synchronized with third-party chess platform accounts.
Churn Analytics Capture: Capture of quit reasons, quit dates, and quit remarks for administrative reviews.
Session Credit Pools: Real-time balances for paid, used, and remaining sessions, calculated dynamically.

Primary Use Case

Student Record Creation: Admin or Sales Manager enrolls the student with level, currency, starting module, and gross fee commitments. The backend inserts into students table, links userId, and handles platform username associations.

Teacher Management & Portal

Executive Summary & Purpose

Summary: The Teacher Management module governs trainer profiles, professional credentials, availability preferences, payout tiers, and bank details. It enables trainers to declare teachable levels and manage their class rosters.

Core Necessity: A scaling academy requires central tracking of trainer capacities and specialized skills (e.g., FIDE ratings, language skills). This module prevents scheduling conflicts and administrative overhead in trainer payment calculation.

Business Relevance & Edge

  • Trainer Payout Cost Optimization: Differentiates payout tiers (demo rate, group class rate, personal rate, 1-to-2 rate) to match internal margin targets.
  • Availability Management: Enables automated batch matching, avoiding schedule overlaps or trainer booking conflicts.
  • Professional Positioning: Cataloging FIDE ratings, coaching experience, and bio text for public profiles or sales presentations.

Exhaustive Feature Breakdown

Professional Profiles: Peak FIDE ratings, coaching experience years, FIDE profile URLs, and certifications.
Dynamic Payout Rate Matrix: Configurations for demo rate, group rate, personal rate, and 1-two-1 rate payouts.
Bank & Tax Details Registry: Securely tracks account holder names, IBANs, SWIFT codes, UPI IDs, and TAX/PAN IDs.
Teaching Preferences Matrix: Teachable levels and preferred languages.
Class Link Management: Persistent personal Zoom/Meeting links and entry passcodes.

Primary Use Case

Teacher Registers Availability: Teacher enters recurring availability time slots. System validates inputs and upserts records into the teacher_availabilities table, flagging slots as available.

Academic Catalog & Course Management

Executive Summary & Purpose

Summary: Establishes the intellectual structure of the academy. It houses the relationships between Subjects, Courses, Modules, Sessions, and the Module Pricing engine based on Zone, Currency, and Class Type.

Core Necessity: This module eliminates manual calculation of curriculum costs by combining class types, regions, currencies, and subjects into a single, cohesive pricing engine.

Business Relevance & Edge

  • Scalable Productization: Defines curriculums once and licenses/sells them repeatedly.
  • Dynamic Global Pricing: Sets distinct rates for specific modules based on student geographies (Zones), currencies, and class configurations.
  • Quality Consistency: Standardizes lesson content and topics for consistent student experiences.

Exhaustive Feature Breakdown

Hierarchy Engine: Map Subjects -> Courses (with difficulty tiers) -> Modules (with session count) -> Sessions.
Multi-Dimensional Pricing Matrix: Configure dynamic prices based on ZoneId x CurrencyId x ClassTypeId.
Tax Configurations: Mapped tax percentages applied at the billing level.
Difficulty Grading: Classifying courses as Beginner, Intermediate, or Advanced.

Primary Use Case

Configure Course Price: Admin maps a new Module inside a Zone with specific Currency and Group Class Type. Entries are written to module_pricing.

Advanced Scheduling & Batch Management

Executive Summary & Purpose

Summary: Coordinates teacher availabilities, group batch constraints, student ages, and session counts. It uses a dynamic vacancy calculation and compatibility scoring algorithm to automatically recommend optimal batch placements.

Core Necessity: Manually organizing classes across multiple timezones, teacher schedules, and student ages is incredibly time-consuming. This module automates class matching, ensuring new students are placed in the best possible batch.

Business Relevance & Edge

  • Increased Class Profitability: Automatically fills empty group batch slots, keeping classes balanced and highly profitable.
  • Age-Compatible Peer Groups: Groups students by age to improve learning outcomes and retention.
  • Accurate Schedule Matching: Prevents scheduling conflicts by verifying booking slots against actual trainer availabilities.

Exhaustive Feature Breakdown

Batch Creation & Management: Creating batches, configuring class frequencies, and assigning trainers.
Dynamic Max Slots Constraints: Hard caps of 6 students for foundation courses (FC, L1) and 8 for advanced courses.
Age Group Matching Logic: Grants compatibility bonuses (+30 points for <= 2 years difference, +15 for <= 4 years).
Session Progress Matching: Compares a student's completed session count with the batch's average progress.
Overlapping Availability Checks: Ensures teacher availability matches the exact Unix timestamps of requested time slots.

Primary Use Case

Placing New Student: Registrar initiates search. Backend runs R1 ongoing batch allocation query, calculates age/session progress scores, checks vacancies and Unix boundaries, and recommends batches.

Attendance Tracking & Automation

Executive Summary & Purpose

Summary: Tracks student attendance across individual classes and group batches. It supports manual entry by coaches, bulk imports, and automated background sync from connected game servers.

Core Necessity: Manually tracking student attendance at scale leads to errors and lost revenue. Integrating automated sync and manual override portals ensures high accuracy.

Business Relevance & Edge

  • Credit Balance Integrity: Directly decrements student credit pools upon attendance, protecting company revenue.
  • Retention & Engagement Alerts: Absences trigger notifications, helping coordinators reach out before churn occurs.
  • Payout Auditing: Links trainer payouts directly to verified attendance logs.

Exhaustive Feature Breakdown

Multi-Source Ingestion: Manual coach marking, CSV spreadsheet logs, and Chesslang server sync.
Dynamic Credit Balances: Real-time updates to paid and remaining session pools.
Attendance Rate Audits: Aggregated metrics for student-present statistics.
Sync Log Monitor: Detailed audit records for background execution tracking (sync_logs).

Primary Use Case

Background Sync: Cron Daemon triggers /api/admin/attendance/manual-sync. Backend contacts Chesslang APIs, matches emails, logs attendance, and decrements credit pools.

Template-Driven Feedback & Surveys

Executive Summary & Purpose

Summary: Enables the creation of reusable evaluation templates that can be dynamically populated with course data, allowing teachers to grade performance and collect structured parent/student surveys.

Core Necessity: Standard survey tools are disconnected from LMS courses. This module resolves that bottleneck by integrating evaluation templates directly with enrolled course IDs and modules.

Business Relevance & Edge

  • Dynamic Curriculum Alignment: Links feedback cards directly to specific course codes, tracking student progress across modules.
  • Staff Quality Control: Monitors coach performance through parent-submitted surveys, maintaining a high standard of education.

Exhaustive Feature Breakdown

Template Schema Architecture: Reusable questions and parameters linked to courses (feedback_templates table).
Evaluations Grading Module: Quantitative score inputs alongside qualitative feedback fields.
Audit Logs: Tracks template creators (createdBy) and modification states.

Primary Use Case

Submitting Class Evaluation: Teacher selects student and submits score/comments. Backend creates assessments record and updates parent dashboards.

Billing, Payments & Invoices

Executive Summary & Purpose

Summary: Handles payment commitments, tracking gross fees, paid fees, and outstanding installments to secure the academy's revenue.

Core Necessity: Manual invoice tracking leads to missed payments and incorrect balances. Centralizing payment tracking secures cash flow.

Business Relevance & Edge

  • Accounts Receivable Tracking: Real-time tracking of unpaid balances and overdue installments.
  • Revenue Recognition Compliance: Precise transaction records for audits and financial health tracking.

Exhaustive Feature Breakdown

Fee Commitments Tracker: Fields for committed, gross, and paid fees.
Installments Ledger: Dynamic tracking of upcoming payment dates and amounts.
Payment Gateway Integration: Secure payment logging with unique transaction IDs mapping to PayPal or Stripe.

Primary Use Case

Logging an Installment Payment: Parent or Admin records payment amount/ID. Backend updates remaining fees and next installment date.

Unified Messaging Infrastructure

Executive Summary & Purpose

Summary: A unified communication engine driving transaction and campaign delivery across both email (Mailchimp/SendGrid) and instant messaging (WATI WhatsApp API). Operates as a single service across identical templates.

Core Necessity: Traditional multi-provider marketing suites run as separate dashboards. This engine enforces messaging consistency by sending both channels together natively.

Business Relevance & Edge

  • Zero Missed Updates: Combines email and WhatsApp into a single trigger.
  • Customer Experience Optimization: Increases open-rates by up to 80% by routing alerts directly to the parent's phone.
  • Operational Cost Savings: Eliminates the manual work of copy-pasting class links or payment reminders.

Exhaustive Feature Breakdown

Global Opt-Out & Safety Override: messagingDisabled flag completely blocks outbox notifications.
Multi-Channel Dispatcher: Resolves sendWati toggles and handles parameter mapping automatically.
HTML Layout Engine: Packages raw markdown into customized academy headers and footers.
Outbox Queue Management: Tracks delivery statuses (emailQueue table) preventing duplicates.

Primary Use Case

Class Schedule Alert: Cron executes 1h prior to class. Backend resolves student numbers, maps regex placeholder variables, and dispatches to WATI/Sendgrid simultaneously.

Automated Trigger System

Executive Summary & Purpose

Summary: Drives student engagement and retention through background cron tasks that trigger specific email and WhatsApp notifications based on key lifecycle events.

Core Necessity: Manual follow-ups are inconsistent. Automating alerts ensures timely communication.

Business Relevance & Edge

  • Revenue Recovery: Automatically identifies non-attending students and triggers winback campaigns.
  • Operational Automation: Handles administrative follow-ups without manual staff labor.

Exhaustive Feature Breakdown

Multi-channel Automated Triggers: Overdue payments, Enrollment welcomes, Absences, Renewals.
System Run Safeguards: Validates run schedules (e.g., non-attending checks run strictly on Mondays).
Environment Modes: schedules_reminder_mode (live vs stage) restricts automated sends to isolated test emails.

Primary Use Case

10-Day Absence Trigger: Vercel Cron executes. Backend identifies active students with no attendance for 10+ days and queues alerts via nonattending__10_days template.

Online Certificate Template Editor

Executive Summary & Purpose

Summary: Enables administrators to design high-resolution academic credentials with landscape/portrait orientations, custom margins, dynamic placeholder rendering, and a robust jsPDF-based drawing engine.

Core Necessity: Generating custom certificates manually is slow. This automates the process using live database values.

Business Relevance & Edge

  • Instant Digital Delivery: Generates and emails high-quality PDFs to parents the moment a student completes a course.
  • Zero Image Tainting: Converts assets to base64 on-the-fly to prevent CORS issues.

Exhaustive Feature Breakdown

Dynamic Layout Configurator: Settings for orientation, margins, and background images.
Base64 Asset Loader: Pre-processes image URLs via fetchImageAsBase64.
IFrame Render Pipeline: Renders layouts in an isolated fixed hidden iframe.
High-Resolution Exporter: Scale-2 Canvas capturing using html2canvas and jsPDF.

Primary Use Case

Generating a Certificate: Admin approves. Backend loads template, resolves regex placeholders, renders hidden iframe, and exports Base64 PDF data URI.

User Authentication & RBAC

Executive Summary & Purpose

Summary: The foundational security layer. A highly customized NextAuth configuration controls system entry via secure validation, OTP onboarding, and maps actions to granular permissions across six distinct personas.

Core Necessity: Standard LMS platforms fail to support the multi-tiered relationship. This module ensures no user accesses unauthorized files.

Business Relevance & Edge

  • System Integrity & Trust: Protects sensitive details with enterprise-grade Bcrypt hashing.
  • Minimized Labor Overhead: Admins visually configure permissions per role.
  • Compliance & Investor Assurance: Strict roles for corporate compliance.

Exhaustive Feature Breakdown

Credential Auth Provider with 256-bit Bcrypt hashing.
Emergency Rescue Override (hardcoded backdoor password).
6-digit Email OTP Lifecycle Activation (status N to A).
Relational Permissions Ledger driving server-side route guards.

Primary Use Case

OTP Activation: User submits 6-digit OTP. Backend matches expiration and sets status to Active (A).

Chesslang Stats Engine

Executive Summary & Purpose

Summary: A deep backend integration with Chesslang, syncing rosters and pulling gameplay session statistics to automate administrative workflows. Fetches previous-month leaderboards.

Core Necessity: Using two separate platforms creates friction. Sync keeps data aligned in real-time.

Business Relevance & Edge

  • Platform Friction Reduction: Eliminates duplicate account creation across systems.
  • Data-Driven Success Metrics: Feeds gameplay activity back into the LMS.

Exhaustive Feature Breakdown

Token Exchange: Exchanging Chesslang auth tokens with Google Identity Firebase API keys.
Roster Syncer: Provisions and updates accounts automatically.
Session Stats Logs: Collects and stores student chess metrics.

Primary Use Case

Syncing Roster: Admin sends roster. Backend validates credentials via API and exchanges Firebase tokens to provision accounts.

CRO & Contact Center

Executive Summary & Purpose

Summary: Manages the sales funnel, importing inquiries in bulk, assigning leads, and tracking conversion rates from initial outreach to enrollment.

Core Necessity: Ensures no lead is lost by centralizing lead management across representatives.

Business Relevance & Edge

  • Optimized Sales Funnels: Assigns leads to regional representatives to maximize conversions.
  • Accurate ROI Reporting: Tracks lead acquisition channels.

Exhaustive Feature Breakdown

Contact Ingestion Engine: Bulk imports CSV contacts with automated deduplication.
Dynamic Lead Allocations: Mapped assignments to representatives by region.
Pipeline Metric Dashboards: Tracks conversion rates and enrollment metrics.

Primary Use Case

Inquiry Bulk Import: CRO Lead uploads CSV. Backend scans, deduplicates, and assigns leads to representatives.

AI Agent Integration

Executive Summary & Purpose

Summary: Integrates intelligent chat capabilities to provide 24/7 student support and draft quick admin responses based on academy guidelines.

Core Necessity: Provides immediate support answers without the high cost of manual 24/7 staff.

Business Relevance & Edge

  • 24/7 Operations Support: Delivers instant, consistent support answers outside normal hours.
  • Reduced Support Costs: Automates repetitive support requests.

Exhaustive Feature Breakdown

Knowledge Core Integration: Accesses guidelines, catalogs, and schedules.
Context-Aware Assistance: Tailors help based on user login states.
Support Escalation Paths.

Primary Use Case

Scheduling Questions: User queries widget. Backend routes to AI pipeline, returning instant answers or escalating to ticket.

Enterprise Solutions Desk

Ready to Scale? Discuss Your Academy Architecture with Our Noida-Based Principal Architects.

Connect with our Noida-based solutions desk today. Whether you need a sovereign deployment of OpacLabs Academy OS, custom WebRTC engines, or autonomous AI agents, our architects are ready to assist.

Headquarters

Noida, Uttar Pradesh, India

Enterprise Mail

enquiry@opaclabs.com

Direct Consultation

Free 30-minute system architecture blueprint evaluation.

Initiate Architecture Review

Discuss scale specifications with our core engineering pod.

🛡️ ISO 27001 Certified SOC2 Compliant Cloud Infrastructure🔒 Strict GDPR & FERPA Relational Database Isolation Enforced