Clock shop

The "clock shop" is a project under the Software Technology Project 2023.

To keep it short: this piece of software is intended to make it possible for the owner of a "clock shop" to organize his business. For more details see our Requirements specification (Pflichtenheft)

Important documents you might want to watch (pun intended)

• Meeting Protocols

• Time recording (Zeiterfassung)

• Requirements specification (Pflichtenheft)

• Developer documentation (Entwicklerdokumentation)

The repository layout

The repository follows the standard Maven project layout. Nearly all artifacts are stored in a subdirectory of src/:

src/
├── main/
│   ├── asciidoc/   -- Documentation of the development process and application (Asciidoc format)
│   ├── java/       -- Main source code of the application, separated into packages
│   └── resources/  -- Static assets (images, stylesheets), Thymeleaf templates, etc.
└── test/
    └── java/       -- Source code of JUnit tests is stored separately

Pro tip: In GitHub, press t and a "fuzzy file finder" will appear, making it easy to navigate to a file.

How to run the application?

• In the IDE: find Application.java, right-click project, select "Run As > Java Application"

• From the command line: run ./mvnw spring-boot:run

• open your Browser and visit http://127.0.0.1:8080

• default admin user is named boss and has the password 123

How to package the application?

• Run ./mvnw clean package. The packaged application (a JAR in target/) can be run with java -jar $jarName.