We're working on a website that can be used by different communities to help self organise, keep track of need and effectively deploy help. We focus on building an intuitive front-end design and a system which all users can interact with. The application uses a Django project integrated with a vue application. And here is the website page https://uob.tofro.app/index/

• Ismael Bencharef (IshShogun) - [email protected]
• Linfeng Cai (CAILINFENG123) - [email protected]
• Bowen Wang (Ruri22) - [email protected]
• Xinyuan Zhang (s1s1s) - [email protected]
• Zhiming Liu (LZMBill) - [email protected]

• Gantt Chart
• Kanban

Please see our latest release ！

• Download & Install Docker

• Clone this repository:

git clone https://github.com/spe-uob/2022-VolunteerManagementApp.git 

• There are some extre steps for windows user(mac user can skip this step)

run these commands in Application\api directory
dos2unix setup.sh
dos2unix run.sh
dos2unix run-dev.sh

Then run this command in Application\api\build_scripts
dos2unix build-frontend-assets.sh

• Then Run the following command in the Application directory ( This downloads all required node modules for the vue app ):

cd ./Application/
docker-compose -f docker-compose.yml -f development.yml up --build

• Direct to the helloworldvue directory and run the following commands

cd ./Application/api/helloworldvue/
npm install
npm run serve

• Restart the tofro-django container and get running ! ! !

To get the website running open the following url:

http://localhost:8000/

Login then direct to:

http://localhost:8000/index

This is where the Vue Application is rendered. Now all that is left is to enjoy!!!

If you found a bug, you can use issue template to create an issue with the tag bug

We decided to use GitHub actions that triggers whenever we start a pull request into main There are two tests, one for the frontend and one for the backend

• Frontend Tests
• Backend Tests

The deployment is achieved by pushing the code to a virtual machine, and the process of updating involves accessing the virtual machine, locating the corresponding file path, and pulling the latest code from GitHub.

The latest code is then deployed to https://uob.tofro.app/index/

• The site needs to be intuitive and easy to navigate/use for the coordinator
• The site needs to facilitate easy logging of new actions
• The site needs to facilitate easy matching between actions and eligible volunteers
• The site needs to facilitate efficient dealing of high priority actions
• The site needs to facilitate easy searching of actions,residents and volunteers

• We will prioritize the safety of our users.
• We will respect the privacy of our users and will never use their data for any purpose other than the intended one.
• We will listen to feedback and criticism from our users and will use it to improve our products and services.
• By adhering to these principles, we hope to create a culture of respect that benefits everyone in our group.