Skip to content

Latest commit

 

History

History
162 lines (136 loc) · 4.64 KB

README.md

File metadata and controls

162 lines (136 loc) · 4.64 KB

🏫 School Management System

📌 Overview

School Management System ek React.js, React Native, Node.js, MongoDB, aur Razorpay par based ek smart system hai jo student, teacher, attendance, transport, task management, aur chat functionalities ko automate karta hai.

🚀 Features

🎓 Student & Teacher Management

✅ Student & teacher profile management
✅ Attendance tracking (Biometric/RFID based)
✅ Performance analysis & grading system

🚌 Bus & Transport Management

✅ Live bus tracking via GPS
✅ Automated attendance on boarding
✅ Bus route & driver management

📝 Task & Exam Management

✅ Homework & assignment tracking
✅ Exam scheduling & report card generation
✅ Online tests & quiz integration

💳 Fee & Payment System

✅ Online fee payment via Razorpay
✅ Auto-generated invoices & reminders
✅ Fee due tracking

📢 Communication & Security

✅ Real-time Chat system for teacher, students & parents
✅ Multi-role authentication (Admin, Teacher, Student, Parent)
✅ Email/SMS notifications

🏗️ Tech Stack

Component Technology
Frontend (Web) React.js + Redux + TailwindCSS
Frontend (Mobile) React Native
Backend Node.js + Express.js
Database MongoDB
Authentication Firebase/Auth0
Payment Gateway Razorpay
Notifications Firebase Cloud Messaging (FCM)

📂 Folder Structure

school-management/
│── backend/            # Node.js & Express backend
│   ├── controllers/    # Business logic
│   ├── models/         # MongoDB models
│   ├── routes/         # API routes
│   ├── middleware/     # Authentication & security
│   ├── config/         # Configuration files
│   ├── utils/          # Helper functions
│   ├── .env            # Environment variables
│   ├── server.js       # Entry point
│
│── frontend/           # React.js frontend
│   ├── src/
│   │   ├── components/ # UI Components
│   │   ├── pages/      # Page Components
│   │   ├── redux/      # Redux store & slices
│   │   ├── utils/      # Helper functions
│   │   ├── App.js      # Main App component
│   │   ├── index.js    # Entry point
│   ├── public/         # Static assets
│   ├── .env            # Environment variables
│
│── mobile-app/         # React Native mobile app
│   ├── src/
│   │   ├── components/ # UI Components
│   │   ├── screens/    # Screens
│   │   ├── redux/      # Redux store & slices
│   │   ├── utils/      # Helper functions
│   │   ├── App.js      # Main App component
│   │   ├── index.js    # Entry point
│   ├── android/        # Android specific files
│   ├── ios/            # iOS specific files
│   ├── .env            # Environment variables
│
│── README.md           # Documentation
│── package.json        # Dependencies
│── .gitignore          # Git ignore file

🔧 Installation Guide

1️⃣ Clone Repository

git clone https://github.com/your-repo/school-management.git
cd school-management

2️⃣ Backend Setup

cd backend
npm install
cp .env.example .env # Configure MongoDB & Razorpay keys
npm start

3️⃣ Frontend (React.js) Setup

cd frontend
npm install
npm start

4️⃣ Mobile App (React Native) Setup

cd mobile-app
npm install
npx react-native run-android # For Android
echo "Run iOS: npx react-native run-ios (Mac required)"

📌 API Endpoints

Method Endpoint Description
POST /api/auth/register User registration
POST /api/auth/login User login
GET /api/students Get all students
POST /api/attendance Mark attendance
POST /api/payments Process fee payment

🎯 Future Enhancements

🚀 AI-based student performance prediction
🚀 Online classroom integration (Zoom, Google Meet)
🚀 Parent meeting scheduling

💡 Contributing

Contributions are welcome! Follow these steps:

  1. Fork the repository
  2. Create a new branch (feature-xyz)
  3. Commit changes & push
  4. Open a pull request 🚀

📜 License

MIT License. Feel free to use & modify! 😊

Git Hub

main ├── develop │ ├── feature/student-login │ ├── feature/teacher-dashboard │ ├── feature/bus-tracking │ │── hotfix/urgent-fix