TareqMonwer/Django-School-Management
TareqMonwer/Django-School-Management has 598 GitHub stars and 270 forks. GitHot measured -1 stars in 24 hours. Last checked 2026-11-20 07:51 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- -1
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Transform your school with our intuitive Django School Management System. Seamlessly manage payments, simplify e-admissions, and track results effortlessly, all through a user-friendly interface. Developed using Python Django, our comprehensive system enhances your school's efficiency. Experience the future of education management today.
LearningREADME.md
OriginalDjango-School-Management
A fullstack school management project in django, bootstrap-4 and javascript.
Required setup components:
- PostgreSQL Database
- Redis instance up and running
Installation:
- go to the project folder
- run
pip install -r requirements.txt - create
.envunderenvsfolder and give credentials following.env.exampletemplate - See additional resources section to setup/get more info.
- run
python manage.py migrate - then
python manage.py runserverfor testing, create a superuser too.
Celery-redis setup:
- Celery is installed, install redis as well.
- for linux users:
- run redis server with
redis-servercommand.
- for windows users:
- Download redis (https://github.com/microsoftarchive/redis/releases/tag/win-3.0.504)
- Run redis-server.exe and redis-cli.exe.
And finally, while django server is running, run this command on another terminal
celery -A config worker -l INFO
Additional Resources:
- Create braintree sandbox account from: https://sandbox.braintreegateway.com/login
Usage/testing
Use provided fixtures for each applications.
Provided Fixtures:
- teachers/teacher_fixtures.json
How to load fixtures?
For example, you want to loadteachers/teacher_fixtures.json
you have to simply run this management command on your terminal:python manage.py loaddata teachers/teacher_fixtures.json
this command will load initial data for teachers app. Follow the same pattern to install initial data for other applications.
Fixture Load Order:
python manage.py loaddata teachers/teacher_fixtures.jsonpython manage.py loaddata academics/academic_fixtures.jsonpython manage.py loaddata students\fixtures\offline_applications.jsonpython manage.py loaddata students\fixtures\online_admitted.jsonpython manage.py loaddata students\fixtures\online_paid.jsonpython manage.py loaddata students\fixtures\online_rejected.jsonpython manage.py loaddata students\fixtures\online_unpaid.json
- APPLY CARD INFO AT
admissionlinkcard number: 5555555555554444expiracy: any valid future date
Working Components:
- Create application for admission manually (it will save candidate as offline admission candidate)
- Online application for admission (payment and admission process handled automatically)
- Handle payment, admission, rejection, update candidate's status after communication
- Assign student to an academic batch, class
- Manage counseling (admission) dashboard with data visualization (download/view pdf reports)
- CRUD departments, subjects, teachers, academic session, semester; import subjects from csv file
- Teacher list view, students list view, designation CRUD
- Create users, users list, view user groups and permissions
Performance test stack (Grafana + Prometheus + Locust)
This folder contains config for the self-contained perf stack in docker-compose.perf-test.yml.
What runs
- Locust – load test (autostart, 200 users, 10 min); web UI on port 8089.
- locust-exporter – scrapes Locust stats and exposes Prometheus metrics on 9646.
- Prometheus – scrapes the exporter (and optionally Django
/metrics) on 9091. - Grafana – pre-provisioned with Prometheus and the Locust dashboard on 3010.
How to run
From the project root:
docker compose -f docker-compose.perf-test.yml up --build
- Grafana: http://localhost:3010 (admin / admin)
- Locust UI: http://localhost:8089 (optional; test auto-starts)
- Prometheus: http://localhost:9091
In Grafana, open Performance → Locust to view the load test (status, users, RPS, response times, failures, etc.).