urban/householdmanager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

initial commit

Browse Source
This commit is contained in:
Urban Modig
2026-03-22 16:36:05 +01:00
parent 67a2cd4290
commit 2c93f6777b
54 changed files with 9822 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
backend/.dockerignore Normal file
View File

@ -0,0 +1,9 @@
target/
.mvn/
mvnw
mvnw.cmd
.git/
.gitignore
.idea/
.vscode/
*.log

2
backend/.gitattributes vendored Normal file
View File

@ -0,0 +1,2 @@
/mvnw text eol=lf
*.cmd text eol=crlf

33
backend/.gitignore vendored Normal file
View File

@ -0,0 +1,33 @@
HELP.md
target/
.mvn/wrapper/maven-wrapper.jar
!**/src/main/**/target/
!**/src/test/**/target/
### STS ###
.apt_generated
.classpath
.factorypath
.project
.settings
.springBeans
.sts4-cache
### IntelliJ IDEA ###
.idea
*.iws
*.iml
*.ipr
### NetBeans ###
/nbproject/private/
/nbbuild/
/dist/
/nbdist/
/.nb-gradle/
build/
!**/src/main/**/build/
!**/src/test/**/build/
### VS Code ###
.vscode/

3
backend/.mvn/wrapper/maven-wrapper.properties vendored Normal file
View File

@ -0,0 +1,3 @@
wrapperVersion=3.3.4
distributionType=only-script
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.12/apache-maven-3.9.12-bin.zip

16
backend/Dockerfile Normal file
View File

@ -0,0 +1,16 @@
# Build stage
FROM maven:3.9.9-eclipse-temurin-21-alpine AS build
WORKDIR /app
COPY pom.xml .
# Download dependencies first for caching
RUN mvn dependency:go-offline
COPY src ./src
# Build the application - this includes code generation from OpenAPI spec
RUN mvn clean package -DskipTests
# Run stage
FROM eclipse-temurin:21-jre-alpine
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

295
backend/mvnw vendored Executable file
View File

@ -0,0 +1,295 @@
#!/bin/sh
# ----------------------------------------------------------------------------
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership. The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.
# ----------------------------------------------------------------------------
# ----------------------------------------------------------------------------
# Apache Maven Wrapper startup batch script, version 3.3.4
#
# Optional ENV vars
# -----------------
# JAVA_HOME - location of a JDK home dir, required when download maven via java source
# MVNW_REPOURL - repo url base for downloading maven distribution
# MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
# MVNW_VERBOSE - true: enable verbose log; debug: trace the mvnw script; others: silence the output
# ----------------------------------------------------------------------------
set -euf
[ "${MVNW_VERBOSE-}" != debug ] || set -x
# OS specific support.
native_path() { printf %s\\n "$1"; }
case "$(uname)" in
CYGWIN* | MINGW*)
[ -z "${JAVA_HOME-}" ] || JAVA_HOME="$(cygpath --unix "$JAVA_HOME")"
native_path() { cygpath --path --windows "$1"; }
;;
esac
# set JAVACMD and JAVACCMD
set_java_home() {
# For Cygwin and MinGW, ensure paths are in Unix format before anything is touched
if [ -n "${JAVA_HOME-}" ]; then
if [ -x "$JAVA_HOME/jre/sh/java" ]; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD="$JAVA_HOME/jre/sh/java"
JAVACCMD="$JAVA_HOME/jre/sh/javac"
else
JAVACMD="$JAVA_HOME/bin/java"
JAVACCMD="$JAVA_HOME/bin/javac"
if [ ! -x "$JAVACMD" ] || [ ! -x "$JAVACCMD" ]; then
echo "The JAVA_HOME environment variable is not defined correctly, so mvnw cannot run." >&2
echo "JAVA_HOME is set to \"$JAVA_HOME\", but \"\$JAVA_HOME/bin/java\" or \"\$JAVA_HOME/bin/javac\" does not exist." >&2
return 1
fi
fi
else
JAVACMD="$(
'set' +e
'unset' -f command 2>/dev/null
'command' -v java
)" || :
JAVACCMD="$(
'set' +e
'unset' -f command 2>/dev/null
'command' -v javac
)" || :
if [ ! -x "${JAVACMD-}" ] || [ ! -x "${JAVACCMD-}" ]; then
echo "The java/javac command does not exist in PATH nor is JAVA_HOME set, so mvnw cannot run." >&2
return 1
fi
fi
}
# hash string like Java String::hashCode
hash_string() {
str="${1:-}" h=0
while [ -n "$str" ]; do
char="${str%"${str#?}"}"
h=$(((h * 31 + $(LC_CTYPE=C printf %d "'$char")) % 4294967296))
str="${str#?}"
done
printf %x\\n $h
}
verbose() { :; }
[ "${MVNW_VERBOSE-}" != true ] || verbose() { printf %s\\n "${1-}"; }
die() {
printf %s\\n "$1" >&2
exit 1
}
trim() {
# MWRAPPER-139:
# Trims trailing and leading whitespace, carriage returns, tabs, and linefeeds.
# Needed for removing poorly interpreted newline sequences when running in more
# exotic environments such as mingw bash on Windows.
printf "%s" "${1}" | tr -d '[:space:]'
}
scriptDir="$(dirname "$0")"
scriptName="$(basename "$0")"
# parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties
while IFS="=" read -r key value; do
case "${key-}" in
distributionUrl) distributionUrl=$(trim "${value-}") ;;
distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;;
esac
done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties"
[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
case "${distributionUrl##*/}" in
maven-mvnd-*bin.*)
MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/
case "${PROCESSOR_ARCHITECTURE-}${PROCESSOR_ARCHITEW6432-}:$(uname -a)" in
*AMD64:CYGWIN* | *AMD64:MINGW*) distributionPlatform=windows-amd64 ;;
:Darwin*x86_64) distributionPlatform=darwin-amd64 ;;
:Darwin*arm64) distributionPlatform=darwin-aarch64 ;;
:Linux*x86_64*) distributionPlatform=linux-amd64 ;;
*)
echo "Cannot detect native platform for mvnd on $(uname)-$(uname -m), use pure java version" >&2
distributionPlatform=linux-amd64
;;
esac
distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip"
;;
maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;;
*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
esac
# apply MVNW_REPOURL and calculate MAVEN_HOME
# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
[ -z "${MVNW_REPOURL-}" ] || distributionUrl="$MVNW_REPOURL$_MVNW_REPO_PATTERN${distributionUrl#*"$_MVNW_REPO_PATTERN"}"
distributionUrlName="${distributionUrl##*/}"
distributionUrlNameMain="${distributionUrlName%.*}"
distributionUrlNameMain="${distributionUrlNameMain%-bin}"
MAVEN_USER_HOME="${MAVEN_USER_HOME:-${HOME}/.m2}"
MAVEN_HOME="${MAVEN_USER_HOME}/wrapper/dists/${distributionUrlNameMain-}/$(hash_string "$distributionUrl")"
exec_maven() {
unset MVNW_VERBOSE MVNW_USERNAME MVNW_PASSWORD MVNW_REPOURL || :
exec "$MAVEN_HOME/bin/$MVN_CMD" "$@" || die "cannot exec $MAVEN_HOME/bin/$MVN_CMD"
}
if [ -d "$MAVEN_HOME" ]; then
verbose "found existing MAVEN_HOME at $MAVEN_HOME"
exec_maven "$@"
fi
case "${distributionUrl-}" in
*?-bin.zip | *?maven-mvnd-?*-?*.zip) ;;
*) die "distributionUrl is not valid, must match *-bin.zip or maven-mvnd-*.zip, but found '${distributionUrl-}'" ;;
esac
# prepare tmp dir
if TMP_DOWNLOAD_DIR="$(mktemp -d)" && [ -d "$TMP_DOWNLOAD_DIR" ]; then
clean() { rm -rf -- "$TMP_DOWNLOAD_DIR"; }
trap clean HUP INT TERM EXIT
else
die "cannot create temp dir"
fi
mkdir -p -- "${MAVEN_HOME%/*}"
# Download and Install Apache Maven
verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
verbose "Downloading from: $distributionUrl"
verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
# select .zip or .tar.gz
if ! command -v unzip >/dev/null; then
distributionUrl="${distributionUrl%.zip}.tar.gz"
distributionUrlName="${distributionUrl##*/}"
fi
# verbose opt
__MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
[ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
# normalize http auth
case "${MVNW_PASSWORD:+has-password}" in
'') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
esac
if [ -z "${MVNW_USERNAME-}" ] && command -v wget >/dev/null; then
verbose "Found wget ... using wget"
wget ${__MVNW_QUIET_WGET:+"$__MVNW_QUIET_WGET"} "$distributionUrl" -O "$TMP_DOWNLOAD_DIR/$distributionUrlName" || die "wget: Failed to fetch $distributionUrl"
elif [ -z "${MVNW_USERNAME-}" ] && command -v curl >/dev/null; then
verbose "Found curl ... using curl"
curl ${__MVNW_QUIET_CURL:+"$__MVNW_QUIET_CURL"} -f -L -o "$TMP_DOWNLOAD_DIR/$distributionUrlName" "$distributionUrl" || die "curl: Failed to fetch $distributionUrl"
elif set_java_home; then
verbose "Falling back to use Java to download"
javaSource="$TMP_DOWNLOAD_DIR/Downloader.java"
targetZip="$TMP_DOWNLOAD_DIR/$distributionUrlName"
cat >"$javaSource" <<-END
public class Downloader extends java.net.Authenticator
{
protected java.net.PasswordAuthentication getPasswordAuthentication()
{
return new java.net.PasswordAuthentication( System.getenv( "MVNW_USERNAME" ), System.getenv( "MVNW_PASSWORD" ).toCharArray() );
}
public static void main( String[] args ) throws Exception
{
setDefault( new Downloader() );
java.nio.file.Files.copy( java.net.URI.create( args[0] ).toURL().openStream(), java.nio.file.Paths.get( args[1] ).toAbsolutePath().normalize() );
}
}
END
# For Cygwin/MinGW, switch paths to Windows format before running javac and java
verbose " - Compiling Downloader.java ..."
"$(native_path "$JAVACCMD")" "$(native_path "$javaSource")" || die "Failed to compile Downloader.java"
verbose " - Running Downloader.java ..."
"$(native_path "$JAVACMD")" -cp "$(native_path "$TMP_DOWNLOAD_DIR")" Downloader "$distributionUrl" "$(native_path "$targetZip")"
fi
# If specified, validate the SHA-256 sum of the Maven distribution zip file
if [ -n "${distributionSha256Sum-}" ]; then
distributionSha256Result=false
if [ "$MVN_CMD" = mvnd.sh ]; then
echo "Checksum validation is not supported for maven-mvnd." >&2
echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
exit 1
elif command -v sha256sum >/dev/null; then
if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then
distributionSha256Result=true
fi
elif command -v shasum >/dev/null; then
if echo "$distributionSha256Sum $TMP_DOWNLOAD_DIR/$distributionUrlName" | shasum -a 256 -c >/dev/null 2>&1; then
distributionSha256Result=true
fi
else
echo "Checksum validation was requested but neither 'sha256sum' or 'shasum' are available." >&2
echo "Please install either command, or disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
exit 1
fi
if [ $distributionSha256Result = false ]; then
echo "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised." >&2
echo "If you updated your Maven version, you need to update the specified distributionSha256Sum property." >&2
exit 1
fi
fi
# unzip and move
if command -v unzip >/dev/null; then
unzip ${__MVNW_QUIET_UNZIP:+"$__MVNW_QUIET_UNZIP"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -d "$TMP_DOWNLOAD_DIR" || die "failed to unzip"
else
tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar"
fi
# Find the actual extracted directory name (handles snapshots where filename != directory name)
actualDistributionDir=""
# First try the expected directory name (for regular distributions)
if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then
if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then
actualDistributionDir="$distributionUrlNameMain"
fi
fi
# If not found, search for any directory with the Maven executable (for snapshots)
if [ -z "$actualDistributionDir" ]; then
# enable globbing to iterate over items
set +f
for dir in "$TMP_DOWNLOAD_DIR"/*; do
if [ -d "$dir" ]; then
if [ -f "$dir/bin/$MVN_CMD" ]; then
actualDistributionDir="$(basename "$dir")"
break
fi
fi
done
set -f
fi
if [ -z "$actualDistributionDir" ]; then
verbose "Contents of $TMP_DOWNLOAD_DIR:"
verbose "$(ls -la "$TMP_DOWNLOAD_DIR")"
die "Could not find Maven distribution directory in extracted archive"
fi
verbose "Found extracted Maven distribution directory: $actualDistributionDir"
printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url"
mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
clean || :
exec_maven "$@"

189
backend/mvnw.cmd vendored Normal file
View File

@ -0,0 +1,189 @@
<# : batch portion
@REM ----------------------------------------------------------------------------
@REM Licensed to the Apache Software Foundation (ASF) under one
@REM or more contributor license agreements. See the NOTICE file
@REM distributed with this work for additional information
@REM regarding copyright ownership. The ASF licenses this file
@REM to you under the Apache License, Version 2.0 (the
@REM "License"); you may not use this file except in compliance
@REM with the License. You may obtain a copy of the License at
@REM
@REM http://www.apache.org/licenses/LICENSE-2.0
@REM
@REM Unless required by applicable law or agreed to in writing,
@REM software distributed under the License is distributed on an
@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@REM KIND, either express or implied. See the License for the
@REM specific language governing permissions and limitations
@REM under the License.
@REM ----------------------------------------------------------------------------
@REM ----------------------------------------------------------------------------
@REM Apache Maven Wrapper startup batch script, version 3.3.4
@REM
@REM Optional ENV vars
@REM MVNW_REPOURL - repo url base for downloading maven distribution
@REM MVNW_USERNAME/MVNW_PASSWORD - user and password for downloading maven
@REM MVNW_VERBOSE - true: enable verbose log; others: silence the output
@REM ----------------------------------------------------------------------------
@IF "%__MVNW_ARG0_NAME__%"=="" (SET __MVNW_ARG0_NAME__=%~nx0)
@SET __MVNW_CMD__=
@SET __MVNW_ERROR__=
@SET __MVNW_PSMODULEP_SAVE=%PSModulePath%
@SET PSModulePath=
@FOR /F "usebackq tokens=1* delims==" %%A IN (`powershell -noprofile "& {$scriptDir='%~dp0'; $script='%__MVNW_ARG0_NAME__%'; icm -ScriptBlock ([Scriptblock]::Create((Get-Content -Raw '%~f0'))) -NoNewScope}"`) DO @(
IF "%%A"=="MVN_CMD" (set __MVNW_CMD__=%%B) ELSE IF "%%B"=="" (echo %%A) ELSE (echo %%A=%%B)
)
@SET PSModulePath=%__MVNW_PSMODULEP_SAVE%
@SET __MVNW_PSMODULEP_SAVE=
@SET __MVNW_ARG0_NAME__=
@SET MVNW_USERNAME=
@SET MVNW_PASSWORD=
@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*)
@echo Cannot start maven from wrapper >&2 && exit /b 1
@GOTO :EOF
: end batch / begin powershell #>
$ErrorActionPreference = "Stop"
if ($env:MVNW_VERBOSE -eq "true") {
$VerbosePreference = "Continue"
}
# calculate distributionUrl, requires .mvn/wrapper/maven-wrapper.properties
$distributionUrl = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionUrl
if (!$distributionUrl) {
Write-Error "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
}
switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) {
"maven-mvnd-*" {
$USE_MVND = $true
$distributionUrl = $distributionUrl -replace '-bin\.[^.]*$',"-windows-amd64.zip"
$MVN_CMD = "mvnd.cmd"
break
}
default {
$USE_MVND = $false
$MVN_CMD = $script -replace '^mvnw','mvn'
break
}
}
# apply MVNW_REPOURL and calculate MAVEN_HOME
# maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
if ($env:MVNW_REPOURL) {
$MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" }
$distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')"
}
$distributionUrlName = $distributionUrl -replace '^.*/',''
$distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$',''
$MAVEN_M2_PATH = "$HOME/.m2"
if ($env:MAVEN_USER_HOME) {
$MAVEN_M2_PATH = "$env:MAVEN_USER_HOME"
}
if (-not (Test-Path -Path $MAVEN_M2_PATH)) {
New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null
}
$MAVEN_WRAPPER_DISTS = $null
if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) {
$MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists"
} else {
$MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists"
}
$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain"
$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join ''
$MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME"
if (Test-Path -Path "$MAVEN_HOME" -PathType Container) {
Write-Verbose "found existing MAVEN_HOME at $MAVEN_HOME"
Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"
exit $?
}
if (! $distributionUrlNameMain -or ($distributionUrlName -eq $distributionUrlNameMain)) {
Write-Error "distributionUrl is not valid, must end with *-bin.zip, but found $distributionUrl"
}
# prepare tmp dir
$TMP_DOWNLOAD_DIR_HOLDER = New-TemporaryFile
$TMP_DOWNLOAD_DIR = New-Item -Itemtype Directory -Path "$TMP_DOWNLOAD_DIR_HOLDER.dir"
$TMP_DOWNLOAD_DIR_HOLDER.Delete() | Out-Null
trap {
if ($TMP_DOWNLOAD_DIR.Exists) {
try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
}
}
New-Item -Itemtype Directory -Path "$MAVEN_HOME_PARENT" -Force | Out-Null
# Download and Install Apache Maven
Write-Verbose "Couldn't find MAVEN_HOME, downloading and installing it ..."
Write-Verbose "Downloading from: $distributionUrl"
Write-Verbose "Downloading to: $TMP_DOWNLOAD_DIR/$distributionUrlName"
$webclient = New-Object System.Net.WebClient
if ($env:MVNW_USERNAME -and $env:MVNW_PASSWORD) {
$webclient.Credentials = New-Object System.Net.NetworkCredential($env:MVNW_USERNAME, $env:MVNW_PASSWORD)
}
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$webclient.DownloadFile($distributionUrl, "$TMP_DOWNLOAD_DIR/$distributionUrlName") | Out-Null
# If specified, validate the SHA-256 sum of the Maven distribution zip file
$distributionSha256Sum = (Get-Content -Raw "$scriptDir/.mvn/wrapper/maven-wrapper.properties" | ConvertFrom-StringData).distributionSha256Sum
if ($distributionSha256Sum) {
if ($USE_MVND) {
Write-Error "Checksum validation is not supported for maven-mvnd. `nPlease disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties."
}
Import-Module $PSHOME\Modules\Microsoft.PowerShell.Utility -Function Get-FileHash
if ((Get-FileHash "$TMP_DOWNLOAD_DIR/$distributionUrlName" -Algorithm SHA256).Hash.ToLower() -ne $distributionSha256Sum) {
Write-Error "Error: Failed to validate Maven distribution SHA-256, your Maven distribution might be compromised. If you updated your Maven version, you need to update the specified distributionSha256Sum property."
}
}
# unzip and move
Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null
# Find the actual extracted directory name (handles snapshots where filename != directory name)
$actualDistributionDir = ""
# First try the expected directory name (for regular distributions)
$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain"
$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD"
if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) {
$actualDistributionDir = $distributionUrlNameMain
}
# If not found, search for any directory with the Maven executable (for snapshots)
if (!$actualDistributionDir) {
Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object {
$testPath = Join-Path $_.FullName "bin/$MVN_CMD"
if (Test-Path -Path $testPath -PathType Leaf) {
$actualDistributionDir = $_.Name
}
}
}
if (!$actualDistributionDir) {
Write-Error "Could not find Maven distribution directory in extracted archive"
}
Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir"
Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null
try {
Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null
} catch {
if (! (Test-Path -Path "$MAVEN_HOME" -PathType Container)) {
Write-Error "fail to move MAVEN_HOME"
}
} finally {
try { Remove-Item $TMP_DOWNLOAD_DIR -Recurse -Force | Out-Null }
catch { Write-Warning "Cannot remove $TMP_DOWNLOAD_DIR" }
}
Write-Output "MVN_CMD=$MAVEN_HOME/bin/$MVN_CMD"

151
backend/pom.xml Normal file
View File

@ -0,0 +1,151 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>4.0.3</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.21.1</version>
</dependency>
<dependency>
<groupId>tools.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>3.1.0</version>
</dependency>
</dependencies>
</dependencyManagement>
<groupId>se.urmo</groupId>
<artifactId>householdmanager</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>backend</name>
<description>backend</description>
<url/>
<licenses>
<license/>
</licenses>
<developers>
<developer/>
</developers>
<scm>
<connection/>
<developerConnection/>
<tag/>
<url/>
</scm>
<properties>
<java.version>21</java.version>
<jackson-databind-nullable.version>0.2.6</jackson-databind-nullable.version>
<swagger-annotations.version>2.2.22</swagger-annotations.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webmvc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>io.swagger.core.v3</groupId>
<artifactId>swagger-annotations</artifactId>
<version>${swagger-annotations.version}</version>
</dependency>
<dependency>
<groupId>org.openapitools</groupId>
<artifactId>jackson-databind-nullable</artifactId>
<version>${jackson-databind-nullable.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<annotationProcessorPaths>
<path>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</path>
</annotationProcessorPaths>
</configuration>
</plugin>
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>7.10.0</version>
<executions>
<execution>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>
${project.basedir}/src/main/resources/openapi/hemkoll-api.yml
</inputSpec>
<generatorName>spring</generatorName>
<library>spring-boot</library>
<apiPackage>se.urmo.householdmanager.api</apiPackage>
<modelPackage>se.urmo.householdmanager.model</modelPackage>
<invokerPackage>se.urmo.householdmanager.invoker</invokerPackage>
<configOptions>
<interfaceOnly>true</interfaceOnly>
<useSpringBoot3>true</useSpringBoot3>
<dateLibrary>java8</dateLibrary>
<useTags>false</useTags>
<openApiNullable>false</openApiNullable>
</configOptions>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>
</project>

13
backend/src/main/java/se/urmo/householdmanager/BackendApplication.java Normal file
View File

@ -0,0 +1,13 @@
package se.urmo.householdmanager;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class BackendApplication {
public static void main(String[] args) {
SpringApplication.run(BackendApplication.class, args);
}
}

15
backend/src/main/java/se/urmo/householdmanager/health/HealthController.java Normal file
View File

@ -0,0 +1,15 @@
package se.urmo.householdmanager.health;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.Map;
@RestController
public class HealthController {
@GetMapping("/health")
public Map<String, String> health() {
return Map.of("status", "ok");
}
}

53
backend/src/main/java/se/urmo/householdmanager/impl/TasksApiImpl.java Normal file
View File

@ -0,0 +1,53 @@
package se.urmo.householdmanager.impl;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.RestController;
import se.urmo.householdmanager.api.TasksApi;
import se.urmo.householdmanager.model.*;
import se.urmo.householdmanager.service.TaskService;
import java.util.List;
import java.util.NoSuchElementException;
@RestController
public class TasksApiImpl implements TasksApi {
private final TaskService taskService;
public TasksApiImpl(TaskService taskService) {
this.taskService = taskService;
}
@Override
public ResponseEntity<List<Task>> tasksGet() {
return ResponseEntity.ok(taskService.getAll());
}
@Override
public ResponseEntity<Task> tasksPost(TaskCreate taskCreate) {
return ResponseEntity.ok(taskService.create(taskCreate));
}
@Override
public ResponseEntity<Void> tasksIdPatch(Integer id, TaskUpdate taskUpdate) {
try {
taskService.update(id, taskUpdate);
return ResponseEntity.ok().build();
} catch (NoSuchElementException e) {
return ResponseEntity.notFound().build();
} catch (IllegalArgumentException e) {
return ResponseEntity.badRequest().build();
}
}
@Override
public ResponseEntity<Void> tasksIdDelete(Integer id) {
try {
taskService.delete(id);
return ResponseEntity.ok().build();
} catch (NoSuchElementException e) {
return ResponseEntity.notFound().build();
}
}
}

44
backend/src/main/java/se/urmo/householdmanager/impl/UsersApiImpl.java Normal file
View File

@ -0,0 +1,44 @@
package se.urmo.householdmanager.impl;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.RestController;
import se.urmo.householdmanager.api.UsersApi;
import se.urmo.householdmanager.model.LeaderboardEntry;
import se.urmo.householdmanager.model.User;
import se.urmo.householdmanager.model.UserCreate;
import se.urmo.householdmanager.service.TaskService;
import se.urmo.householdmanager.service.UserService;
import java.util.List;
@RestController
public class UsersApiImpl implements UsersApi {
private final UserService userService;
private final TaskService taskService;
public UsersApiImpl(UserService userService, TaskService taskService) {
this.userService = userService;
this.taskService = taskService;
}
@Override
public ResponseEntity<List<User>> usersGet() {
return ResponseEntity.ok(userService.getAll());
}
@Override
public ResponseEntity<User> usersPost(UserCreate userCreate) {
try {
return ResponseEntity.ok(userService.create(userCreate));
} catch (IllegalArgumentException e) {
return ResponseEntity.badRequest().build();
}
}
@Override
public ResponseEntity<List<LeaderboardEntry>> usersLeaderboardGet() {
return ResponseEntity.ok(userService.getLeaderboard(taskService.getAll()));
}
}

16
backend/src/main/java/se/urmo/householdmanager/service/TaskService.java Normal file
View File

@ -0,0 +1,16 @@
package se.urmo.householdmanager.service;
import se.urmo.householdmanager.model.*;
import java.util.List;
public interface TaskService {
List<Task> getAll();
Task create(TaskCreate request);
void update(Integer id, TaskUpdate update);
void delete(Integer id);
}

17
backend/src/main/java/se/urmo/householdmanager/service/UserService.java Normal file
View File

@ -0,0 +1,17 @@
package se.urmo.householdmanager.service;
import se.urmo.householdmanager.model.LeaderboardEntry;
import se.urmo.householdmanager.model.Task;
import se.urmo.householdmanager.model.User;
import se.urmo.householdmanager.model.UserCreate;
import java.util.List;
public interface UserService {
List<User> getAll();
User create(UserCreate request);
List<LeaderboardEntry> getLeaderboard(List<Task> tasks);
}

192
backend/src/main/java/se/urmo/householdmanager/service/impl/InMemoryTaskService.java Normal file
View File

@ -0,0 +1,192 @@
package se.urmo.householdmanager.service.impl;
import org.springframework.stereotype.Service;
import se.urmo.householdmanager.model.Task;
import se.urmo.householdmanager.model.TaskCreate;
import se.urmo.householdmanager.model.TaskStatus;
import se.urmo.householdmanager.model.TaskUpdate;
import se.urmo.householdmanager.service.TaskService;
import se.urmo.householdmanager.service.UserService;
import se.urmo.householdmanager.model.User;
import java.time.LocalDate;
import java.time.OffsetDateTime;
import java.util.ArrayList;
import java.util.List;
import java.util.NoSuchElementException;
import java.util.Optional;
import java.util.concurrent.atomic.AtomicInteger;
@Service
public class InMemoryTaskService implements TaskService {
private final List<Task> tasks = new ArrayList<>();
private final AtomicInteger idCounter = new AtomicInteger();
private final UserService userService;
public InMemoryTaskService(UserService userService) {
this.userService = userService;
}
@Override
public List<Task> getAll() {
tasks.forEach(this::populateUserFields);
return tasks;
}
private void populateUserFields(Task task) {
if (task.getUserId() != null) {
Optional<User> userOpt = userService.getAll().stream()
.filter(u -> u.getId().equals(task.getUserId()))
.findFirst();
userOpt.ifPresent(user -> {
task.setUserName(user.getName());
task.setUserColor(user.getColor());
task.setUserAvatar(user.getAvatar());
});
} else {
task.setUserName(null);
task.setUserColor(null);
task.setUserAvatar(null);
}
}
@Override
public Task create(TaskCreate request) {
Task task = new Task();
task.setId(idCounter.incrementAndGet());
task.setTitle(request.getTitle());
task.setDescription(request.getDescription());
task.setStatus(
request.getStatus() != null
? request.getStatus()
: TaskStatus.PENDING
);
task.setPoints(request.getPoints() != null ? request.getPoints() : 0);
task.setUserId(request.getUserId());
task.setIsRecurring(request.getIsRecurring() != null && request.getIsRecurring());
task.setRecurrencePeriod(
request.getRecurrencePeriod()
);
task.setDueDate(
request.getDueDate()
);
task.setCreatedAt(OffsetDateTime.now());
populateUserFields(task);
tasks.add(task);
return task;
}
@Override
public void update(Integer id, TaskUpdate update) {
Task task = tasks.stream()
.filter(t -> t.getId().equals(id))
.findFirst()
.orElseThrow(() -> new NoSuchElementException("Task not found"));
// Update simple fields
if (update.getTitle() != null) {
task.setTitle(update.getTitle());
}
if (update.getDescription() != null) {
task.setDescription(update.getDescription());
}
if (update.getPoints() != null) {
task.setPoints(update.getPoints());
}
if (update.getIsRecurring() != null) {
task.setIsRecurring(update.getIsRecurring());
}
if (update.getRecurrencePeriod() != null) {
task.setRecurrencePeriod(update.getRecurrencePeriod());
}
if (update.getDueDate() != null) {
task.setDueDate(update.getDueDate());
}
// Handle assignment/unassignment
if (Boolean.TRUE.equals(update.getUnassignUser())) {
task.setUserId(null);
populateUserFields(task);
} else if (update.getUserId() != null) {
task.setUserId(update.getUserId());
populateUserFields(task);
}
// Update status and handle recurrence logic
if (update.getStatus() != null) {
TaskStatus newStatus = update.getStatus();
if (newStatus == TaskStatus.IN_PROGRESS && task.getUserId() == null) {
throw new IllegalArgumentException("Task must have user to be in_progress");
}
// Check if completing a recurring task
if (newStatus == TaskStatus.COMPLETED &&
task.getStatus() != TaskStatus.COMPLETED &&
Boolean.TRUE.equals(task.getIsRecurring())) {
createNextRecurringTask(task);
}
task.setStatus(newStatus);
}
}
private void createNextRecurringTask(Task completedTask) {
TaskCreate newTask = new TaskCreate();
newTask.setTitle(completedTask.getTitle());
newTask.setDescription(completedTask.getDescription());
newTask.setPoints(completedTask.getPoints());
// Unassign user for the new task
newTask.setUserId(null);
newTask.setIsRecurring(true);
newTask.setRecurrencePeriod(completedTask.getRecurrencePeriod());
newTask.setStatus(TaskStatus.PENDING);
if (completedTask.getDueDate() != null && completedTask.getRecurrencePeriod() != null) {
LocalDate oldDate = completedTask.getDueDate();
LocalDate newDate = oldDate;
switch (completedTask.getRecurrencePeriod()) {
case DAILY:
newDate = oldDate.plusDays(1);
break;
case WEEKLY:
newDate = oldDate.plusWeeks(1);
break;
case BIWEEKLY:
newDate = oldDate.plusWeeks(2);
break;
case MONTHLY:
newDate = oldDate.plusMonths(1);
break;
}
newTask.setDueDate(newDate);
}
create(newTask);
}
@Override
public void delete(Integer id) {
boolean removed = tasks.removeIf(t -> t.getId().equals(id));
if (!removed) {
throw new NoSuchElementException("Task not found");
}
}
}

76
backend/src/main/java/se/urmo/householdmanager/service/impl/InMemoryUserService.java Normal file
View File

@ -0,0 +1,76 @@
package se.urmo.householdmanager.service.impl;
import org.springframework.stereotype.Service;
import se.urmo.householdmanager.model.LeaderboardEntry;
import se.urmo.householdmanager.model.Task;
import se.urmo.householdmanager.model.TaskStatus;
import se.urmo.householdmanager.model.User;
import se.urmo.householdmanager.model.UserCreate;
import se.urmo.householdmanager.service.UserService;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.Map;
import java.util.concurrent.atomic.AtomicInteger;
import java.util.stream.Collectors;
@Service
public class InMemoryUserService implements UserService {
private final List<User> users = new ArrayList<>();
private final AtomicInteger idCounter = new AtomicInteger();
public InMemoryUserService() {
// No-arg constructor
}
@Override
public List<User> getAll() {
return users;
}
@Override
public User create(UserCreate request) {
boolean exists = users.stream()
.anyMatch(u -> u.getName().equalsIgnoreCase(request.getName()));
if (exists) {
throw new IllegalArgumentException("User already exists");
}
User user = new User();
user.setId(idCounter.incrementAndGet());
user.setName(request.getName());
user.setColor(request.getColor());
user.setAvatar(
request.getAvatar() != null
? request.getAvatar()
: "UserIcon"
);
users.add(user);
return user;
}
@Override
public List<LeaderboardEntry> getLeaderboard(List<Task> tasks) {
Map<Integer, Integer> userScores = tasks.stream()
.filter(task -> task.getStatus() == TaskStatus.COMPLETED && task.getUserId() != null)
.collect(Collectors.groupingBy(
task -> task.getUserId(),
Collectors.summingInt(task -> task.getPoints())
));
return getAll().stream()
.map(user -> {
LeaderboardEntry entry = new LeaderboardEntry();
entry.setUsername(user.getName());
entry.setTotalPoints(userScores.getOrDefault(user.getId(), 0));
return entry;
})
.sorted(Comparator.comparingInt(LeaderboardEntry::getTotalPoints).reversed())
.collect(Collectors.toList());
}
}

8
backend/src/main/resources/application.properties Normal file
View File

@ -0,0 +1,8 @@
spring.application.name=backend
server.port=8080
# Use context-path to prefix all generated API endpoints with /api as defined in the OpenAPI spec
server.servlet.context-path=/api
logging.level.root=DEBUG
management.endpoints.web.exposure.include=health,info

273
backend/src/main/resources/openapi/hemkoll-api.yml Normal file
View File

@ -0,0 +1,273 @@
openapi: 3.0.0
info:
title: HemKoll API
description: Backend API for the HemKoll household task management application.
version: 1.0.0
servers:
- url: /api
description: Local development server
paths:
/users:
get:
summary: List all users
description: Returns a list of all registered household members.
responses:
'200':
description: A list of users
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/User'
post:
summary: Create a new user
description: Registers a new household member with a name, color, and avatar.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserCreate'
responses:
'200':
description: User created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/User'
'400':
description: User already exists or validation failed
/users/leaderboard:
get:
summary: Get the leaderboard
description: Returns a list of users sorted by their total points.
responses:
'200':
description: A list of leaderboard entries
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/LeaderboardEntry'
/tasks:
get:
summary: List all tasks
description: Returns all tasks, including details about assigned users.
responses:
'200':
description: A list of tasks
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Task'
post:
summary: Create a new task
description: Adds a new task to the list.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TaskCreate'
responses:
'200':
description: Task created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/Task'
/tasks/{id}:
patch:
summary: Update a task
description: Updates specific fields of a task, such as status or assigned user.
parameters:
- name: id
in: path
required: true
description: The ID of the task to update
schema:
type: integer
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TaskUpdate'
responses:
'200':
description: Task updated successfully
'400':
description: Validation error (e.g., moving a task to 'in_progress' without a user)
'404':
description: Task not found
delete:
summary: Delete a task
description: Permanently removes a task from the system.
parameters:
- name: id
in: path
required: true
description: The ID of the task to delete
schema:
type: integer
responses:
'200':
description: Task deleted successfully
'404':
description: Task not found
components:
schemas:
User:
type: object
description: A household member.
properties:
id:
type: integer
description: Unique identifier for the user.
name:
type: string
description: The user's display name.
color:
type: string
description: Tailwind CSS background color class (e.g., 'bg-blue-500').
avatar:
type: string
description: The name of the avatar icon (e.g., 'Cat', 'Pizza').
default: UserIcon
UserCreate:
type: object
required:
- name
- color
properties:
name:
type: string
description: The user's display name.
color:
type: string
description: Tailwind CSS background color class.
avatar:
type: string
description: The name of the avatar icon.
default: UserIcon
Task:
type: object
description: A household chore or task.
properties:
id:
type: integer
description: Unique identifier for the task.
title:
type: string
description: Short title of the task.
description:
type: string
description: Detailed description of the task.
status:
$ref: '#/components/schemas/TaskStatus'
points:
type: integer
description: Reward points for completing the task.
user_id:
type: integer
description: ID of the assigned user.
user_name:
type: string
description: Name of the assigned user (joined from users table).
user_color:
type: string
description: Color of the assigned user.
user_avatar:
type: string
description: Avatar of the assigned user.
is_recurring:
type: boolean
description: Whether the task should repeat automatically.
recurrence_period:
$ref: '#/components/schemas/RecurrencePeriod'
due_date:
type: string
format: date
description: Deadline for the task.
created_at:
type: string
format: date-time
description: When the task was first created.
TaskCreate:
type: object
required:
- title
properties:
title:
type: string
description: Title of the task.
description:
type: string
description: Detailed description.
status:
$ref: '#/components/schemas/TaskStatus'
points:
type: integer
default: 0
user_id:
type: integer
is_recurring:
type: boolean
default: false
recurrence_period:
$ref: '#/components/schemas/RecurrencePeriod'
due_date:
type: string
format: date
TaskUpdate:
type: object
description: Fields that can be updated on a task.
properties:
title:
type: string
description:
type: string
status:
$ref: '#/components/schemas/TaskStatus'
points:
type: integer
user_id:
type: integer
unassign_user:
type: boolean
default: false
is_recurring:
type: boolean
recurrence_period:
$ref: '#/components/schemas/RecurrencePeriod'
due_date:
type: string
format: date
LeaderboardEntry:
type: object
properties:
username:
type: string
totalPoints:
type: integer
RecurrencePeriod:
type: string
enum: [ daily, weekly, biweekly, monthly ]
TaskStatus:
type: string
enum: [ pending, in_progress, completed ]

13
backend/src/test/java/se/urmo/householdmanager/BackendApplicationTests.java Normal file
View File

@ -0,0 +1,13 @@
package se.urmo.householdmanager;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
@SpringBootTest
class BackendApplicationTests {
@Test
void contextLoads() {
}
}

17
backend/task.http Normal file
View File

@ -0,0 +1,17 @@
### Create a task
POST http://localhost:8080/api/tasks
Content-Type: application/json
{
"title": "Clean the kitchen",
"points": 10,
"status": "väntande",
"recurrence": "weekly",
"dueDate": "2026-03-01"
}
### Retrieve all tasks
GET http://localhost:8080/api/tasks
### Retrieve all tasks
GET http://localhost:8080/api/health

12
backend/user.http Normal file
View File

@ -0,0 +1,12 @@
### Create a user
POST http://localhost:8080/api/users
Content-Type: application/json
{
"name": "John Doe",
"avatar": "https://api.dicebear.com/7.x/avataaars/svg?seed=John"
}
### Fetch users
GET http://localhost:8080/api/users