NexusOne LMS — Feature Guide
Every feature in the platform, organized by module. Use the sidebar to jump to a section.
Platform Overview
What is NexusOne LMS?
NexusOne is a full-stack Learning Management System built for schools and educational institutions. It supports multiple user roles, real-time communication, AI-powered insights, and full school operations management — all in one platform.
User Roles
Platform Admin
SaaS operator — manages all schools and subscriptions
Super Admin
School-group oversight across assigned schools
Admin / Principal
School-level management and configuration
Teacher
Course delivery, assignments, and student assessment
Student
Learning, quizzes, fees, and self-service
Parent
Monitor child progress, fees, transport, and timetable
Accountant
Fee structures, payments, and financial reports
Facilities Admin
Assets, maintenance, and transport oversight
Librarian
Book and library resource management
Driver
Runs bus trips, marks pickups/dropoffs, triggers SOS
Tech Stack
Frontend
Next.js 14 (App Router), Tailwind CSS, Socket.IO Client, Lucide Icons
Backend
Node.js, Express, MongoDB (Mongoose), Socket.IO, Cloudinary, Judge0
AI / Integrations
Google Gemini API, Resend (email), DodoPay (payments), Web Push
Infrastructure
Nixpacks deployment, Redis-compatible caching, JWT auth
Business Architecture & Multi-Tenant Model
Platform AdminSuper AdminAdminChapter 2 — Platform hierarchy, NexusOne ID, campus & academic year management
Chapter 2 defines the foundational architecture of NexusOne. A single platform instance serves multiple schools (tenants) with strict logical data isolation. Every entity — from Platform down to Student — lives in a 7-level hierarchy. The NexusOne ID gives every user a permanent, globally unique identity that follows them across school transfers and role changes.
Platform Hierarchy
NexusOne ID (Chapter 2.15)
Format: NX-000000001
Globally unique, never reused, never editable. Auto-assigned on user creation. Valid for students, parents, teachers, staff, and alumni.
- Follows the person across school transfers and role changes
- Sequential counter stored in MongoDB — thread-safe via atomic increment
- Alumni retain their NexusOne ID permanently after graduation
User Roles (Chapter 2.17)
All supported roles in the platform:
Alumni role: former students who retain their NexusOne ID and limited platform access post-graduation.
School Board Types (Chapter 2.8)
Schools specify their academic board during registration:
Audit Trail (Chapter 2.27)
Every admin action is logged with full context for compliance:
- actor — who performed the action
- action — what was done (campus.create, year.activate, etc.)
- oldValue / newValue — state before and after the change
- ip — IP address of the request
- createdAt — timestamp (indexed for fast range queries)
Campus Management (New in Chapter 2)
Admins can manage multiple physical locations for a single school. One campus can be designated as the Main campus.
Frontend
Admin Dashboard → Campus Management (/dashboard/admin/campus)
Mobile
Admin App → Campuses screen with create/edit/deactivate flow
/api/campusesList campuses for current school/api/campusesCreate campus (Admin+)/api/campuses/:idUpdate campus/api/campuses/:idDeactivate campusAcademic Year Management (New in Chapter 2)
Each school manages its own academic years with configurable terms (e.g. Term 1, Term 2). Only one year can be active at a time.
/api/academic-yearsList all academic years/api/academic-years/activeGet current active year/api/academic-yearsCreate academic year/api/academic-years/:id/activateSet as active year (closes current)Multi-Tenant Data Isolation
Isolation Rule
Every MongoDB document carries a school (ObjectId) field. All queries are automatically scoped via getSchoolFilter(req) middleware. School A can never access School B data.
- Subscription check middleware enforces active trial or paid plan
- School verification status checked on every protected request
- Platform Admin is the only role with cross-tenant visibility
Subscription Model
Monthly
Short-cycle billing
Quarterly
3-month billing
Yearly
Annual billing (default ₹7,999)
- 90-day free trial on activation
- Payment via Dodo Payments (webhook-driven)
- Mobile: Admin can view subscription status at any time
Authentication & User Management
All RolesLogin, roles, and user accounts
NexusOne uses JWT-based authentication with role-scoped dashboards. Admins can create user accounts with temporary passwords delivered via email. Password reset is supported via email tokens.
Capabilities
- Email + password login with role-based dashboard routing
- Admin creates users (teacher, student, librarian, etc.) with auto-generated credentials
- Forgot password → email token → reset password flow
- School registration portal for new schools to onboard themselves
- Admin can resend login credentials to any user
- User profile page with editable personal details
Key Routes
/api/auth/loginAuthenticate and receive JWT/api/auth/registerRegister a new school/api/auth/meGet current user/api/auth/forgot-passwordSend reset email/api/auth/reset-passwordReset with token/api/admin/usersAdmin creates a userCourse Management
AdminTeacherStudentCreate, manage, and deliver courses
Teachers and admins can create structured courses with modules, materials (PDFs, videos, links), and live sessions. Students browse, enroll, and track their progress through an interactive learning interface.
For Teachers / Admins
- Create courses with title, description, category, modules, and materials
- Upload PDFs, videos, and external links as course materials (Cloudinary)
- Manage enrolled students per course
- Lesson plan creation per course
- Session scheduling and live session monitoring
- Course completion dashboard with per-student progress
For Students
- Browse and self-enroll in available courses
- Interactive learn view with module navigation and material access
- Course progress tracking and completion percentage
- Drop from course
Attendance Tracking
TeacherAdminStudentClass-level attendance management
Teachers mark attendance per course per day. Students can self-mark presence for enabled courses. Full attendance history, calendar view, and bulk marking are supported.
Capabilities
- Mark attendance per student (present / absent / late / excused)
- Bulk attendance marking for a whole class at once
- Calendar view showing per-date attendance status
- Students self-mark attendance (teacher-controlled per course)
- Parent can view their child's attendance records
- AI Insight: attendance anomaly detection and trend analysis
Quiz & Assessment
TeacherAdminStudentQuestion bank, quizzes, grading, and results
Teachers build a question bank and assemble timed quizzes. Students take quizzes with auto-grading. Teachers can manually grade open-ended questions. Results include per-question analysis and pass/fail outcomes.
Question Bank
- Create questions: MCQ (single/multiple), True/False, Short Answer, Long Answer, Fill-in-the-blank
- Bulk import questions via CSV / Excel
- Tag questions by subject, difficulty, and topic
Quiz Engine
- Timed quizzes with configurable duration
- Question randomization and option shuffling
- Auto-save and resume in-progress attempts
- Auto-submit on time expiry
- Automatic grading for objective questions; manual grading for subjective ones
- Per-question result breakdown with correct answers shown after submission
- AI-powered essay grader for long-answer questions
Programming Lab
TeacherStudentIn-browser code editor with test execution
Teachers create programming problems with hidden test cases. Students solve them in a browser-based code editor. Submissions are run against test cases via Judge0 with real-time pass/fail feedback.
For Teachers
- Create problems with statement, constraints, input/output examples
- Add hidden test cases with expected outputs
- View all student submissions and their verdicts
For Students
- Monaco-based in-browser code editor
- Multi-language support (Python, JavaScript, Java, C++, etc.) via Judge0
- Run code against sample inputs before final submission
- Submission history with per-test-case pass/fail breakdown
Library Management
LibrarianAdminTeacherStudentBooks, transactions, reservations, and RFID
A full-featured library system with book catalog management, issue/return transactions, reservations, overdue tracking, RFID integration, and book reviews.
Capabilities
- Book catalog with cover images (Cloudinary), ISBN, author, category, and quantity
- Issue and return transactions with due date tracking
- Book reservations queue
- Overdue books report and automated reminders
- RFID-based book check-in / check-out
- Student book reviews and ratings
- Library reports: transaction history, popular books, utilization stats
Messaging
TeacherStudentAdminParentReal-time chat between users
Real-time one-to-one and course-scoped messaging powered by Socket.IO. Teachers can message individual students or all students in a course. Parents can message teachers.
Capabilities
- Real-time one-to-one chat with delivery via Socket.IO
- Course-scoped conversations: teachers contact any enrolled student
- Conversation list with unread message counts
- Parent ↔ Teacher messaging for child-related communication
Notifications
All RolesIn-app and push notifications
NexusOne delivers real-time in-app notifications via Socket.IO and optional Web Push notifications for offline delivery. Admins can send announcements to all school users.
Capabilities
- Bell icon with unread count updated in real time
- Notifications for: new messages, quiz results, enrollment, fee reminders, notices
- Web Push subscriptions for offline/background delivery
- Mark as read individually or all at once
Academic Calendar
AdminTeacherStudentSchool events and scheduling
Admins manage the school academic calendar with events (holidays, exams, parent meetings). Students and teachers can view upcoming events from their dashboards.
Capabilities
- Create calendar events with title, date range, type, and description
- Event types: holiday, exam, meeting, event, deadline
- Monthly calendar view with color-coded event types
- Upcoming events widget on dashboards
Notices & Announcements
AdminTeacherStudentParentSchool-wide notice board
Admins and teachers post notices to the school notice board. Students and parents see relevant announcements from their dashboards. Notices support priority levels and target audiences.
Capabilities
- Create notices with title, content, priority (normal / urgent / critical), and expiry date
- Target audiences: all, students only, teachers only, parents
- Notices automatically expire and hide after their end date
- Notification triggered on new notice creation
Admission Management
AdminLead tracking and application pipeline
Track prospective student leads from inquiry through application to enrollment. The public admission inquiry form collects interest, and applications are managed through a status-driven pipeline.
Pipeline Stages
Capabilities
- Public admission inquiry page (school-specific URL)
- Application form with document uploads
- Lead CRM with notes, follow-up dates, and status history
- Admission analytics dashboard (conversion rates, source tracking)
Student Management
AdminTeacherEnrollment, progress, and engagement
Admins manage student accounts and link them to parent accounts. Teachers enroll students into courses individually or in bulk. Student engagement scores are tracked automatically.
Capabilities
- Enroll students in courses individually or via bulk upload
- Link student accounts to parent accounts
- Engagement score tracking (login frequency, quiz completion, attendance rate)
- Student progress view: courses, quiz scores, attendance summary
- AI-generated student insight reports
Certificates
AdminTeacherStudentAuto-generated course completion certificates
Upon course completion, the system generates a downloadable certificate for the student. Teachers can also manually issue certificates. Students can view and download all earned certificates.
Capabilities
- Auto-generated certificate on course completion
- Teacher-issued manual certificates
- Downloadable PDF certificates
- Certificate list view for students
Fee Reminders
AdminStudentFee notifications and payment reminders
Admins create fee reminders for individual students or in bulk for an entire class. Reminders include due dates, amounts, and are delivered via in-app notifications and email.
Capabilities
- Create fee reminders with amount, due date, description, and fee type
- Bulk create reminders for all students in a course or batch
- Students see pending fee reminders in their dashboard
- Status tracking: pending → paid → overdue
Asset Management
AdminSchool asset tracking and depreciation
Track school physical assets (computers, furniture, equipment) with purchase details, assigned users, maintenance history, and automatic depreciation calculation.
Capabilities
- Create asset records with name, category, purchase date, cost, and location
- Assign assets to users or rooms
- Automatic depreciation calculation (straight-line / declining balance)
- Asset status tracking: active, in-repair, retired
Maintenance Management
AdminTeacherMaintenance tickets and schedules
Report and track facility maintenance issues. Admins schedule preventive maintenance. Teachers can file maintenance tickets. Admins assign and resolve tickets.
Capabilities
- Submit maintenance tickets with issue type, priority, location, and photos
- Admin assigns tickets and updates status (open → in-progress → resolved)
- Preventive maintenance schedules with recurring intervals
- Maintenance history per asset
Procurement
AdminTeacherPurchase requests, orders, and vendor management
Teachers submit purchase requests that go through an admin approval workflow. Approved requests become purchase orders sent to registered vendors.
Workflow
Capabilities
- Vendor catalog with contact details, category, and rating
- Purchase request form with line items, justification, and urgency
- Admin approval / rejection with comments
- Generate purchase orders from approved requests
AI Features
AdminTeacherStudentAI-powered insights, content generation, and grading
Powered by Google Gemini, NexusOne includes AI-generated student insight reports, lesson content generation, essay auto-grading, and a classroom AI assistant for answering questions.
AI Capabilities
- Student Insights: AI-generated performance summaries, risk flags, and recommendations per student
- Lesson Content: Generate lesson plans, content outlines, and teaching materials from a topic prompt
- Essay Grader: AI grades student essays with rubric-based scoring and written feedback
- Classroom AI: Chat interface for teachers to query student data and get AI-driven analysis
- Learning Roadmap: AI-generated personalized study roadmap for students based on their progress
- Session Signals: IoT/edge device signals ingested for classroom AI (engagement, attention scoring)
GDPR & Privacy
AdminStudentParentData consent, rights, and compliance
NexusOne includes full GDPR compliance tooling: data processing consent tracking, parental consent for minors, data export, and right-to-erasure requests.
Capabilities
- Consent collection and tracking per user per data purpose
- Parental consent flow: email-based consent for minor students
- User data rights portal: view, export, and request deletion of personal data
- GDPR compliance dashboard for admins with consent status overview
- Hardware / IoT device consent for AI session signal collection
School Branding
AdminCustomize your school's look and feel
Each school can upload a logo, set a primary color scheme, and add a custom school name that appears throughout their instance of the LMS.
Capabilities
- Upload school logo (shown in sidebar and emails)
- Set primary brand color applied across the dashboard UI
- School name and tagline customization
- Branding applied to certificate templates and email layouts
Subscription & Billing
AdminSuper AdminSchool subscription plans and payments
Schools subscribe to NexusOne via DodoPay. Plans include a free trial period. Subscription status gates access to features across the school. Super Admins manage plans platform-wide.
Capabilities
- Free trial with configurable duration
- DodoPay payment integration for subscription purchase
- Access restriction when subscription is expired or inactive
- Subscription management page (upgrade, cancel, billing history)
Super Admin
Super AdminMulti-school platform management
The Super Admin role oversees all schools on the platform. They can create schools, assign school admins, verify school registrations, view platform analytics, and broadcast announcements.
Capabilities
- Create and manage school records and subscription statuses
- Assign and manage school admin accounts
- Review and verify new school registrations
- Platform-wide analytics: total schools, users, revenue
- Broadcast announcements to all school admins
Parent Portal
ParentMonitor your child's school life
Parents linked to a student account can view their child's attendance records, read school notices, and message teachers — all from a dedicated parent dashboard.
Capabilities
- View child's attendance across all courses
- Read school notices and announcements
- Message teachers directly via in-app chat
- GDPR parental consent management
Course Discussions
TeacherStudentThreaded discussions per course
Each course has a dedicated discussion board where students and teachers can start threads, reply, and collaborate asynchronously on course topics.
Capabilities
- Create new discussion threads with title and content
- Reply threads with nested comments
- Scoped per course — only enrolled users can participate
- Available to both teacher and student roles
Role Management
Platform AdminSuper AdminAdminMulti-tier roles with top-down permission inheritance
NexusOne uses a top-down role hierarchy. Platform Admin manages the entire platform and creates schools. Super Admin manages one or more schools. School-level admin inherits all permissions of accountant, librarian, facilities_admin, and teacher — so admin can step in for any absent staff member.
Role Hierarchy
Platform Admin
Creates schools, manages super admins — no school-level context
Super Admin
Manages one or more schools; can grant multi-school access to any role
Admin / Principal
Full school access — inherits accountant, librarian, facilities_admin, teacher permissions
Teacher
Courses, sessions, attendance, quizzes, assignments, grade entry
Accountant
Fee management, purchase orders, financial reports
Facilities Admin
Assets, maintenance, devices, procurement
Librarian
Library catalogue, issue/return, overdue tracking
Chat Monitoring
AdminPrincipalAdmin oversight of teacher–parent conversations
Admins can silently monitor any teacher–parent conversation in real time to ensure appropriate communication. A non-dismissible banner is shown to the teacher only — the parent is never informed. Admins can flag or mute conversations.
Capabilities
- Admin joins a conversation as a silent read-only monitor
- Teacher sees a persistent "This conversation is being monitored" banner
- Parent is never notified of monitoring activity
- Admin can flag a conversation with a reason for later review
- Admin can mute a conversation to pause all messaging
- Real-time updates via Socket.IO — monitoring starts instantly
WhatsApp Integration
ParentFull LMS access for parents via WhatsApp
Parents without email can access all school features through WhatsApp. Powered by SendZen, parents choose a preferred language on first contact, then send 'hi' to receive a 9-option interactive menu covering notices, fees, attendance, progress reports, AI engagement reports, teacher messaging, consents, and timetable — fully self-service, no portal login needed. Notices, fee reminders, and consent requests are proactively pushed. Email parents can use both the portal and WhatsApp simultaneously.
Interactive Menu (send 'hi' to activate)
Proactive Pushes
- New school notice → WhatsApp message to all opted-in parents
- Fee due / overdue → WhatsApp reminder with payment link
- Consent request → WhatsApp message with Approve / Deny buttons
- Teacher messages bridged to WhatsApp; parent replies return to teacher chat
- Magic links for phone-only parents — 7-day no-login portal access
Mobile App
All RolesReact Native app for Android and iOS
A React Native (Expo) mobile app for all 9 roles. Available on Android and iOS from a single codebase. Features FCM push notifications, biometric login (Face ID / fingerprint), offline caching, and real-time Socket.IO events — the same backend, no separate API layer.
Key Features
- Dedicated screen set per role — student, parent, teacher, admin, accountant, librarian, facilities admin, super admin, platform admin
- FCM push notifications for all roles — replaces web push on mobile
- Biometric login — Face ID and fingerprint via Expo SecureStore
- Child switcher for parents with multiple children enrolled
- Offline cache for home, courses, attendance, and notices
- School switcher for super admins managing multiple schools
Security
Platform14-domain security architecture
NexusOne is built with a 14-domain security model: school isolation on all MongoDB queries, JWT revocation via JTI blacklist, rate limiting per endpoint type, NoSQL injection protection, Helmet.js security headers, CORS origin allowlist, HTTPS enforcement, magic bytes file validation, and structured audit logging.
Security Domains
Assignments & Homework
TeacherStudentParentTeacher-assigned tasks with submission and grading
Teachers create assignments linked to a course with a due date, allowed file types, and mark allocation. Students submit files or text responses. Teachers grade and return feedback. Parents are notified when a grade is posted.
Workflow
Capabilities
- File upload (PDF, DOC, images, ZIP) or text response submissions
- Draft → published → closed status lifecycle
- Late submission tracking with configurable allow / deny per assignment
- Marks, letter grade, and written feedback per submission
- 24-hour due date reminder push to students who haven't submitted
- Parent notified when child's submission is graded
Grade Book & Report Cards
AdminTeacherStudentParentExam marks, computed grades, and PDF report cards
Admins create exam schedules per course (unit tests, mid-terms, finals, practicals). Teachers bulk-enter marks per student. The system computes letter grades using configurable thresholds and generates term-wise report cards with class rank, attendance summary, subject-wise breakdown, and principal remarks. Students and parents can download PDF report cards.
Exam Types
Capabilities
- Bulk marks entry — all students for an exam in a single table
- Configurable grade thresholds (A+/A/B/C/D/F) per exam
- Term report card with subject breakdown, attendance %, and class rank
- Principal adds remarks before publishing to students and parents
- PDF download for students and parents (school logo and branding applied)
Timetable Management
AdminTeacherStudentParentWeekly class schedule with conflict detection
Admins build a weekly period-by-period timetable assigning subjects, teachers, and rooms to each slot for every class. The system detects teacher double-booking and room conflicts before saving. Students see their class schedule, teachers see their teaching schedule, and parents see their child's timetable.
Slot Types
Capabilities
- Weekly grid builder — assign subject, teacher, and room per period per day
- Conflict detection — warns if a teacher or room is double-booked
- Bulk slot upload for the entire week at once
- Daily 7 AM push notification with the day's first period for students and teachers
- Parents view child's timetable via mobile app and WhatsApp menu
Fee Management
AdminAccountantStudentParentFee structures, student accounts, and receipts
Full school fee lifecycle: create fee structures with multiple heads and due dates, bulk-assign to students by class, record cash/cheque/bank/online payments, auto-generate sequential PDF receipts, and view collection reports and defaulter lists. Integrates with DodoPayments for online collection.
Workflow
Capabilities
- Fee structures with multiple heads (tuition, lab, transport) and individual due dates
- Bulk assignment to all students in a class or section
- Payment methods: cash, cheque, bank transfer, online (DodoPayments)
- Auto-generated sequential receipt numbers and PDF receipts
- Fee waiver, scholarship, and percentage/fixed discount, each recorded on a per-account adjustment ledger
- Reconciliation queue to manually or automatically match unrecognized transactions to a student account
- Refund workflow: parent request → admin approval → accountant processing, with automatic ledger update
- Bulk outstanding-balance reminders via WhatsApp and email, with delivery tracking
- Optional late fee rules (fixed, percentage, or daily) applied automatically to overdue accounts
- Collection summary, class-wise report, defaulter list, and collection-rate / grade-wise / payment-method analytics
- Mobile screens for parents, students, and accountants to view balances, pay online, and record payments
Online Payments
ParentStudentDodoPayments gateway for school fee collection
Parents and students pay school fees online via DodoPayments. The backend creates a payment order, redirects to DodoPayments checkout, and processes the webhook to automatically update the student's fee account and send a receipt — no manual intervention required.
Payment Flow
Capabilities
- Pay from web portal or mobile app (in-app browser on mobile)
- Webhook signature verification — payment truth sourced from DodoPayments, not the redirect
- Idempotent webhook handling — duplicate webhooks never double-charge
- Receipt auto-generated and sent via push notification and WhatsApp
- Payment history with transaction IDs and downloadable receipts
Transportation
AdminDriverParentStudentReal-time school bus tracking and fleet management
End-to-end school transport management: admins configure buses and routes, assign students to stops, and monitor live trips. Drivers use a mobile-optimised interface to start trips, mark pickups and dropoffs, and trigger SOS alerts. Parents see live bus location and their child's boarding status in real time via Socket.IO.
Core Concepts
Bus
Vehicle record — registration, capacity, assigned driver, insurance/fitness expiry
Route
Named route with ordered stops (GPS coords, ETAs, geofence radius per stop)
Student Assignment
Links a student to a route with pickup and dropoff stops per academic year
Driver Trip
One trip instance — morning or afternoon, with live location and SOS state
Trip Event
Audit log of every pickup, dropoff, absent mark, and location ping
Driver App Flow
Real-Time Socket Events
transport:location— driver location broadcast to school room and tracking parents every updatetransport:student-status— pickup/dropoff/absent event pushed to parent tracking the childtransport:sos— SOS alert broadcast to entire school room for immediate admin response
API Endpoints
/api/transport/busesList all school buses/api/transport/busesCreate bus/api/transport/routesList routes/api/transport/routesCreate route with stops/api/transport/assignmentsAssign student to route/stop/api/transport/liveAll in-progress trips (admin)/api/transport/trips/:id/manifestStudent pickup manifest for a trip/api/transport/driver/trips/:id/startDriver starts trip/api/transport/driver/trips/:id/locationDriver location ping/api/transport/driver/trips/:id/mark-studentPickup / dropoff / absent/api/transport/driver/trips/:id/sosSOS trigger/api/transport/parent/child/:id/liveParent: live trip status for childProduct Specification Chapters
25-chapter deep-dive specification covering every module — functional requirements, data models, API endpoints, and mobile screens.