Skip to content

ls1intum/thesis-track

Repository files navigation

thesis-tracker

Web Application for trackage of theses applied for and supervised at the chair

Client - React Web Application

Local development

Preconditions

To start the client application for local development, navigate to /client folder and execute the following command from the terminal:

yarn install
yarn run dev

Client is served at http:https://localhost:3000.

The following routes are available:
/management/thesis-applications - Role-protected console for management of thesis applications
/applications/thesis - Form for thesis application submission

Server - Java Spring Boot Application

Local development

Preconditions

Server is served at http:https://localhost:8080.

Keycloak Setup

For local development start a keycloak container by following the steps below:

  1. From the project root execute:
docker compose up keycloak -d
  1. Open http:https://localhost:8081 and sign in with admin credentials
    • Username: admin
    • Password: admin
  2. Import the keycloak-realm-config-example-json or create a new real thesis-track manually.

PostgreSQL Database

For local development start a database container by executing the following command from the project root:

docker compose up db -d

Liquibase

Project employs liquibase technology for database migrations. Upon a database schema change, follow the steps:

  1. Create a new changeset by adding a new script in the changelog folder
  2. Include the new changeset script into the master changelog file

Postfix

Notice: local development currently does not support mailing functionality, i.e. mail send attempts will fail. However, in spite of the errors the initial requests are executed normally and completely, thus, not limiting local development of other features.

About

Web Application for trackage of theses supervised at the chair

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages