The Vertex Sports Centre Management System

A comprehensive sports centre management system in Python and Flask.
Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Issues
5. Contact

About The Project

Design, development and testing of a sports centre management system in Python using Flask, developed for the COMP2913 Software Engineering Principles Group Project.

(back to top)

Built With

• 
• 
• 
• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running follow these simple steps: Note: Windows steps assume that you're using PowerShell from within the Windows Terminal app.

Cloning the repository

> git clone https://github.com/uol-feps-soc-comp2913-2223s2-classroom/project-squad30.git

Setting up the repository to run the application

You should only need to do this once (the first time you clone) with proper git usage.

1. Create your virtual environment in the project-squad30 directory. As long as the environment is called "env", it won't be uploaded to version control (see the gitignore file).

> python3 -m venv env # "env" is the name of the environment
# or
> python -m venv env

2. Activate your virtual environment.

# Windows
> ./env/Scripts/activate
# Linux/Mac [?]
> source ./env/bin/activate

# When you want to deactivate later
> deactivate

3. Install project requirements.

> pip3 install -r requirements.txt
# or
> pip install -r requirements.txt

4. Set environment variables.

# Windows (powershell)
> $env:SECRET_KEY='secretkeygoeshere-see-teams'
> $env:TOKEN_SALT='emailsaltgoeshere-see-teams'
> $env:EMAIL_PASSWORD='emailpasswordgoeshere-see-teams'
> $env:FLASK_DEBUG=1 # if you want to run the app in debug mode
> $env:PUBLISHABLE_KEY='publishablekeygoeshere-see-teams'
> $env:SECRET_STRIPE_KEY='secretstripekeygoeshere-see-teams'
# Linux/mac
# Look up how to make environment variables persist to prevent having to re-do this step every time you open a new terminal.
> export SECRET_KEY='secretkeygoeshere-see-teams'
> export TOKEN_SALT='emailsaltgoeshere-see-teams'
> export EMAIL_PASSWORD='emailpasswordgoeshere-see-teams'
> export FLASK_DEBUG=1
> export PUBLISHABLE_KEY='publishablekeygoeshere-see-teams'
> export SECRET_STRIPE_KEY='secretstripekeygoeshere-see-teams'

5. Run pytest. This will initialise some caches and the database for you.

> python3 -m pytest -v
# or 
> python -m pytest -v

6. The project should be ready to run. Check by running it.

> cd vertex
> flask run

(back to top)

Issues

See the open issues for a full list of backlog, known issues, their priorities and assignees.

(back to top)

Contact

Squad 30

• Divyashri Ravichandran
• Theo Addis
• Kavya Pothapragada
• Vindhyaa Saravanan
• Aidan Nash
• Ilham Abdullayev

Project Links:

• Project Repository
• Project Wiki

(back to top)