xavysp / easy-school

A Django based School Management Web Application

Easy School

This is a school management system that uses Django Admin to do most of the work of managing students, fee submissions, teacher records etc..

Setting up Easy School is very easy.

Want to Use?

This branch is under development right now. But if you want to use it in a small setup then you can deploy this commit as it is properly working except the Fee summary report

Building

It is best to use the python virtualenv tool to build locally:

> virtualenv venv
> source venv/bin/activate
> git clone https://github.com/ZeroCoolHacker/easy-school .

Then you navigate to the base directory of the project and install the requirements in your virtual environment

> cd easy-school/easy-school
> pip install -r requirements.txt

And finally you make migrations to the database, create a super user, and run the server

> python manage.py makemigrations
> python manage.py migrate
> python manage.py createsuperuser
> python manage.py runserver

Then visit http://localhost:8000 to view the app. Alternatively you can use foreman and gunicorn to run the server locally

> foreman start

Building with Docker

First run docker-compose to build the container:

docker-compose build

Then, run the following command to create the superuser:

docker-compose run web python manage.py createsuperuser

Finally, the Docker container can be launched with the following command:

docker-compose up

The server should be responding at 127.0.0.1:8000

Contributing

Just follow the steps above to setup your environment. Read the Contribution Guide

To do

• Manage Students Record in admin
• Submit fees in admin
• Show last submitted fee along with students
• Link Students to different Courses
• Search the record by various fields
• Minimize the number of queries for each view
• Add Teachers Record to admin
• Create Signup and Login view for teachers
• Attendence Management
• Result management for different Exams

Licensing

This Project is Licensed under GLWTPL

Hall of fame

Everyone who contributes to easy-school gets a spot here.

• @ZeroCoolHacker
• @Argetan
• @ismailuddin
• @davidkarabas