WebApplication

This repository is a part of the SEPAD project and was developed by Parsa Safaie to serve schools within the larger SEPAD system.

Click here to visit the SEPAD organization.

The application is currently deployed and accessible at http://sepad-project.ir/ where you can view the live results.

Cloning the Repository

To clone the repository with its submodules, run:

git clone --recurse-submodules https://github.com/SEPAD-Project/WebApplication.git
cd WebApplication

Installing Dependencies

Recommended Python version for this project is: 3.10.*

1. Create a virtual environment:

   python -m venv .venv

2. Activate the virtual environment:

   • On Windows:

     .venv\Scripts\activate.bat

   • On Linux:

     source .venv\bin\activate

3. Install the dependencies:

   pip install -r requirements.txt

Celery & Redis Setup

This project uses Celery for asynchronous task management and requires Redis as the message broker.

• On Windows:

  1. Download the Redis installer from Microsoft's Redis releases.
  2. Follow the installation wizard.
  3. Use the default port 6379 when prompted.

• On Linux:

  Install Redis using your package manager:

  sudo apt update
  sudo apt install redis

Running the Project

To start the project (Django + Celery), use the scripts file:

• On Windows:

  scripts/start_server.bat

• On Linux:

  chmod +x scripts/start_server.sh
  scripts/start_server.sh

After starting, the application will be accessible at:

http://0.0.0.0:8000