A modern, full-stack school management platform built with FastAPI and Next.js. Designed to streamline administrative tasks, manage student records, track grades, and handle school fees efficiently.
Schools often struggle with:
- Fragmented data management across multiple systems
- Manual record keeping prone to errors
- Inefficient communication between staff and parents
- Complex billing and fee tracking
- Limited real-time insights into student performance
This system provides a centralized, web-based platform that consolidates teachers, students, classes, grades, and fees management into one intuitive interface.
- FastAPI — Modern, fast Python web framework
- PostgreSQL — Robust relational database
- Asyncpg — High-performance async PostgreSQL driver
- Uvicorn — ASGI server
- Pydantic — Data validation
- Next.js 16 — React framework with TypeScript
- React Hook Form — Efficient form state management
- Radix UI — Unstyled, accessible UI components
- Tailwind CSS — Utility-first CSS framework
- ESLint — Code quality
- Docker — Containerization
- Docker Compose — Multi-container orchestration
- Docker Swarm Stack — Production deployment
- Real-time statistics and key metrics
- Recent activity feed
- Class schedule widget
- Top-performing students
- Add, edit, and delete student records
- Track enrollment dates and status
- Parent contact information
- Automatic student-to-class assignment
- Manage teacher profiles and contact info
- Track subject assignments
- Monitor employment status
- Create and manage class sections
- Assign teachers to classes
- Track class capacity and enrollment
- Record student grades by subject and term
- Automatic letter grade calculation
- Multiple exam types (End of Term, Midterms, etc.)
- Grade tracking by term
- Track student fees per term
- Monitor payment status (Unpaid, Partial, Paid)
- Calculate remaining balance
- Record payment methods and dates
- Notifications system
- Messaging platform
- Attendance tracking
- Schedule management
- Reports generation
- User settings
- Docker & Docker Compose installed
- Git
- PostgreSQL credentials (for local development)
git clone https://github.com/ahmad-cod/school-management-system.git
cd school-management-systemCreate a .env file in the project root:
Duplicate the template file to create your local environment config:
cp .env.example .envEdit the .env file with your local settings.
docker-compose up --buildThis will:
- Build and start the PostgreSQL database
- Initialize the database schema and seed data
- Build and start the FastAPI backend (http://localhost:8000)
- Build and start the Next.js frontend (http://localhost:3000)
| Component | URL | Purpose |
|---|---|---|
| Frontend | http://localhost:3000 | Main web interface |
| API | http://localhost:8000 | REST API endpoints |
| API Docs | http://localhost:8000/docs | Interactive Swagger UI |
| Alternative Docs | http://localhost:8000/redoc | ReDoc documentation |
The system comes pre-seeded with sample data for classes, teachers, students, and grades. Start managing your school!
school-management-system/
├── backend/ # FastAPI application
│ ├── app/
│ │ ├── main.py # FastAPI app setup & routes
│ │ ├── db.py # Database connection pool
│ │ ├── models.py # Pydantic models
│ │ └── routers/ # API endpoint groups
│ │ ├── students.py
│ │ ├── teachers.py
│ │ └── classes.py
│ ├── requirements.txt # Python dependencies
│ └── Dockerfile
│
├── frontend/ # Next.js application
│ ├── app/ # App directory (routing)
│ │ ├── page.tsx # Dashboard
│ │ ├── students/
│ │ ├── teachers/
│ │ ├── classes/
│ │ ├── grades/
│ │ ├── fees/
│ │ ├── schedule/
│ │ ├── notifications/
│ │ └── [other pages]/
│ ├── components/ # React components
│ │ ├── dashboard/ # Dashboard components
│ │ └── ui/ # Reusable UI components
│ ├── services/ # API client services
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utilities
│ ├── package.json
│ └── Dockerfile
│
├── db/ # Database scripts
│ ├── schema.sql # Database schema
│ ├── seed.sql # Sample data
│ ├── init.sql # Initialization
│ └── queries.sql # Common queries
│
├── docker-compose.yml # Local dev orchestration
├── docker-stack.yml # Production swarm config
├── locustfile.py # Load testing
└── README.md # This file
cd backend
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000cd frontend
npm install
npm run devOpen http://localhost:3000 in your browser.
GET /students— List all studentsPOST /students— Create new studentGET /students/{id}— Get student detailsPUT /students/{id}— Update studentDELETE /students/{id}— Delete student
GET /teachers— List all teachersPOST /teachers— Create new teacherGET /teachers/{id}— Get teacher detailsPUT /teachers/{id}— Update teacherDELETE /teachers/{id}— Delete teacher
GET /classes— List all classesPOST /classes— Create new classGET /classes/{id}— Get class detailsPUT /classes/{id}— Update classDELETE /classes/{id}— Delete class
Full API documentation available at http://localhost:8000/docs
docker stack deploy -c docker-stack.yml school_systempip install locust
locust -f locustfile.py --host=http://localhost:8000- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit changes (
git commit -m 'Add AmazingFeature') - Push to branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
For issues, suggestions, or questions, please open an issue on GitHub or contact the development team.
Built with ❤️ for efficient school management