School Manager

A role-based school management system with Admin, Teacher, Staff, Accountant, and Student access.

Open Test Accounts

This version automatically creates demo accounts and demo ERP data when the backend starts. These records are for testing only.

Role	Email	Password	Purpose
Admin	admin@school.test	test1234	Full control over users, students, employees, fees, salaries, settings, and reports
Teacher	teacher@school.test	test1234	Student academic access, routines, marks, and results
Accountant	accountant@school.test	test1234	Finance access for fees, payments, salaries, and increments
Accounts	accounts@school.test	test1234	Alternative finance role for accounts department testing
Staff	staff@school.test	test1234	Staff/self-service access testing
Employee	employee@school.test	test1234	Employee self-service access testing
Student	student@school.test	test1234	Student portal access testing
Audit	audit@school.test	test1234	Audit/read-role testing

The login page also shows one-click demo login buttons. To disable demo accounts or demo data in production, set:

ENABLE_DEMO_ACCOUNTS=false
ENABLE_DEMO_DATA=false

Main Features

• Collapsible Admin Console: one-click minimize/expand sidebar.
• Minimized sidebar shows role icons for Admin, Teacher, Staff, Accountant, and Student.
• Expanded sidebar shows full navigation text with icons.
• Admin can add, edit, update, and delete students and employees.
• Teacher can add students and edit the details of any student.
• Teacher can access students by class, view due payments, and view marks.
• Admin can mark selected teachers as class teachers and assign them to one class.
• Class teachers can access only students, payments, marks, and result cards for their assigned class.
• Accounts officers and class teachers can search payment records by student ID/roll.
• Teacher can create, update, and delete class routines.
• Teacher can enter, update, and delete subject-wise marks for monthly exams, semester exams, and class tests.
• Accountant/Admin can manage class fee rules, payment records, salary ledgers, and salary increments.
• Teacher/employee users can view only their own salary and increment records when their profile email/name matches the employee record.
• Student users can view only their own profile, marks, results, and payment records when their profile email/name matches the student record.
• Total marks and contribution percentage are entered by the teacher.
• Salary ledger and salary increment history are available.
• Student profile includes personal details, due payments, subject-wise marks, highest marks, class position, and final result summaries.
• Outfit font and interactive modern colors are used in the UI.

Applied Business Logic

Role Rules

• Admin: full control over students, employees, class fees, payments, marks, routines, salaries, and increments.
• Public registration creates student accounts only. Admin users create privileged staff, teacher, accounts, accountant, audit, and admin accounts.
• Class Teacher: academic control for one assigned class only. Class teachers can add/edit students, record class payments, manage marks, result cards, and routines only for their assigned class.
• Subject/Non-class Teacher: limited to their own employee/salary information and their own routine slots. They do not receive full student/result access unless marked as class teacher.
• Accountant/Accounts: financial control. They manage payments, class fee rules, salary ledgers, and increments, but they do not edit marks.
• Staff/Employee: limited operational/self access.
• Audit: read-only access for school records, employee/salary/increment summaries, and student records. No write access.
• Student: own profile only.

Student Rules

• Student name is required.
• Class fee rule/class is required.
• Roll/ID is required.
• Roll/ID remains unique inside the same class.
• Admin can delete students.
• Teacher can add/edit students but cannot delete students.

Result Rules

• Monthly exam number must be 1 to 12.
• Semester exam number must be 1 to 3.
• Class test number must be 1 or 2 for each month.
• Class tests require a month.
• Obtained marks cannot be greater than total marks.
• Total marks must be greater than 0.
• Contribution percentage must be 0 to 100.
• Total final-result contribution for one student + subject + year cannot exceed 100%.
• Result summary totals all subject marks for each student, shows the class highest mark, and calculates position in class automatically.
• Weighted contribution is still stored for subject-level assessment control, but class position is calculated from total obtained marks and percentage.

Routine Rules

• Class, day, start time, end time, subject, and teacher name are required.
• End time must be later than start time.
• The same class cannot have two overlapping active routine slots.
• The same teacher cannot have two overlapping active routine slots.

Finance Rules

• Due amount = total amount - paid amount.
• Payment status becomes unpaid, partial, or paid automatically.
• Salary due is recalculated after salary payment records are created/updated.
• Student due is recalculated after payment records are created/updated.

Database Connection

Create a .env file in the project root:

PORT=5001
MONGODB_URI=mongodb://127.0.0.1:27017/EducationManagement
MONGODB_DB=EducationManagement
JWT_SECRET=change-this-secret-before-production
ENABLE_DEMO_ACCOUNTS=true
ENABLE_DEMO_DATA=true
CORS_ORIGIN=http://localhost:5173
VITE_API_URL=/api

Use your existing MongoDB database name in MONGODB_URI. This upgrade does not delete or reset your existing database data.

Optional:

MONGODB_DB=EducationManagement

Use MONGODB_DB only if your MONGODB_URI does not already include the database name.

Install and Run

npm install
npm run server

Open a second terminal:

npm run client

Client URL:

http://localhost:5173

Server URL:

http://localhost:5001

Notes

• If your old database already has student, employee, payment, salary, or class fee data, it will load from MongoDB.
• The frontend data loader is safer: one failed API module will not stop the whole dashboard from loading.
• New academic/routine/increment features use separate collections, so existing student/employee/payment schemas are preserved.

GitHub-inspired UI Refresh

• Admin Console sidebar uses SVG icons and can minimize/expand with one click.
• Minimized mode keeps only Admin, Teacher, Staff, Accountant, and Student role icons visible.
• UI uses Outfit font, GitHub-style dark sidebar, bordered cards, clean tables, clear hover states, and visible focus states.
• Backend/database schema is unchanged; this update only improves the frontend interface and API port setup.

Network Error Fix

This version uses Vite proxy to avoid frontend/backend port mismatch. Run from the project root:

npm install
npm run dev

npm run dev starts both the backend on http://localhost:5001 and the frontend on http://localhost:5173.

If you want two terminals instead:

npm run server

Then:

npm run client

Make sure MongoDB is running and .env has your correct database name.

2026 Market-Leading School ERP Comparison Update

I compared this project against common feature patterns in leading school management/SIS platforms such as PowerSchool-style SIS systems, Blackbaud/Veracross-style private-school platforms, and OpenEduCat/Fedena-style ERP platforms. The updated UI now includes a Market Benchmark module and a more premium dashboard experience.

What was added in this version

• Fixed the common Route not found issue caused by duplicated /api/api/... requests.
• Added a frontend API base URL guard so VITE_API_URL=/api works correctly with the Vite proxy.
• Added a backend safety middleware that rewrites accidental /api/api/... requests to /api/....
• Changed the default backend port from 5000 to 5001 to match the project .env and Vite proxy.
• Added a clearer EADDRINUSE message if the selected server port is already running.
• Added a premium blue/yellow/white school SaaS UI refresh.
• Added searchable tables across the dashboard so users can find records faster.
• Added a market benchmark page comparing your modules with leading school ERP/SIS expectations.
• Added dashboard quick-action cards for Students, Marks, and Fees.
• Added a collection-rate hero card and better decision-focused KPI cards.
• Added a roadmap panel for attendance, parent portal, online payment, notifications, audit logs, and reports.

Current strength of this project

Your system already has a good operational base: role-based access, student records, class fee rules, payment ledger, employee records, salaries, salary increments, routines with overlap prevention, marks, weighted result calculation, and student profile summaries.

Recommended next product upgrades

1. Attendance module with class/date-wise attendance and parent alerts.
2. Parent portal and student portal dashboard with notices, dues, and results.
3. Online payment gateway with receipt/PDF export.
4. Printable report cards and transcript-style reports.
5. Notice/SMS/email communication module.
6. Audit logs for admin actions.
7. Dashboard charts for monthly collection, unpaid fees, attendance, and exam performance.

Route Not Found Fix Details

The old setup could create requests like this:

/api/api/marks/results
/api/api/dashboard

But the backend routes are defined as:

/api/marks/results
/api/dashboard

So the updated client/src/api.js now treats VITE_API_URL=/api as a Vite proxy mode and keeps Axios baseURL empty. This lets existing service calls like /api/dashboard hit the correct backend route.

Run everything from the root folder:

npm install
npm run dev

Then open:

http://localhost:5173

Latest update: result-card PDF and clean user header

This version removes the unused role shortcut strip and the old branding text in the sidebar. The layout now shows only the logged-in user avatar/initials, username, role, and module navigation.

New features added

• Admin can update school report-card settings from Result Cards > School Settings:
  • School name
  • Subtitle
  • Left logo URL
  • Right logo URL
  • Address, phone, website
  • Report title
  • Principal name
  • Default remarks
  • Admission/notice text
• Teachers/admins can open Result Cards, filter by student and exam, then click Download PDF.
• Students can open Result Cards and see their own exam-wise generated result cards.
• The result-card design is based on a printed progress report layout with logos, school header, student information, subject marks table, total, result, remarks, notice, and signatures.
• PDF generation uses the browser print dialog. Click Download PDF, then choose Save as PDF.

New API endpoint

GET /api/school-settings
PUT /api/school-settings    Admin only

---

Deployment Ready Notes

This version includes deployment configuration for GitHub, Render, Vercel, and MongoDB Atlas.

Important files:

• render.yaml — optional Render blueprint configuration.
• vercel.json — Vercel static frontend configuration.
• .env.example — safe environment variable template.
• DEPLOYMENT_STEPS.md — beginner-friendly deployment checklist.

Backend start command:

npm start

Build command:

npm ci && npm run build

For Vercel frontend, set:

VITE_API_URL=https://your-render-service.onrender.com

For Render backend, set:

MONGODB_URI=mongodb+srv://<username>:<password>@cluster0.krhhqvp.mongodb.net/EducationManagement?retryWrites=true&w=majority&appName=Cluster0
MONGODB_DB=EducationManagement
JWT_SECRET=your-long-random-secret
ENABLE_DEMO_ACCOUNTS=true
CORS_ORIGIN=https://your-vercel-site.vercel.app