mirrors/swt23w23
1
0
Fork 0
mirror of https://github.com/st-tu-dresden-praktikum/swt23w23 synced 2024-07-19 21:04:36 +02:00
Code Issues Packages Projects Releases Wiki Activity
The original repository needs to be a private repository. Sadly, Issues and Pull Requests can’t be mirrored. https://catering.salespointframework.org
4 commits 56 branches 0 tags 16 MiB
Java 78%
HTML 17.3%
TeX 3.5%
Makefile 0.6%
Nix 0.4%
Other 0.2%
Find a file
Simon Bruder 175f5f106d
Use minutes for time recording 
This is required according to the first paragraph.

This also documents in more detail how exactly the weeks are structured.
The structuring is not the best way, but considering our team meeting is
on Fridays, which especially made the first week start late, it is the
best I could think of.
2023-10-20 18:15:28 +02:00
.github/workflows Initial commit 2023-10-05 11:42:24 +02:00
.mvn/wrapper Initial commit 2023-10-05 11:42:24 +02:00
src Use minutes for time recording 2023-10-20 18:15:28 +02:00
.editorconfig Initial commit 2023-10-05 11:42:24 +02:00
.gitignore Initial commit 2023-10-05 11:42:24 +02:00
mvnw Initial commit 2023-10-05 11:42:24 +02:00
mvnw.cmd Initial commit 2023-10-05 11:42:24 +02:00
pom.xml Initial commit 2023-10-05 11:42:24 +02:00
readme.adoc Initial commit 2023-10-05 11:42:24 +02:00

readme.adoc 

image:https://github.com/st-tu-dresden-praktikum/swt23w23/workflows/CI%20build/badge.svg["CI Build", link="https://github.com/st-tu-dresden-praktikum/swt23w23/actions"]
image:https://img.shields.io/badge/SonarQube-checked-blue?logo=sonarqube["SonarQube status", link="https://st-lab-ci.inf.tu-dresden.de/sonarqube/"]

// Hi there! We've already included some generally useful information in here.
// Feel free to edit the first section to add a short description of your task and your project.

= Kickstart

The kickstart module is a template project to bootstrap the Java project in the Software Engineering lab.
Each group's repository is initialized with this template.
It contains the following features:

* a skeleton Java 17 web application based on Spring Boot and Salespoint framework (see `src/main/java` and `src/test/java`)
* Asciidoc documentation templates in `src/main/asciidoc`

== Important documents in this repo

* link:src/main/asciidoc/protocols[Meeting Protocols]
* link:src/main/asciidoc/time_recording.adoc[Time recording (Zeiterfassung)]
* link:src/main/asciidoc/pflichtenheft.adoc[Requirements specification (Pflichtenheft)]
* link:src/main/asciidoc/developer_documentation.adoc[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`

== How to package the application?

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