Compile & Run the application

Front-end

In order to compile and run the front-end, you need to install the following dependencies:

Install Node.js.

Once you install Node.js, set two environment variables. Note that you need to use the appropriate syntax for Windows. Mac, and Linux to set these environment variables.

NODEJS_HOME = [Directory where you installed Node.js]

PATH = NODEJS_HOME/bin:PATH

Install Angular CLI 12.X

Example: npm install -g @angular/[email protected]

Install application dependencies

From the root directory of the application client:

npm install

Compile and Run the Main Application

ng serve --port=4700 --ssl

Run the Reporting Server

From the root directory of the application client:

cd server

node index.js

Back-end

Install JDK

Install version 1.8 of JDK.

Once you install the JDK, set two environment variables. Note that you need to use the appropriate syntax for Windows. Mac, and Linux to set these environment variables.

JAVA_HOME = [Directory where you installed Java]

PATH = JAVA_HOME/bin:PATH

Install Maven

Once you install Maven, set two environment variables. Note that you need to use the appropriate syntax for Windows. Mac, and Linux to set these environment variables.

MAVEN_HOME = [Directory where you installed Maven]

PATH = MAVEN_HOME/bin:PATH

Install Git

Install Git. It sets up the PATH automatically.

Make changes to the application back-end

If your data model already has an existing user table, you need to follow the information below.

We want to create a default user with an Admin role who can be used to login into the application. To create this user, we use liquibase. We need to edit two files, userrole.csv and userpreference.csv in the src/main/resources/db/data directory. We need to specify a value in the "id" column of userpreference.csv and in the "name of your user table"_id (ex: users_id) column of userrole.csv. For example, you could specify a value of 1 in these two files.

Compile and Run the Main Application

Go to the back-end root directory.

mvn clean package -Dmaven.test.skip=true

cd target

java -jar [name of the jar file]