A comprehensive, highly advanced school enterprise resource planning (ERP) platform built with a high-fidelity role-based authentication layout and path-resilient design.
This custom-built ERP system digitalizes and streamlines school administration, financial management, academic scheduling, and parent communication into a single, cohesive platform with a modern, responsive UI. It is designed specifically for Sri Basaveswara School (Target Domain: basaveswara.edu.in).
- Dynamic Fee Ledgers: Automated tuition fee tracking, recording, and outstanding balance calculations.
- Instant WhatsApp Receipts: Integrated one-click WhatsApp sharing (
wa.me) for instant fee receipt delivery to parents. - Dynamic UPI Integration: Automated generation of UPI QR codes on receipts for seamless fee collection.
- Digital Attendance Register: Streamlined daily attendance tracking system for teachers.
- Dynamic Timetable Scheduler: A robust weekly timetable manager for school administrators.
- Visual Dashboards: Intuitive dashboards featuring visual attendance calendars and personalized timetable grids.
- Transport Directory: Real-time access to school transport routes and contact information.
- Official Scoresheet: Digital official academic report cards.
The platform is decoupled into a dynamic Express backend API server and static client portal applications.
graph TD
subgraph Client ["Unified Frontends (basaveswara.edu.in)"]
F1["🏠 Landing Gateway (index.html)"]
F2["🎒 ParentLink Portal (parentlink.html)"]
F3["🏫 Academics Workspace (academics.html)"]
F4["📊 Results Search Gateway (results.html)"]
end
subgraph Backend ["Core API & Data Layer"]
B1["📡 Node.js & Express.js (REST API layer)"]
B2["📧 Nodemailer SMTP Integration"]
B3["💬 WhatsApp Alert Simulation"]
DB[("📂 Google Apps Script / Data Store")]
end
Client -- "HTTPS secure API calls" --> Backend
Backend --> DB
- Frontend UI: HTML5, Vanilla JavaScript, Tailwind CSS (for modern, responsive components).
- Backend API: Node.js with Express.js for robust logic and routing.
- Database & Storage: Offline simulation capabilities / Google Apps Script persistent backend functionality.
- Integrations: WhatsApp API (
wa.me), Dynamic QR Code Servers.
All critical access and master control are centralized under the Super Admin role:
- Super Admin: Full access to financial ledgers, system settings, and user management.
- System Emails: The platform is configured to send official automated communications via SMTP.
- Financial balance sheets and ledger management.
- Master user account and access control.
- System audit logging and timetable scheduling.
- Digital attendance registers.
- Dynamic row/column grid to input batch grades.
- Access to fee ledgers, dynamic UPI QR codes, and WhatsApp receipts.
- View visual attendance ring and digital report cards.
The system features a Path-Resilient Offline Sandbox Simulation System. This allows you to test and run the frontend dashboards locally without a live backend!
- Clone the repository and navigate into the folder:
git clone https://github.com/YOUR_GITHUB_USERNAME/school-erp.git cd school-erp - Install Node.js dependencies:
npm install
- Initialize your environment secrets by creating a
.envfile in the root directory:PORT=5000 EMAIL_USER=your-email@example.com EMAIL_APP_PASSWORD=your-google-app-password SUPER_ADMIN_EMAIL=admin@example.com
- Start the server:
(The server will boot on port
npm start
5000)
The static frontends (index.html, academics.html, parentlink.html) can be hosted directly on Vercel, Netlify, or GitHub Pages. Map your custom domain (basaveswara.edu.in) to the hosting provider. The Node backend should be deployed to a service like Render or Heroku.