Setup development environment

To setup the development environment, you need the following files, and these can all be found in the Google Drive folder for the ASPA project.

1) Environment Setup

Clone this repository

Navigate to where your web server is currently running (usually htdoc). Run this command git clone https://github.com/UoaWDCC/ASPA-EnrollmentForm.git to clone this repository.

2) Security Keys

All credentials should be placed inside the folder private_keys under the root directory.

The current credentials needed are:

• google_credentials.json – access to google services
• auth_props.json – this will contain all other passkeys we need to run our application

These can both be found under the Google Drive folder, "Private keys (for dev)" under 2021.

3) Running the development environment

Run the Docker environment

NOTE: This step requires Docker to be installed.

1. Run docker-compose up in one powershell/terminal window.
2. Run start.sh executable – this will install all dependencies and could take a very long time to completely install the first time.
3. Go to localhost for the application and localhost:8081 for PHPMyadmin

4) ASPA Development "Database"

Get access to the google spreadsheets that the development environment has access to (DEV Membership Spreadsheet and DEV Registration Spreadsheet).

Membership Spreadsheet

• DEV Membership Spreadsheet This document lists out all the registered members in the ASPA database (either those who signed up with ASPA). The members who have paid their ASPA membership fee will be highlighted in green, and only those members highlighted in green are able to proceed to registering/paying for an ASPA event.

Event Registration Sheet

• DEV Registration Spreadsheet This document lists out controls for the current event displayed on the website on the CurrentEventDetails sheet. Each new event will be created as a separate sheet with the sheet name set in the spreadsheet. Read the descriptions of the different values/controls to find out what they do.