Spring boot application with an Angular User Interface (UI) for SWE 642 homework 3.

Contributors:

• Josh Marsden
• Lubna Fatima
• Gangadaran Kameswaran

• Install latest version of Java (21.x.x)
• (Optional) Install latest version of maven (3.9.5)
  • Or use the included mvnw wrapper in the repo

• Use VS Code as your IDE
• Install the VS Code "Extension Pack for Java"
  • Includes "Maven for Java" among other things

PostgreSQL is the database dependency for this project. Either install locally to your computer, run your own virtual server, or use the docker-compose.yaml file to run the PostgreSQL server.

docker-compose up -d

To shutdown the container and remove the volume:

docker-compose down -v

With postgres running, go ahead and install the project dependencies with maven. This will build out the necessary files in target/ to run a minimal application. This will also run the test which does nothing but ensures that an empty test is run.

mvn install

Run the application with the spring-boot plugin:

mvn spring-boot:run

The default port is 8080, so you can visit http://localhost:8080 and you will see an ugly page with a 404 error because the webserver hasn't been configured to run anything yet.

Generated with Angular CLI version 17.0.0.

• Install node version 18

  Consider using nvm to manage multiple versions of node. You can install the expected node version via nvm with nvm install which will read from the .nvmrc file located in this repo.

Run ng serve or npm run start for a dev server. Navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.

Run ng generate component component-name to generate a new component within the src/ui/app/ directory. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module. Generated components get their own directory with the same name in which all four generated files are located.

Run ng build or npm run build to build the project. The build artifacts will be stored in the src/main/resources/static/ directory.

Run ng test or npm run test to execute the unit tests via Karma.

Run ng e2e to execute the end-to-end tests via a platform of your choice. To use this command, you need to first add a package that implements end-to-end testing capabilities.

To get more help on the Angular CLI use ng help or go check out the Angular CLI Overview and Command Reference page.