feat: Update entity types to include specific ID types and adjust DTO mappings

backend/cmd/api/main.go

@@ -0,0 +1,38 @@
+package main
+
+import (
+	"fmt"
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+	swaggerFiles "github.com/swaggo/files"
+	ginSwagger "github.com/swaggo/gin-swagger"
+
+	_ "github.com/timetracker/backend/docs" // This line is important for swag to work
+)
+
+// @title Time Tracker API
+// @version 1.0
+// @description This is a simple time tracker API.
+// @host localhost:8080
+// @BasePath /
+
+// @Summary Say hello
+// @Description Get a hello message
+// @ID hello
+// @Produce  plain
+// @Success 200 {string} string "Hello from the Time Tracker Backend!"
+// @Router / [get]
+func helloHandler(c *gin.Context) {
+	c.String(http.StatusOK, "Hello from the Time Tracker Backend!")
+}
+
+func main() {
+	r := gin.Default()
+
+	r.GET("/", helloHandler)
+	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
+
+	fmt.Println("Server listening on port 8080")
+	r.Run(":8080") // Use Gin's Run method
+}

backend/docs/docs.go

@@ -0,0 +1,55 @@
+// Package docs Code generated by swaggo/swag. DO NOT EDIT
+package docs
+
+import "github.com/swaggo/swag"
+
+const docTemplate = `{
+    "schemes": {{ marshal .Schemes }},
+    "swagger": "2.0",
+    "info": {
+        "description": "{{escape .Description}}",
+        "title": "{{.Title}}",
+        "contact": {},
+        "version": "{{.Version}}"
+    },
+    "host": "{{.Host}}",
+    "basePath": "{{.BasePath}}",
+    "paths": {
+        "/": {
+            "get": {
+                "description": "Get a hello message",
+                "produces": [
+                    "text/plain"
+                ],
+                "summary": "Say hello",
+                "operationId": "hello",
+                "responses": {
+                    "200": {
+                        "description": "Hello from the Time Tracker Backend!",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        }
+    }
+}`
+
+// SwaggerInfo holds exported Swagger Info so clients can modify it
+var SwaggerInfo = &swag.Spec{
+	Version:          "1.0",
+	Host:             "localhost:8080",
+	BasePath:         "/",
+	Schemes:          []string{},
+	Title:            "Time Tracker API",
+	Description:      "This is a simple time tracker API.",
+	InfoInstanceName: "swagger",
+	SwaggerTemplate:  docTemplate,
+	LeftDelim:        "{{",
+	RightDelim:       "}}",
+}
+
+func init() {
+	swag.Register(SwaggerInfo.InstanceName(), SwaggerInfo)
+}

backend/docs/swagger.json

@@ -0,0 +1,31 @@
+{
+    "swagger": "2.0",
+    "info": {
+        "description": "This is a simple time tracker API.",
+        "title": "Time Tracker API",
+        "contact": {},
+        "version": "1.0"
+    },
+    "host": "localhost:8080",
+    "basePath": "/",
+    "paths": {
+        "/": {
+            "get": {
+                "description": "Get a hello message",
+                "produces": [
+                    "text/plain"
+                ],
+                "summary": "Say hello",
+                "operationId": "hello",
+                "responses": {
+                    "200": {
+                        "description": "Hello from the Time Tracker Backend!",
+                        "schema": {
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

backend/docs/swagger.yaml

@@ -0,0 +1,21 @@
+basePath: /
+host: localhost:8080
+info:
+  contact: {}
+  description: This is a simple time tracker API.
+  title: Time Tracker API
+  version: "1.0"
+paths:
+  /:
+    get:
+      description: Get a hello message
+      operationId: hello
+      produces:
+      - text/plain
+      responses:
+        "200":
+          description: Hello from the Time Tracker Backend!
+          schema:
+            type: string
+      summary: Say hello
+swagger: "2.0"

backend/go.mod

@@ -0,0 +1,47 @@
+module github.com/timetracker/backend
+
+go 1.23.6
+
+require (
+	github.com/gin-gonic/gin v1.10.0
+	github.com/oklog/ulid/v2 v2.1.0
+	github.com/swaggo/files v1.0.1
+	github.com/swaggo/gin-swagger v1.6.0
+	github.com/swaggo/swag v1.16.4
+)
+
+require (
+	github.com/KyleBanks/depth v1.2.1 // indirect
+	github.com/bytedance/sonic v1.13.1 // indirect
+	github.com/bytedance/sonic/loader v0.2.4 // indirect
+	github.com/cloudwego/base64x v0.1.5 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.8 // indirect
+	github.com/gin-contrib/sse v1.0.0 // indirect
+	github.com/go-openapi/jsonpointer v0.21.0 // indirect
+	github.com/go-openapi/jsonreference v0.21.0 // indirect
+	github.com/go-openapi/spec v0.21.0 // indirect
+	github.com/go-openapi/swag v0.23.0 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-playground/validator/v10 v10.25.0 // indirect
+	github.com/goccy/go-json v0.10.5 // indirect
+	github.com/josharian/intern v1.0.0 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/mailru/easyjson v0.9.0 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.3 // indirect
+	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
+	github.com/ugorji/go/codec v1.2.12 // indirect
+	golang.org/x/arch v0.15.0 // indirect
+	golang.org/x/crypto v0.36.0 // indirect
+	golang.org/x/net v0.37.0 // indirect
+	golang.org/x/sys v0.31.0 // indirect
+	golang.org/x/text v0.23.0 // indirect
+	golang.org/x/tools v0.31.0 // indirect
+	google.golang.org/protobuf v1.36.5 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

backend/go.sum

@@ -0,0 +1,149 @@
+github.com/KyleBanks/depth v1.2.1 h1:5h8fQADFrWtarTdtDudMmGsC7GPbOAu6RVB3ffsVFHc=
+github.com/KyleBanks/depth v1.2.1/go.mod h1:jzSb9d0L43HxTQfT+oSA1EEp2q+ne2uh6XgeJcm8brE=
+github.com/bytedance/sonic v1.13.1 h1:Jyd5CIvdFnkOWuKXr+wm4Nyk2h0yAFsr8ucJgEasO3g=
+github.com/bytedance/sonic v1.13.1/go.mod h1:o68xyaF9u2gvVBuGHPlUVCy+ZfmNNO5ETf1+KgkJhz4=
+github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
+github.com/bytedance/sonic/loader v0.2.4 h1:ZWCw4stuXUsn1/+zQDqeE7JKP+QO47tz7QCNan80NzY=
+github.com/bytedance/sonic/loader v0.2.4/go.mod h1:N8A3vUdtUebEY2/VQC0MyhYeKUFosQU6FxH2JmUe6VI=
+github.com/cloudwego/base64x v0.1.5 h1:XPciSp1xaq2VCSt6lF0phncD4koWyULpl5bUxbfCyP4=
+github.com/cloudwego/base64x v0.1.5/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
+github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/gabriel-vasile/mimetype v1.4.8 h1:FfZ3gj38NjllZIeJAmMhr+qKL8Wu+nOoI3GqacKw1NM=
+github.com/gabriel-vasile/mimetype v1.4.8/go.mod h1:ByKUIKGjh1ODkGM1asKUbQZOLGrPjydw3hYPU2YU9t8=
+github.com/gin-contrib/gzip v0.0.6 h1:NjcunTcGAj5CO1gn4N8jHOSIeRFHIbn51z6K+xaN4d4=
+github.com/gin-contrib/gzip v0.0.6/go.mod h1:QOJlmV2xmayAjkNS2Y8NQsMneuRShOU/kjovCXNuzzk=
+github.com/gin-contrib/sse v1.0.0 h1:y3bT1mUWUxDpW4JLQg/HnTqV4rozuW4tC9eFKTxYI9E=
+github.com/gin-contrib/sse v1.0.0/go.mod h1:zNuFdwarAygJBht0NTKiSi3jRf6RbqeILZ9Sp6Slhe0=
+github.com/gin-gonic/gin v1.10.0 h1:nTuyha1TYqgedzytsKYqna+DfLos46nTv2ygFy86HFU=
+github.com/gin-gonic/gin v1.10.0/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
+github.com/go-openapi/jsonpointer v0.21.0 h1:YgdVicSA9vH5RiHs9TZW5oyafXZFc6+2Vc1rr/O9oNQ=
+github.com/go-openapi/jsonpointer v0.21.0/go.mod h1:IUyH9l/+uyhIYQ/PXVA41Rexl+kOkAPDdXEYns6fzUY=
+github.com/go-openapi/jsonreference v0.21.0 h1:Rs+Y7hSXT83Jacb7kFyjn4ijOuVGSvOdF2+tg1TRrwQ=
+github.com/go-openapi/jsonreference v0.21.0/go.mod h1:LmZmgsrTkVg9LG4EaHeY8cBDslNPMo06cago5JNLkm4=
+github.com/go-openapi/spec v0.21.0 h1:LTVzPc3p/RzRnkQqLRndbAzjY0d0BCL72A6j3CdL9ZY=
+github.com/go-openapi/spec v0.21.0/go.mod h1:78u6VdPw81XU44qEWGhtr982gJ5BWg2c0I5XwVMotYk=
+github.com/go-openapi/swag v0.23.0 h1:vsEVJDUo2hPJ2tu0/Xc+4noaxyEffXNIs3cOULZ+GrE=
+github.com/go-openapi/swag v0.23.0/go.mod h1:esZ8ITTYEsH1V2trKHjAN8Ai7xHb8RV+YSZ577vPjgQ=
+github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
+github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
+github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
+github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
+github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
+github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
+github.com/go-playground/validator/v10 v10.25.0 h1:5Dh7cjvzR7BRZadnsVOzPhWsrwUr0nmsZJxEAnFLNO8=
+github.com/go-playground/validator/v10 v10.25.0/go.mod h1:GGzBIJMuE98Ic/kJsBXbz1x/7cByt++cQ+YOuDM5wus=
+github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4=
+github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/josharian/intern v1.0.0 h1:vlS4z54oSdjm0bgjRigI+G1HpF+tI+9rE5LLzOg8HmY=
+github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
+github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
+github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
+github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
+github.com/mailru/easyjson v0.9.0 h1:PrnmzHw7262yW8sTBwxi1PdJA3Iw/EKBa8psRf7d9a4=
+github.com/mailru/easyjson v0.9.0/go.mod h1:1+xMtQp2MRNVL/V1bOzuP3aP8VNwRW55fQUto+XFtTU=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
+github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/oklog/ulid/v2 v2.1.0 h1:+9lhoxAP56we25tyYETBBY1YLA2SaoLvUFgrP2miPJU=
+github.com/oklog/ulid/v2 v2.1.0/go.mod h1:rcEKHmBBKfef9DhnvX7y1HZBYxjXb0cP5ExxNsTT1QQ=
+github.com/pborman/getopt v0.0.0-20170112200414-7148bc3a4c30/go.mod h1:85jBQOZwpVEaDAr341tbn15RS4fCAsIst0qp7i8ex1o=
+github.com/pelletier/go-toml/v2 v2.2.3 h1:YmeHyLY8mFWbdkNWwpr+qIL2bEqT0o95WSdkNHvL12M=
+github.com/pelletier/go-toml/v2 v2.2.3/go.mod h1:MfCQTFTvCcUyyvvwm1+G6H/jORL20Xlb6rzQu9GuUkc=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M=
+github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
+github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
+github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
+github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/swaggo/files v1.0.1 h1:J1bVJ4XHZNq0I46UU90611i9/YzdrF7x92oX1ig5IdE=
+github.com/swaggo/files v1.0.1/go.mod h1:0qXmMNH6sXNf+73t65aKeB+ApmgxdnkQzVTAj2uaMUg=
+github.com/swaggo/gin-swagger v1.6.0 h1:y8sxvQ3E20/RCyrXeFfg60r6H0Z+SwpTjMYsMm+zy8M=
+github.com/swaggo/gin-swagger v1.6.0/go.mod h1:BG00cCEy294xtVpyIAHG6+e2Qzj/xKlRdOqDkvq0uzo=
+github.com/swaggo/swag v1.16.4 h1:clWJtd9LStiG3VeijiCfOVODP6VpHtKdQy9ELFG3s1A=
+github.com/swaggo/swag v1.16.4/go.mod h1:VBsHJRsDvfYvqoiMKnsdwhNV9LEMHgEDZcyVYX0sxPg=
+github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
+github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
+github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
+github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
+golang.org/x/arch v0.15.0 h1:QtOrQd0bTUnhNVNndMpLHNWrDmYzZ2KDqSrEymqInZw=
+golang.org/x/arch v0.15.0/go.mod h1:JmwW7aLIoRUKgaTzhkiEFxvcEiQGyOg9BMonBJUS7EE=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
+golang.org/x/crypto v0.36.0 h1:AnAEvhDddvBdpY+uR+MyHmuZzzNqXSe/GvuDeob5L34=
+golang.org/x/crypto v0.36.0/go.mod h1:Y4J0ReaxCR1IMaabaSMugxJES1EpwhBHhv2bDHklZvc=
+golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
+golang.org/x/mod v0.24.0 h1:ZfthKaKaT4NrhGVZHO1/WDTwGES4De8KtWO0SIbNJMU=
+golang.org/x/mod v0.24.0/go.mod h1:IXM97Txy2VM4PJ3gI61r1YEk/gAj6zAHN3AdZt6S9Ww=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
+golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c=
+golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
+golang.org/x/net v0.37.0 h1:1zLorHbz+LYj7MQlSf1+2tPIIgibq2eL5xkrGk6f+2c=
+golang.org/x/net v0.37.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.12.0 h1:MHc5BpPuC30uJk597Ri8TV3CNZcTLu6B6z4lJy+g6Jw=
+golang.org/x/sync v0.12.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.31.0 h1:ioabZlmFYtWhL+TRYpcnNlLwhyxaM9kWTDEmfnprqik=
+golang.org/x/sys v0.31.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
+golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
+golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
+golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
+golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
+golang.org/x/text v0.23.0 h1:D71I7dUrlY+VX0gQShAThNGHFxZ13dGLBHQLVl1mJlY=
+golang.org/x/text v0.23.0/go.mod h1:/BLNzu4aZCJ1+kcD0DNRotWKage4q2rGVAg4o22unh4=
+golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
+golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=
+golang.org/x/tools v0.31.0 h1:0EedkvKDbh+qistFTd0Bcwe/YLh4vHwWEkiI0toFIBU=
+golang.org/x/tools v0.31.0/go.mod h1:naFTU+Cev749tSJRXJlna0T3WxKvb1kWEx15xA4SdmQ=
+golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+google.golang.org/protobuf v1.36.5 h1:tPhr+woSbjfYvY6/GPufUoYizxw1cF/yFoxJ2fmpwlM=
+google.golang.org/protobuf v1.36.5/go.mod h1:9fA7Ob0pmnwhb644+1+CVWFRbNajQ6iRojtC/QF5bRE=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=

backend/internal/domain/entities/activity.go

@@ -0,0 +1,22 @@
+package entities
+
+import (
+	"github.com/oklog/ulid/v2"
+)
+
+type Activity struct {
+	EntityBase
+	Name        string
+	BillingRate float64
+}
+
+type ActivityUpdate struct {
+	ID          ulid.ULID
+	Name        *string
+	BillingRate *float64
+}
+
+type ActivityCreate struct {
+	Name        string
+	BillingRate float64
+}

backend/internal/domain/entities/base.go

@@ -0,0 +1,14 @@
+package entities
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type EntityBase struct {
+	ID           ulid.ULID
+	CreatedAt    time.Time
+	UpdatedAt    time.Time
+	LastEditorID ulid.ULID
+}

backend/internal/domain/entities/company.go

@@ -0,0 +1,17 @@
+package entities
+
+import "github.com/oklog/ulid/v2"
+
+type Company struct {
+	EntityBase
+	Name string
+}
+
+type CompanyCreate struct {
+	Name string
+}
+
+type CompanyUpdate struct {
+	ID   ulid.ULID
+	Name *string
+}

backend/internal/domain/entities/customer.go

@@ -0,0 +1,20 @@
+package entities
+
+import "github.com/oklog/ulid/v2"
+
+type Customer struct {
+	EntityBase
+	Name      string
+	CompanyID int
+}
+
+type CustomerCreate struct {
+	Name      string
+	CompanyID int
+}
+
+type CustomerUpdate struct {
+	ID        ulid.ULID
+	Name      *string
+	CompanyID *int
+}

backend/internal/domain/entities/project.go

@@ -0,0 +1,20 @@
+package entities
+
+import "github.com/oklog/ulid/v2"
+
+type Project struct {
+	EntityBase
+	Name       string
+	CustomerID int
+}
+
+type ProjectCreate struct {
+	Name       string
+	CustomerID int
+}
+
+type ProjectUpdate struct {
+	ID         ulid.ULID
+	Name       *string
+	CustomerID *int
+}

backend/internal/domain/entities/timeentry.go

@@ -0,0 +1,39 @@
+package entities
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type TimeEntry struct {
+	EntityBase
+	UserID      int
+	ProjectID   int
+	ActivityID  int
+	Start       time.Time
+	End         time.Time
+	Description string
+	Billable    int // Percentage (0-100)
+}
+
+type TimeEntryCreate struct {
+	UserID      int
+	ProjectID   int
+	ActivityID  int
+	Start       time.Time
+	End         time.Time
+	Description string
+	Billable    int // Percentage (0-100)
+}
+
+type TimeEntryUpdate struct {
+	ID          ulid.ULID
+	UserID      *int
+	ProjectID   *int
+	ActivityID  *int
+	Start       *time.Time
+	End         *time.Time
+	Description *string
+	Billable    *int // Percentage (0-100)
+}

backend/internal/domain/entities/user.go

@@ -0,0 +1,29 @@
+package entities
+
+import "github.com/oklog/ulid/v2"
+
+type User struct {
+	EntityBase
+	Username   string
+	Password   string
+	Role       string
+	CompanyID  int
+	HourlyRate float64
+}
+
+type UserCreate struct {
+	Username   string
+	Password   string
+	Role       string
+	CompanyID  int
+	HourlyRate float64
+}
+
+type UserUpdate struct {
+	ID         ulid.ULID
+	Username   *string
+	Password   *string
+	Role       *string
+	CompanyID  *int
+	HourlyRate *float64
+}

backend/internal/interfaces/http/dto/activity_dto.go

@@ -0,0 +1,30 @@
+package dto
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type ActivityDto struct {
+	ID           ulid.ULID `json:"id"`
+	CreatedAt    time.Time `json:"createdAt"`
+	UpdatedAt    time.Time `json:"updatedAt"`
+	LastEditorID ulid.ULID `json:"lastEditorID"`
+	Name         string    `json:"name"`
+	BillingRate  float64   `json:"billingRate"`
+}
+
+type ActivityCreateDto struct {
+	Name        string  `json:"name"`
+	BillingRate float64 `json:"billingRate"`
+}
+
+type ActivityUpdateDto struct {
+	ID           ulid.ULID  `json:"id"`
+	CreatedAt    *time.Time `json:"createdAt"`
+	UpdatedAt    *time.Time `json:"updatedAt"`
+	LastEditorID *ulid.ULID `json:"lastEditorID"`
+	Name         *string    `json:"name"`
+	BillingRate  *float64   `json:"billingRate"`
+}

backend/internal/interfaces/http/dto/company_dto.go

@@ -0,0 +1,27 @@
+package dto
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type CompanyDto struct {
+	ID           ulid.ULID `json:"id"`
+	CreatedAt    time.Time `json:"createdAt"`
+	UpdatedAt    time.Time `json:"updatedAt"`
+	LastEditorID ulid.ULID `json:"lastEditorID"`
+	Name         string    `json:"name"`
+}
+
+type CompanyCreateDto struct {
+	Name string `json:"name"`
+}
+
+type CompanyUpdateDto struct {
+	ID           ulid.ULID  `json:"id"`
+	CreatedAt    *time.Time `json:"createdAt"`
+	UpdatedAt    *time.Time `json:"updatedAt"`
+	LastEditorID *ulid.ULID `json:"lastEditorID"`
+	Name         *string    `json:"name"`
+}

backend/internal/interfaces/http/dto/customer_dto.go

@@ -0,0 +1,30 @@
+package dto
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type CustomerDto struct {
+	ID           ulid.ULID `json:"id"`
+	CreatedAt    time.Time `json:"createdAt"`
+	UpdatedAt    time.Time `json:"updatedAt"`
+	LastEditorID ulid.ULID `json:"lastEditorID"`
+	Name         string    `json:"name"`
+	CompanyID    int       `json:"companyId"`
+}
+
+type CustomerCreateDto struct {
+	Name      string `json:"name"`
+	CompanyID int    `json:"companyId"`
+}
+
+type CustomerUpdateDto struct {
+	ID           ulid.ULID  `json:"id"`
+	CreatedAt    *time.Time `json:"createdAt"`
+	UpdatedAt    *time.Time `json:"updatedAt"`
+	LastEditorID *ulid.ULID `json:"lastEditorID"`
+	Name         *string    `json:"name"`
+	CompanyID    *int       `json:"companyId"`
+}

backend/internal/interfaces/http/dto/project_dto.go

@@ -0,0 +1,30 @@
+package dto
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type ProjectDto struct {
+	ID           ulid.ULID `json:"id"`
+	CreatedAt    time.Time `json:"createdAt"`
+	UpdatedAt    time.Time `json:"updatedAt"`
+	LastEditorID ulid.ULID `json:"lastEditorID"`
+	Name         string    `json:"name"`
+	CustomerID   int       `json:"customerId"`
+}
+
+type ProjectCreateDto struct {
+	Name       string `json:"name"`
+	CustomerID int    `json:"customerId"`
+}
+
+type ProjectUpdateDto struct {
+	ID           ulid.ULID  `json:"id"`
+	CreatedAt    *time.Time `json:"createdAt"`
+	UpdatedAt    *time.Time `json:"updatedAt"`
+	LastEditorID *ulid.ULID `json:"lastEditorID"`
+	Name         *string    `json:"name"`
+	CustomerID   *int       `json:"customerId"`
+}

backend/internal/interfaces/http/dto/timeentry_dto.go

@@ -0,0 +1,45 @@
+package dto
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type TimeEntryDto struct {
+	ID           ulid.ULID `json:"id"`
+	CreatedAt    time.Time `json:"createdAt"`
+	UpdatedAt    time.Time `json:"updatedAt"`
+	LastEditorID ulid.ULID `json:"lastEditorID"`
+	UserID       int       `json:"userId"`
+	ProjectID    int       `json:"projectId"`
+	ActivityID   int       `json:"activityId"`
+	Start        time.Time `json:"start"`
+	End          time.Time `json:"end"`
+	Description  string    `json:"description"`
+	Billable     int       `json:"billable"` // Percentage (0-100)
+}
+
+type TimeEntryCreateDto struct {
+	UserID      int       `json:"userId"`
+	ProjectID   int       `json:"projectId"`
+	ActivityID  int       `json:"activityId"`
+	Start       time.Time `json:"start"`
+	End         time.Time `json:"end"`
+	Description string    `json:"description"`
+	Billable    int       `json:"billable"` // Percentage (0-100)
+}
+
+type TimeEntryUpdateDto struct {
+	ID           ulid.ULID  `json:"id"`
+	CreatedAt    *time.Time `json:"createdAt"`
+	UpdatedAt    *time.Time `json:"updatedAt"`
+	LastEditorID *ulid.ULID `json:"lastEditorID"`
+	UserID       *int       `json:"userId"`
+	ProjectID    *int       `json:"projectId"`
+	ActivityID   *int       `json:"activityId"`
+	Start        *time.Time `json:"start"`
+	End          *time.Time `json:"end"`
+	Description  *string    `json:"description"`
+	Billable     *int       `json:"billable"` // Percentage (0-100)
+}

backend/internal/interfaces/http/dto/user_dto.go

@@ -0,0 +1,39 @@
+package dto
+
+import (
+	"time"
+
+	"github.com/oklog/ulid/v2"
+)
+
+type UserDto struct {
+	ID           ulid.ULID `json:"id"`
+	CreatedAt    time.Time `json:"createdAt"`
+	UpdatedAt    time.Time `json:"updatedAt"`
+	LastEditorID ulid.ULID `json:"lastEditorID"`
+	Username     string    `json:"username"`
+	Password     string    `json:"password"` // Note: In a real application, you would NEVER send the password in a DTO. This is just for demonstration.
+	Role         string    `json:"role"`
+	CompanyID    int       `json:"companyId"`
+	HourlyRate   float64   `json:"hourlyRate"`
+}
+
+type UserCreateDto struct {
+	Username   string  `json:"username"`
+	Password   string  `json:"password"` // Note: In a real application, you would NEVER send the password in a DTO. This is just for demonstration.
+	Role       string  `json:"role"`
+	CompanyID  int     `json:"companyId"`
+	HourlyRate float64 `json:"hourlyRate"`
+}
+
+type UserUpdateDto struct {
+	ID           ulid.ULID  `json:"id"`
+	CreatedAt    *time.Time `json:"createdAt"`
+	UpdatedAt    *time.Time `json:"updatedAt"`
+	LastEditorID *ulid.ULID `json:"lastEditorID"`
+	Username     *string    `json:"username"`
+	Password     *string    `json:"password"` // Note: In a real application, you would NEVER send the password in a DTO. This is just for demonstration.
+	Role         *string    `json:"role"`
+	CompanyID    *int       `json:"companyId"`
+	HourlyRate   *float64   `json:"hourlyRate"`
+}

backend/tygo.yml

@@ -0,0 +1,6 @@
+packages:
+  - path: github.com/timetracker/backend/internal/interfaces/http/dto
+    type_mappings:
+      "time.Time": "string"
+      "ulid.ULID": "string"
+    output_path: ../frontend/src/types/dto.ts

docu/README.md

@@ -13,6 +13,8 @@ This document provides an overview of the Time Tracking and Management System. F
 - [Extensibility and Integrations](extensibility_integrations.md)
 - [LLM Guidance](llm_guidance.md)
 - [Roadmap](Roadmap.md)
+- [Domain Types](domain_types.md)
+- [DTOs](dtos.md)
 
 ## Code Examples
 - [GORM Entities](code_examples/gorm_entities.go)

docu/database_schema.md

@@ -13,6 +13,40 @@ CREATE TABLE companies (
     updated_at TIMESTAMP NOT NULL DEFAULT NOW()
 );
 
+-- Go structs for creating and updating customers
+-- type CustomerCreate struct {
+-- 	Name      string
+-- 	CompanyID int
+-- }
+
+-- type CustomerUpdate struct {
+-- 	ID        ulid.ULID
+-- 	Name      *string
+-- 	CompanyID *int
+-- }
+
+-- Go structs for creating and updating companies
+-- type CompanyCreate struct {
+-- 	Name string
+-- }
+
+-- type CompanyUpdate struct {
+-- 	ID   ulid.ULID
+-- 	Name *string
+-- }
+
+-- Go structs for creating and updating activities
+-- type ActivityCreate struct {
+-- 	Name        string
+-- 	BillingRate float64
+-- }
+
+-- type ActivityUpdate struct {
+-- 	ID          ulid.ULID
+-- 	Name        *string
+-- 	BillingRate *float64
+-- }
+
 -- Users and Roles
 CREATE TABLE roles (
     id SERIAL PRIMARY KEY,

docu/domain_types.md

@@ -0,0 +1,27 @@
+# Domain Types
+
+This document describes the domain types used in the Time Tracker application. Domain types represent the core business concepts and are used throughout the application.
+
+## Activity
+
+The `Activity` type represents a specific activity that can be tracked, such as "Development", "Meeting", or "Bug Fixing".
+
+## Company
+
+The `Company` type represents a tenant in the multi-tenant application. Each company has its own set of users, customers, projects, and activities.
+
+## Customer
+
+The `Customer` type represents a customer of a company.
+
+## Project
+
+The `Project` type represents a project for a specific customer.
+
+## TimeEntry
+
+The `TimeEntry` type represents a time booking for a specific user, project, and activity.
+
+## User
+
+The `User` type represents a user of the application. Each user belongs to a company and has a specific role.

docu/draft/additions/claude.md

@@ -1,93 +0,0 @@
-# Ergänzung zur Zeiterfassungstool Spezifikation
-
-## 10. Datensicherheit und Datenschutz
-
-### Sicherheitsmaßnahmen
-- **Verschlüsselung**: TLS für alle Verbindungen, Verschlüsselung sensibler Daten in der Datenbank
-- **Tenant-Isolation**: Strikte Trennung der Daten zwischen verschiedenen Companies
-- **Audit-Trail**: Lückenlose Protokollierung aller relevanten Systemaktivitäten
-- **DSGVO-Konformität**: Implementierung von Datenschutzfunktionen (Recht auf Vergessen, Datenexport)
-
-## 11. Deployment und DevOps
-
-### Containerisierung
-- Docker-Container für Backend und Frontend
-- Docker-Compose für Entwicklungsumgebung
-- Kubernetes-Manifest für Produktionsumgebung
-
-### CI/CD-Pipeline
-- Automatisierte Tests (Unit, Integration, E2E)
-- Automatisiertes Deployment
-- Versionsmanagement
-
-### Monitoring und Logging
-- Prometheus für Metriken
-- Grafana für Visualisierung
-- ELK-Stack oder ähnliches für Logging
-- Alerting bei kritischen Ereignissen
-
-## 12. Backup und Recovery
-
-- Regelmäßige Datenbank-Backups
-- Point-in-Time-Recovery
-- Disaster-Recovery-Plan
-
-## 13. Offline-Funktionalität
-
-- Progressive Web App (PWA) Funktionalitäten
-- Lokale Speicherung von Zeitbuchungen bei fehlender Internetverbindung
-- Synchronisation bei Wiederherstellung der Verbindung
-
-## 14. Integrationen
-
-### API-Integrationen
-- **Abrechnungssysteme**: Export von Abrechnungsdaten
-- **Kalendersysteme**: Synchronisation mit Google Calendar, Outlook, etc.
-- **Projektmanagementtools**: Jira, Trello, etc. (insbesondere für Version 2)
-- **Webhooks**: Für benutzerdefinierte Integrationen
-
-### Single Sign-On (SSO)
-- Integration mit gängigen Identity Providern (Google, Microsoft, SAML)
-- OAuth 2.0 / OpenID Connect
-
-## 15. Erweiterbarkeit
-
-### Plugin-System
-- Möglichkeit zur Erweiterung durch Plugins
-- Hooks für benutzerdefinierte Logik
-
-### Custom Fields
-- Erweiterbare Datenmodelle mit benutzerdefinierten Feldern
-- Anpassbare Formulare
-
-## 16. Mobile App-Unterstützung
-
-- Responsive Webdesign für mobile Browser
-- Native Mobile Apps (zukünftige Erweiterung)
-- API-Design mit Mobilnutzung im Blick
-
-## 17. Internationalisierung und Lokalisierung
-
-- Mehrsprachige Benutzeroberfläche
-- Lokalisierte Datums- und Zeitformate
-- Währungsumrechnung
-
-## 18. Abrechnung und Fakturierung
-
-- Generierung von Rechnungsentwürfen basierend auf Zeitbuchungen
-- Export von Abrechnungsdaten in verschiedenen Formaten (CSV, Excel, etc.)
-- Automatisierte Erinnerungen für nicht erfasste Zeiten
-
-## 19. Benachrichtigungssystem
-
-- E-Mail-Benachrichtigungen
-- In-App-Benachrichtigungen
-- Erinnerungen für ausstehende Zeiterfassungen
-- Genehmigungsanfragen
-
-## 20. Analytics und Business Intelligence
-
-- Erweiterte Analytik für Management-Insights
-- Trendanalysen und Prognosen
-- Ressourcenauslastung und -planung
-- Exportmöglichkeiten für BI-Tools

docu/draft/additions/gpt.md

@@ -1,22 +0,0 @@
-Folgende Punkte könnten sinnvoll ergänzt werden:
-
-- **Audit-Logs**: 
-  - Protokollierung wichtiger Aktionen (z.B. Änderungen an Stammdaten, Rollenänderungen).
-
-- **Benachrichtigungen**:
-  - E-Mail/Push bei wichtigen Ereignissen (z.B. Abweichungen, Freigaben).
-
-- **Fehlerbehandlung & Validierung**:
-  - Einheitliche Strategie für API-Fehler und Client-seitige Validierungen.
-
-- **Internationale Lokalisierung (i18n)**:
-  - Unterstützung mehrerer Sprachen für UI-Texte und Berichte.
-
-- **Performance & Skalierung**:
-  - Caching-Strategien (z.B. Redis).
-  - Indexing-Strategien für effiziente Queries.
-
-- **Backup & Restore-Konzept**:
-  - Regelmäßige Backups und Wiederherstellungsszenarien.
-
-Möchtest du davon etwas in die Spezifikation übernehmen?

docu/draft/additions/grok.md

@@ -1,93 +0,0 @@
-# Ergänzung zur Zeiterfassungstool Spezifikation
-
-## 10. Datensicherheit und Datenschutz
-
-### Sicherheitsmaßnahmen
-- **Verschlüsselung**: TLS für alle Verbindungen, Verschlüsselung sensibler Daten in der Datenbank
-- **Tenant-Isolation**: Strikte Trennung der Daten zwischen verschiedenen Companies
-- **Audit-Trail**: Lückenlose Protokollierung aller relevanten Systemaktivitäten
-- **DSGVO-Konformität**: Implementierung von Datenschutzfunktionen (Recht auf Vergessen, Datenexport)
-
-## 11. Deployment und DevOps
-
-### Containerisierung
-- Docker-Container für Backend und Frontend
-- Docker-Compose für Entwicklungsumgebung
-- Kubernetes-Manifest für Produktionsumgebung
-
-### CI/CD-Pipeline
-- Automatisierte Tests (Unit, Integration, E2E)
-- Automatisiertes Deployment
-- Versionsmanagement
-
-### Monitoring und Logging
-- Prometheus für Metriken
-- Grafana für Visualisierung
-- ELK-Stack oder ähnliches für Logging
-- Alerting bei kritischen Ereignissen
-
-## 12. Backup und Recovery
-
-- Regelmäßige Datenbank-Backups
-- Point-in-Time-Recovery
-- Disaster-Recovery-Plan
-
-## 13. Offline-Funktionalität
-
-- Progressive Web App (PWA) Funktionalitäten
-- Lokale Speicherung von Zeitbuchungen bei fehlender Internetverbindung
-- Synchronisation bei Wiederherstellung der Verbindung
-
-## 14. Integrationen
-
-### API-Integrationen
-- **Abrechnungssysteme**: Export von Abrechnungsdaten
-- **Kalendersysteme**: Synchronisation mit Google Calendar, Outlook, etc.
-- **Projektmanagementtools**: Jira, Trello, etc. (insbesondere für Version 2)
-- **Webhooks**: Für benutzerdefinierte Integrationen
-
-### Single Sign-On (SSO)
-- Integration mit gängigen Identity Providern (Google, Microsoft, SAML)
-- OAuth 2.0 / OpenID Connect
-
-## 15. Erweiterbarkeit
-
-### Plugin-System
-- Möglichkeit zur Erweiterung durch Plugins
-- Hooks für benutzerdefinierte Logik
-
-### Custom Fields
-- Erweiterbare Datenmodelle mit benutzerdefinierten Feldern
-- Anpassbare Formulare
-
-## 16. Mobile App-Unterstützung
-
-- Responsive Webdesign für mobile Browser
-- Native Mobile Apps (zukünftige Erweiterung)
-- API-Design mit Mobilnutzung im Blick
-
-## 17. Internationalisierung und Lokalisierung
-
-- Mehrsprachige Benutzeroberfläche
-- Lokalisierte Datums- und Zeitformate
-- Währungsumrechnung
-
-## 18. Abrechnung und Fakturierung
-
-- Generierung von Rechnungsentwürfen basierend auf Zeitbuchungen
-- Export von Abrechnungsdaten in verschiedenen Formaten (CSV, Excel, etc.)
-- Automatisierte Erinnerungen für nicht erfasste Zeiten
-
-## 19. Benachrichtigungssystem
-
-- E-Mail-Benachrichtigungen
-- In-App-Benachrichtigungen
-- Erinnerungen für ausstehende Zeiterfassungen
-- Genehmigungsanfragen
-
-## 20. Analytics und Business Intelligence
-
-- Erweiterte Analytik für Management-Insights
-- Trendanalysen und Prognosen
-- Ressourcenauslastung und -planung
-- Exportmöglichkeiten für BI-Tools

docu/draft/claude.md

@@ -1,147 +0,0 @@
-# Zeiterfassungstool Spezifikation
-
-## 1. Überblick
-
-Dieses Dokument spezifiziert ein modernes Zeiterfassungstool mit Multi-Tenant-Architektur, implementiert mit Go (Backend) und NextJS (Frontend). Das System unterstützt die Erfassung von Arbeitszeiten, Projektmanagement und Reporting-Funktionen.
-
-## 2. Technologie-Stack
-
-### Backend
-- **Programmiersprache**: Go
-- **Architektur**: Funktional-Programmierung (FPGO)
-- **Datenbank**: PostgreSQL mit ORM
-- **API-Dokumentation**: Swagger
-
-### Frontend
-- **Framework**: NextJS
-- **Architektur**: Funktional-Programmierung (FPTS - Functional Programming TypeScript)
-- **UI-Komponenten**: React mit Tailwind CSS
-
-## 3. Multi-Tenant-Architektur
-
-Das System unterstützt mehrere Unternehmen (Companies) mit eigenen Benutzern und Daten.
-
-### Rollen und Berechtigungen
-- **Admin**: Systemweiter Administrator mit vollständigem Zugriff
-- **Company**: Unternehmensadministrator
-- **Manager**: Projektmanager mit erweiterten Rechten
-- **User**: Standardbenutzer (Mitarbeiter)
-- **Auditor**: Nur-Lese-Zugriff für Berichte und Audits
-
-## 4. Datenbankmodell
-
-### Hauptentitäten
-
-#### Tenant-Struktur
-- **Company**: Unternehmen
-- **User**: Benutzer mit Rollen
-
-#### Zeiterfassung
-- **Kunde**: Kunde einer Company
-- **Projekt**: Projekte für Kunden
-- **Tätigkeit**: Arbeitstätigkeiten
-- **Buchung**: Zeiterfassung
-- **Stundensatz**: Pro Mitarbeiter
-- **Verrechnungspreis**: Pro Tätigkeit
-
-#### Projektmanagement (Version 2)
-- **Sprint**: Iterationen innerhalb eines Projekts
-- **Task**: Aufgaben innerhalb eines Sprints
-- **KanbanBoard**: Visualisierung von Tasks
-
-## 5. Backend-Architektur
-
-### Modularisierung
-Das Backend wird in kleine, funktionale Module aufgeteilt, um die Kontextgröße für LLM-basierte Implementierung zu optimieren.
-
-#### Core-Module
-- **auth**: Authentifizierung und Autorisierung
-- **tenant**: Multi-Tenant-Verwaltung
-- **user**: Benutzerverwaltung
-- **timetracking**: Zeiterfassung
-- **customer**: Kundenverwaltung 
-- **project**: Projektverwaltung
-- **billing**: Abrechnung und Verrechnungspreise
-- **reporting**: Report-Generierung
-
-### API-Design
-- RESTful API mit Swagger-Dokumentation
-- JWT-basierte Authentifizierung
-- Tenant-Isolation durch Middleware
-
-## 6. Frontend-Architektur
-
-### Komponentenstruktur
-- Modulare React-Komponenten
-- State Management mit Context API oder Redux
-- Responsive Design
-
-### Hauptseiten
-- Dashboard (Übersicht)
-- Zeiterfassung mit Tracker
-- Kunden- und Projektverwaltung
-- Reporting und Auswertungen
-- Administrationsoberfläche
-
-## 7. Funktionsumfang (Version 1)
-
-### Unternehmensverwaltung
-- Anlegen und Verwalten von Companies (Multi-Tenant)
-- Benutzerverwaltung mit Rollenzuweisung
-
-### Stammdatenverwaltung
-- Kunden anlegen und verwalten
-- Projekte anlegen und verwalten
-- Tätigkeiten definieren mit Verrechnungspreisen
-- Mitarbeiter-Stundensätze hinterlegen
-
-### Zeiterfassung
-- Zeiten buchen mit Angaben zu:
-  - Zeitraum (Start/Ende oder Dauer)
-  - Projekt (Wohin)
-  - Tätigkeit (Wofür)
-  - Benutzer (Wer)
-  - Beschreibung (optional)
-  - Verrechnungspreis
-  - Abrechenbarkeit (0-100% Slider)
-- Zeittracker mit Start/Stop-Funktion
-- Übernahme der letzten Buchungsparameter
-
-### Reporting
-- Kumulation von Buchungen nach:
-  - Projekten
-  - Mitarbeitern
-  - Kunden
-  - Zeiträumen
-- PDF-Export von Reports
-- Dashboards mit Visualisierungen
-
-## 8. Funktionsumfang (Version 2)
-
-### Projektmanagement
-- Sprints innerhalb von Projekten
-- Task-Items in Sprints
-- Kanban-Boards für visuelle Darstellung
-- Zuweisung von Tasks zu Benutzern
-- Direkte Verknüpfung von Tasks mit Zeitbuchungen
-
-## 9. Implementierungsplan
-
-### Phase 1: Grundlegende Infrastruktur
-- Aufsetzen der Go-Backend-Struktur
-- Implementierung der Datenbank mit ORM
-- NextJS-Frontend-Grundgerüst
-- Authentifizierung und Autorisierung
-
-### Phase 2: Version 1 Features
-- Stammdatenverwaltung
-- Zeiterfassung
-- Reporting
-- Dashboard
-
-### Phase 3: Version 2 Features
-- Projektmanagement
-- Kanban-Boards
-- Task-Tracking
-
-

docu/draft/concept/Readme.md

@@ -1,87 +0,0 @@
-# Spezifikation Zeiterfassungs-Tool
-
-## Technologie-Stack
-
-### Backend
-- Go mit fp-go
-- PostgreSQL mit ORM (GORM oder Bun)
-- Swagger/OpenAPI
-- JWT-basierte Authentifizierung
-
-### Frontend
-- Next.js mit fp-ts
-- React und Tailwind CSS
-- Responsive Webdesign
-- Progressive Web App (PWA)
-
-## Multi-Tenancy & Rollen
-- **Mandantenfähigkeit**: Isolation von Daten je Unternehmen (Tenant)
-- **Rollen:** Admin, Company-Admin, Manager, Auditor, User
-
-## Datenmodelle
-- **Company** (Tenant)
-- **User** (mit Rollen, Stundenrate)
-- **Kunde**
-- **Projekt** (mit Kundenreferenz)
-- **Tätigkeit** (Verrechnungspreis)
-- **Buchung** (Zeit, User, Projekt, Tätigkeit, Beschreibung optional, Abrechenbarkeit 0-100%)
-
-## Funktionale Anforderungen
-### Version 1
-- Stammdatenverwaltung (Kunden, Projekte, Tätigkeiten, User)
-- Zeiterfassung mit Start/Stopp-Funktion und Parameterübernahme aus letzter Buchung
-- Übersichtliches Dashboard mit letzten Buchungen und Tracker
-- Aggregierte Reports nach Zeitraum, Projekt, Kunde, Mitarbeiter mit PDF-Export
-- Grafische Dashboards (Diagramme)
-
-### Version 2
-- Projektverwaltung mit Sprints, Tasks
-- Kanban-Boards zur Aufgabenverwaltung
-- Direkte Verknüpfung von Tasks mit Zeitbuchungen
-
-## Sicherheit und Datenschutz
-- Tenant-Isolation
-- TLS-Verschlüsselung und verschlüsselte Speicherung sensibler Daten
-- Audit-Logs (lückenlose Protokollierung)
-- DSGVO-konform (Datenexport, Recht auf Vergessen)
-
-## Technische Umsetzung
-### Backend-Architektur
-- Modulare Pakete:
-  - Auth
-  - Tenant
-  - User
-  - TimeTracking
-  - Customer
-  - Project
-  - Billing
-  - Reporting
-- RESTful API mit Middleware zur Tenant-Isolation
-
-### Frontend-Komponenten
-- Dashboard (Tracker, letzte Buchungen)
-- Buchungsformular und Historie
-- Stammdatenverwaltung (Kunden, Projekte, Tätigkeiten)
-- Reporting-Seiten mit PDF-Export
-- Admin-Oberfläche
-
-## Deployment & DevOps
-- Docker, Docker-Compose (Entwicklung)
-- Kubernetes-Manifeste für Produktion
-- CI/CD mit automatischen Tests und Deployment
-- Monitoring und Logging (Prometheus, Grafana, ELK)
-- Regelmäßige Backups, Disaster-Recovery
-
-## Erweiterbarkeit und Integrationen
-- API für externe Abrechnungssysteme und Kalenderintegration
-- Single Sign-On (Google, Microsoft, SAML)
-- Plugin-System und Custom Fields für Erweiterbarkeit
-- Analytics und BI-Export
-
-## Zusätzliche Funktionen
-- Audit-Logs wichtiger Aktionen
-- Benachrichtigungssystem (E-Mail, In-App)
-- Lokalisierung (Mehrsprachigkeit, Zeit- und Datumsformate)
-
-Diese aktualisierte Spezifikation berücksichtigt alle relevanten Punkte für eine modulare, erweiterbare und sichere Implementierung.
-

docu/draft/concept/claude.md

@@ -1,389 +0,0 @@
-# Zeiterfassungstool - Projektstruktur
-
-## Backend (Go)
-
-```
-timetracker-backend/
-├── cmd/                        # Einstiegspunkte für die Anwendung
-│   ├── api/                    # API-Server
-│   │   └── main.go
-│   └── worker/                 # Hintergrundprozesse (Reports, Benachrichtigungen usw.)
-│       └── main.go
-├── internal/                   # Interner Code, nicht exportierbar
-│   ├── auth/                   # Authentifizierung und Autorisierung
-│   │   ├── jwt.go
-│   │   ├── middleware.go
-│   │   ├── permissions.go
-│   │   └── service.go
-│   ├── tenant/                 # Multi-Tenant-Funktionalität
-│   │   ├── middleware.go
-│   │   └── service.go
-│   ├── user/                   # Benutzerverwaltung
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── company/                # Unternehmensverwaltung
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── customer/               # Kundenverwaltung
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── project/                # Projektverwaltung
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── activity/               # Tätigkeitsverwaltung
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── timetracking/           # Zeiterfassung
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── billing/                # Abrechnung
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── reporting/              # Berichtswesen
-│   │   ├── generator.go
-│   │   ├── pdf.go
-│   │   └── service.go
-│   ├── notification/           # Benachrichtigungen
-│   │   ├── email.go
-│   │   ├── inapp.go
-│   │   └── service.go
-│   ├── kanban/                 # Kanban-Board (Version 2)
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── task/                   # Task-Management (Version 2)
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── sprint/                 # Sprint-Management (Version 2)
-│   │   ├── model.go
-│   │   ├── repository.go
-│   │   └── service.go
-│   ├── config/                 # Konfiguration
-│   │   └── config.go
-│   └── database/               # Datenbankzugriff
-│       ├── migrations/
-│       ├── seeds/
-│       └── connection.go
-├── pkg/                        # Öffentliche Pakete, die exportiert werden können
-│   ├── apierror/               # API-Fehlerobjekte
-│   │   └── error.go
-│   ├── logger/                 # Logging-Funktionalität
-│   │   └── logger.go
-│   ├── validator/              # Validierungsfunktionen
-│   │   └── validator.go
-│   └── utils/                  # Allgemeine Hilfsfunktionen
-│       ├── dates.go
-│       ├── encryption.go
-│       └── helpers.go
-├── api/                        # API-Definitionen
-│   ├── handlers/               # API-Handler
-│   │   ├── auth.go
-│   │   ├── user.go
-│   │   ├── company.go
-│   │   ├── customer.go
-│   │   ├── project.go
-│   │   ├── timetracking.go
-│   │   ├── reporting.go
-│   │   └── task.go
-│   ├── middleware/             # API-Middleware
-│   │   ├── auth.go
-│   │   ├── tenant.go
-│   │   └── logging.go
-│   ├── routes/                 # API-Routen
-│   │   └── routes.go
-│   └── swagger/                # Swagger-Dokumentation
-│       └── swagger.yaml
-├── test/                       # Tests
-│   ├── integration/
-│   ├── unit/
-│   └── mocks/
-├── scripts/                    # Skripte für Build, Deployment usw.
-│   ├── build.sh
-│   ├── migrate.sh
-│   └── seed.sh
-├── docker/                     # Docker-Konfiguration
-│   ├── Dockerfile
-│   └── docker-compose.yml
-├── go.mod
-├── go.sum
-├── .env.example
-└── README.md
-```
-
-## Frontend (NextJS)
-
-```
-timetracker-frontend/
-├── public/                     # Statische Dateien
-│   ├── assets/
-│   │   ├── images/
-│   │   ├── icons/
-│   │   └── fonts/
-│   └── locales/                # Mehrsprachige Inhalte
-│       ├── de/
-│       └── en/
-├── src/
-│   ├── app/                    # Next.js 13+ App Router
-│   │   ├── api/                # API-Routen (falls nötig)
-│   │   ├── (auth)/             # Authentifizierungsseiten
-│   │   │   ├── login/
-│   │   │   └── register/
-│   │   ├── dashboard/          # Dashboard-Seiten
-│   │   │   ├── page.tsx
-│   │   │   └── layout.tsx
-│   │   ├── time-tracking/      # Zeiterfassungsseiten
-│   │   │   ├── page.tsx
-│   │   │   ├── [id]/
-│   │   │   └── components/
-│   │   ├── projects/           # Projektseiten
-│   │   │   ├── page.tsx
-│   │   │   └── [id]/
-│   │   ├── customers/          # Kundenseiten
-│   │   │   ├── page.tsx
-│   │   │   └── [id]/
-│   │   ├── reports/            # Berichtsseiten
-│   │   │   ├── page.tsx
-│   │   │   └── [type]/
-│   │   ├── admin/              # Administrationsseiten
-│   │   │   ├── users/
-│   │   │   ├── companies/
-│   │   │   └── settings/
-│   │   ├── kanban/             # Kanban-Boards (Version 2)
-│   │   │   ├── page.tsx
-│   │   │   └── [id]/
-│   │   ├── layout.tsx
-│   │   └── page.tsx
-│   ├── components/             # Wiederverwendbare Komponenten
-│   │   ├── common/             # Allgemeine Komponenten
-│   │   │   ├── Button.tsx
-│   │   │   ├── Card.tsx
-│   │   │   ├── Input.tsx
-│   │   │   └── ...
-│   │   ├── layout/             # Layout-Komponenten
-│   │   │   ├── Navbar.tsx
-│   │   │   ├── Sidebar.tsx
-│   │   │   ├── Footer.tsx
-│   │   │   └── ...
-│   │   ├── dashboard/          # Dashboard-Komponenten
-│   │   │   ├── ActivityChart.tsx
-│   │   │   ├── RecentEntries.tsx
-│   │   │   └── ...
-│   │   ├── timetracker/        # Zeiterfassungskomponenten
-│   │   │   ├── Timer.tsx
-│   │   │   ├── EntryForm.tsx
-│   │   │   └── ...
-│   │   ├── reports/            # Berichtskomponenten
-│   │   │   ├── ReportFilter.tsx
-│   │   │   ├── Chart.tsx
-│   │   │   └── ...
-│   │   └── kanban/             # Kanban-Komponenten (Version 2)
-│   │       ├── Board.tsx
-│   │       ├── Column.tsx
-│   │       ├── Card.tsx
-│   │       └── ...
-│   ├── hooks/                  # Custom React Hooks
-│   │   ├── useAuth.ts
-│   │   ├── useTimeTracking.ts
-│   │   ├── useProjects.ts
-│   │   └── ...
-│   ├── lib/                    # Hilfsfunktionen und Bibliotheken
-│   │   ├── api.ts              # API Client
-│   │   ├── auth.ts             # Auth-Utilities
-│   │   ├── date-utils.ts       # Date-Helpers
-│   │   └── ...
-│   ├── types/                  # TypeScript-Typdefinitionen
-│   │   ├── auth.ts
-│   │   ├── user.ts
-│   │   ├── timeTracking.ts
-│   │   ├── project.ts
-│   │   └── ...
-│   ├── store/                  # State Management (falls benötigt)
-│   │   ├── slices/
-│   │   └── index.ts
-│   ├── styles/                 # CSS/SCSS Styles
-│   │   ├── globals.css
-│   │   └── theme.ts
-│   └── utils/                  # Allgemeine Hilfsfunktionen
-│       ├── format.ts
-│       ├── validation.ts
-│       └── ...
-├── .env.local.example
-├── .eslintrc.json
-├── next.config.js
-├── package.json
-├── tailwind.config.js
-├── tsconfig.json
-├── jest.config.js              # Test-Konfiguration
-├── postcss.config.js           # PostCSS-Konfiguration
-└── README.md
-```
-
-## Datenbankschema (PostgreSQL)
-
-```sql
--- Multi-Tenant
-CREATE TABLE companies (
-    id UUID PRIMARY KEY,
-    name VARCHAR(255) NOT NULL,
-    address TEXT,
-    contact_email VARCHAR(255),
-    contact_phone VARCHAR(50),
-    logo_url TEXT,
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
--- Benutzer und Rollen
-CREATE TABLE roles (
-    id SERIAL PRIMARY KEY,
-    name VARCHAR(50) UNIQUE NOT NULL,
-    permissions JSONB
-);
-
-CREATE TABLE users (
-    id UUID PRIMARY KEY,
-    company_id UUID REFERENCES companies(id),
-    email VARCHAR(255) UNIQUE NOT NULL,
-    password_hash VARCHAR(255) NOT NULL,
-    first_name VARCHAR(100),
-    last_name VARCHAR(100),
-    role_id INTEGER REFERENCES roles(id),
-    hourly_rate DECIMAL(10, 2),
-    is_active BOOLEAN DEFAULT TRUE,
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
--- Kunden
-CREATE TABLE customers (
-    id UUID PRIMARY KEY,
-    company_id UUID NOT NULL REFERENCES companies(id),
-    name VARCHAR(255) NOT NULL,
-    contact_person VARCHAR(255),
-    email VARCHAR(255),
-    phone VARCHAR(50),
-    address TEXT,
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
--- Projekte
-CREATE TABLE projects (
-    id UUID PRIMARY KEY,
-    company_id UUID NOT NULL REFERENCES companies(id),
-    customer_id UUID REFERENCES customers(id),
-    name VARCHAR(255) NOT NULL,
-    description TEXT,
-    start_date DATE,
-    end_date DATE,
-    status VARCHAR(50),
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
--- Tätigkeiten
-CREATE TABLE activities (
-    id UUID PRIMARY KEY,
-    company_id UUID NOT NULL REFERENCES companies(id),
-    name VARCHAR(255) NOT NULL,
-    description TEXT,
-    billing_rate DECIMAL(10, 2),
-    is_active BOOLEAN DEFAULT TRUE,
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
--- Zeitbuchungen
-CREATE TABLE time_entries (
-    id UUID PRIMARY KEY,
-    company_id UUID NOT NULL REFERENCES companies(id),
-    user_id UUID NOT NULL REFERENCES users(id),
-    project_id UUID NOT NULL REFERENCES projects(id),
-    activity_id UUID NOT NULL REFERENCES activities(id),
-    start_time TIMESTAMP NOT NULL,
-    end_time TIMESTAMP NOT NULL,
-    duration INTEGER NOT NULL, -- in minutes
-    description TEXT,
-    billable_percentage INTEGER NOT NULL DEFAULT 100,
-    billing_rate DECIMAL(10, 2),
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
--- Version 2: Sprint/Task Management
-CREATE TABLE sprints (
-    id UUID PRIMARY KEY,
-    project_id UUID NOT NULL REFERENCES projects(id),
-    name VARCHAR(255) NOT NULL,
-    start_date DATE NOT NULL,
-    end_date DATE NOT NULL,
-    status VARCHAR(50),
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
-CREATE TABLE task_statuses (
-    id SERIAL PRIMARY KEY,
-    company_id UUID NOT NULL REFERENCES companies(id),
-    name VARCHAR(100) NOT NULL,
-    color VARCHAR(7),
-    position INTEGER NOT NULL,
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
-CREATE TABLE tasks (
-    id UUID PRIMARY KEY,
-    company_id UUID NOT NULL REFERENCES companies(id),
-    project_id UUID NOT NULL REFERENCES projects(id),
-    sprint_id UUID REFERENCES sprints(id),
-    title VARCHAR(255) NOT NULL,
-    description TEXT,
-    assignee_id UUID REFERENCES users(id),
-    status_id INTEGER REFERENCES task_statuses(id),
-    priority VARCHAR(50),
-    estimate INTEGER, -- in minutes
-    due_date TIMESTAMP,
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
-CREATE TABLE kanban_boards (
-    id UUID PRIMARY KEY,
-    company_id UUID NOT NULL REFERENCES companies(id),
-    project_id UUID NOT NULL REFERENCES projects(id),
-    name VARCHAR(255) NOT NULL,
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
-CREATE TABLE kanban_columns (
-    id UUID PRIMARY KEY,
-    board_id UUID NOT NULL REFERENCES kanban_boards(id),
-    name VARCHAR(100) NOT NULL,
-    position INTEGER NOT NULL,
-    task_status_id INTEGER REFERENCES task_statuses(id),
-    created_at TIMESTAMP NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMP NOT NULL DEFAULT NOW()
-);
-
--- Verknüpfung zwischen Zeitbuchungen und Tasks
-ALTER TABLE time_entries ADD COLUMN task_id UUID REFERENCES tasks(id);
-
--- Indizes für Performance
-CREATE INDEX idx_time_entries_user ON time_entries(user_id);
-CREATE INDEX idx_time_entries_project ON time_entries(project_id);
-CREATE INDEX idx_time_entries_date ON time_entries(start_time);
-CREATE INDEX idx_projects_company ON projects(company_id);
-CREATE INDEX idx_users_company ON users(company_id);
-CREATE INDEX idx_tasks_project ON tasks(project_id);
-CREATE INDEX idx_tasks_sprint ON tasks(sprint_id);
-```

docu/draft/concept/structure.md

@@ -1,143 +0,0 @@
-Okay, ich schlage dir eine detaillierte Projektstruktur für ein Time Tracking and Management System vor, das in Go (Backend) und Next.js (Frontend) mit FPGO und FPTS umgesetzt wird. Das System soll Multi-Tenant-fähig sein, PostgreSQL als Datenbank verwenden und modular, übersichtlich sowie für die Entwicklung mit LLMs geeignet sein. Die Struktur ist in zwei Hauptteile gegliedert: Backend und Frontend. Hier ist der Vorschlag:
-
----
-
-## Projektstruktur
-
-### 1. Backend (Go)
-
-Das Backend ist in Go geschrieben und folgt den Prinzipien von **Clean Architecture** und **Domain-Driven Design (DDD)**, um die Geschäftslogik klar von technischen Details zu trennen. Dies sorgt für Testbarkeit und Erweiterbarkeit.
-
-```
-backend-go/
-├── cmd/
-│   └── server/
-│       └── main.go               # Einstiegspunkt der Anwendung
-├── internal/                     # Nicht-öffentlicher Code
-│   ├── domain/                   # Domänen-Schicht: Geschäftlogik und Entitäten
-│   │   ├── entities/             # Domänenmodelle
-│   │   │   ├── user.go
-│   │   │   ├── company.go
-│   │   │   ├── project.go
-│   │   │   ├── client.go
-│   │   │   ├── activity.go
-│   │   │   ├── employee.go
-│   │   │   └── booking.go
-│   │   ├── repositories/         # Interfaces für Datenpersistenz
-│   │   │   ├── user_repository.go
-│   │   │   ├── company_repository.go
-│   │   │   ├── project_repository.go
-│   │   │   └── ...
-│   │   └── services/             # Domänenservices für Anwendungsfälle
-│   │       ├── user_service.go
-│   │       ├── booking_service.go
-│   │       └── ...
-│   ├── application/              # Anwendungsschicht: API-spezifische Logik
-│   │   └── services/
-│   │       └── api_service.go
-│   ├── infrastructure/           # Infrastrukturschicht: Externe Abhängigkeiten
-│   │   ├── persistence/          # Implementierung der Repositories mit GORM
-│   │   │   ├── gorm_user_repository.go
-│   │   │   ├── gorm_company_repository.go
-│   │   │   └── ...
-│   │   └── config/               # Konfigurationsmanagement
-│   │       └── config.go
-│   └── interfaces/               # Schnittstellenschicht: API-Handler
-│       └── http/
-│           ├── handlers/         # HTTP-Handler für API-Endpunkte
-│           │   ├── auth_handler.go
-│           │   ├── booking_handler.go
-│           │   ├── project_handler.go
-│           │   └── ...
-│           └── middleware/       # Middleware für Auth und Tenant-Isolierung
-│               ├── auth_middleware.go
-│               └── tenant_middleware.go
-├── pkg/                          # Öffentliche, wiederverwendbare Packages
-│   ├── logger.go
-│   └── utils.go
-├── tests/                        # Tests
-│   ├── unit/
-│   └── integration/
-├── docs/                         # API-Dokumentation
-│   └── swagger.yaml
-├── go.mod
-└── go.sum
-```
-
-#### Erläuterung:
-- **cmd/**: Enthält den Einstiegspunkt (`main.go`), der den Server startet.
-- **internal/**: Nicht-öffentlicher Code, unterteilt in:
-  - **domain/**: Kernentitäten (z.B. `User`, `Company`), Repository-Interfaces und Domänenservices.
-  - **application/**: API-spezifische Logik, die Domänenservices nutzt.
-  - **infrastructure/**: Technische Implementierungen wie Datenbankzugriff (GORM für PostgreSQL) und Konfiguration.
-  - **interfaces/**: HTTP-Handler (mit Gin) und Middleware für Authentifizierung und Multi-Tenant-Isolierung.
-- **pkg/**: Öffentliche Hilfsfunktionen (z.B. Logger).
-- **tests/**: Unit- und Integrationstests.
-- **docs/**: Swagger-Dokumentation für die API.
-
-### 2. Frontend (Next.js)
-
-Das Frontend nutzt **Next.js** mit **TypeScript** und **FPTS** für funktionale Programmierung. Die Struktur ist typisch für Next.js und fördert Wiederverwendbarkeit.
-
-```
-frontend-nextjs/
-├── pages/                        # Seitenkomponenten, die Routen entsprechen
-│   ├── index.tsx                 # Startseite
-│   ├── login.tsx
-│   ├── dashboard.tsx
-│   ├── bookings.tsx
-│   └── ...
-├── components/                   # Wiederverwendbare UI-Komponenten
-│   ├── Header.tsx
-│   ├── BookingForm.tsx
-│   ├── ProjectList.tsx
-│   └── ...
-├── lib/                          # Hilfsfunktionen und API-Calls
-│   ├── api.ts                    # Axios-Instanz für API-Anfragen
-│   ├── auth.ts                   # Authentifizierungslogik
-│   └── ...
-├── styles/                       # Stylesheets
-│   ├── globals.css
-│   └── module.css
-├── public/                       # Statische Dateien
-│   └── images/
-├── types/                        # TypeScript-Typdefinitionen
-│   ├── user.ts
-│   ├── booking.ts
-│   └── ...
-├── tests/                        # Tests für Komponenten und Seiten
-│   ├── components/
-│   └── pages/
-├── next.config.js
-├── package.json
-└── tsconfig.json
-```
-
-#### Erläuterung:
-- **pages/**: Seiten der Anwendung (z.B. `dashboard.tsx` für `/dashboard`).
-- **components/**: Wiederverwendbare UI-Komponenten (z.B. `BookingForm.tsx`).
-- **lib/**: Hilfsfunktionen, z.B. für API-Calls mit Axios.
-- **styles/**: Globale und modulare CSS-Dateien.
-- **public/**: Statische Dateien wie Bilder.
-- **types/**: Typdefinitionen für Typsicherheit.
-- **tests/**: Tests mit Tools wie Jest oder Cypress.
-
----
-
-## Multi-Tenant-Unterstützung
-
-Die Multi-Tenant-Fähigkeit wird durch eine **Tenant-ID** (z.B. `company_id`) in den Datenbanktabellen umgesetzt. Das Backend verwendet ein **tenant_middleware.go**, das sicherstellt, dass Benutzer nur Daten ihres eigenen Tenants sehen, indem die `company_id` in jeder Anfrage geprüft wird.
-
-## API-Dokumentation
-
-Die API wird mit **Swagger** dokumentiert, gespeichert in `backend-go/docs/swagger.yaml`. Dies bietet eine klare, interaktive Übersicht der Endpunkte.
-
-## Entwicklung mit LLMs
-
-Für die Entwicklung mit LLMs ist der Code in kleine, klar benannte Dateien aufgeteilt (z.B. `user.go`, `booking_service.go`), die jeweils eine spezifische Aufgabe haben. Dies erleichtert LLMs das Verständnis und die Generierung von Code.
-
----
-
-## Fazit
-
-Diese Struktur ist modular, übersichtlich und erweiterbar. Sie nutzt bewährte Praktiken für Go und Next.js, unterstützt Multi-Tenant-Fähigkeit und ist durch die Aufteilung in kleine Module ideal für die Entwicklung mit LLMs. Wenn du Anpassungen oder mehr Details möchtest, lass es mich wissen!

docu/draft/gpt4_5.md

@@ -1,91 +0,0 @@
-# Spezifikation Zeiterfassungs-Tool
-
-## Technische Rahmenbedingungen
-- **Backend:** Go mit fp-go
-- **Frontend:** Next.js mit fp-ts
-- **Datenbank:** PostgreSQL mit ORM (z.B. GORM oder Bun)
-- **API-Dokumentation:** Swagger/OpenAPI
-- **PDF-Generierung:** serverseitig
-
-## Multi-Tenancy & Rollen
-- **Mandantenfähig**: Separierung aller Daten nach Unternehmen (Company)
-- **Rollen:**
-  - Admin (systemweit)
-  - Company (Unternehmensebene)
-  - Manager
-  - Auditor (Read-only Zugriff auf Reports)
-  - User (regulärer Mitarbeiter)
-
-## Datenmodelle (DB Entities)
-- **Company**
-  - Kunden (Clients)
-  - Projekte (Projects)
-  - Tätigkeiten (Activities)
-- **User**
-  - Stundenrate
-  - Rolle
-- **Projekt**
-  - Kundenreferenz
-  - Beschreibung
-- **Tätigkeit**
-  - Name
-  - Verrechnungspreis
-- **Buchung**
-  - Zeit (Start, Ende, Dauer)
-  - User
-  - Projekt
-  - Tätigkeit
-  - Beschreibung (optional)
-  - Abrechenbarkeit (0-100%)
-  - Verrechnungspreis (berechnet)
-
-## Funktionale Anforderungen
-### Version 1
-- Verwaltung von Kunden, Projekten, Tätigkeiten
-- Mitarbeiterverwaltung mit Stundensatz
-- Erstellung von Zeitbuchungen mit optionaler Beschreibung und wählbarer Abrechenbarkeit
-- Automatische Übernahme der Parameter (Projekt, Tätigkeit, Beschreibung) der letzten Buchung
-- Live-Tracker mit Start-/Stopp-Funktion auf Dashboard
-- Reporting-Funktion
-  - Aggregation der Buchungen nach Zeitraum, Projekt, Kunde, Mitarbeiter
-  - Export als PDF
-  - Grafische Dashboards (Kreis-/Balkendiagramme, Zeitverläufe)
-- Persönliches Dashboard
-  - Liste vergangener Buchungen
-  - Schnellstart-Tracker
-
-### Version 2 (Ausblick)
-- Projektverwaltung mit Sprints und Task-Items
-- Kanban-Board zur Verwaltung von Tasks
-- Zuordnung von Tasks direkt bei Buchungsauswahl
-
-## API-Endpunkte
-- Authentifizierung & Autorisierung (JWT o.ä.)
-- CRUD-Operationen für alle Entities
-- Endpunkte für Zeiterfassung, Buchungen starten/stoppen
-- Reporting-Endpoints mit Filterparametern (Zeitraum, Kunde, Projekt, Mitarbeiter)
-
-## Frontend-Komponenten
-- **Dashboard**
-  - Tracker-Komponente
-  - Liste letzter Buchungen
-  - Schnelleinstieg für häufige Aktionen
-- **Buchungs-Management**
-  - Buchungsformular
-  - Historie
-- **Verwaltungsseiten**
-  - Kunden, Projekte, Tätigkeiten, User
-- **Reporting-Ansicht**
-  - Interaktive Filtermöglichkeiten
-  - Grafische Darstellung (Charts)
-  - PDF-Export
-
-## Technische Umsetzung
-- Modularer Aufbau (separate Pakete für Entities, Services, Controllers)
-- DDD-Prinzipien für saubere Trennung von Geschäftslogik
-- APIs sauber nach Verantwortlichkeiten getrennt (RESTful Design)
-- Swagger zur API-Dokumentation (generiert aus Annotationen)
-- Strukturierter und übersichtlicher Code (kleine Dateien, Single Responsibility)
-
-Diese Struktur ermöglicht eine überschaubare Implementierung mit optimaler Unterstützung durch LLMs.
-

docu/draft/grok.md

@@ -1,232 +0,0 @@
-Ich habe Ihre Anfrage analysiert und die bestehende Dokumentation aktualisiert, um Ihre Anforderungen für ein Zeiterfassungstool zu berücksichtigen. Das Tool soll als Multi-Tenant-Lösung fungieren, in Go (Backend) und Next.js (Frontend) mit FPGO und FPTS für funktionale Programmierung umgesetzt werden. PostgreSQL wird als Datenbank mit einem ORM verwendet, und eine Swagger-Dokumentation wird für die API erstellt. Der Code wird in kleinere, übersichtliche Module und Dateien aufgeteilt, um die Implementierung mit LLMs zu erleichtern. Im Folgenden finden Sie die überarbeitete Spezifikation, die alle Anforderungen für Version 1 sowie geplante Erweiterungen für Version 2 abdeckt.
-
----
-
-# Software Requirements Specification
-## für das Time Tracking and Management System
-**Version 1.3**  
-**Erstellt von:** Jean Jacques Avril, Masterstudent, Informatik, Technische Hochschule Rosenheim  
-**Modul:** Konzepte der Programmiersprachen  
-**Datum:** 5. Januar 2025
-
----
-
-## 1. Einführung
-
-### 1.1 Zweck
-Dieses Software Requirements Specification (SRS) Dokument beschreibt detailliert die Anforderungen für das Time Tracking and Management System, eine Multi-Tenant-Lösung zur präzisen Erfassung und Verwaltung von Arbeitszeiten für mehrere Unternehmen. Jedes Unternehmen kann eigene Kunden, Projekte und Mitarbeiter verwalten. Das System unterstützt verschiedene Benutzerrollen (User, Manager, Auditor, Company, Admin) mit spezifischen Berechtigungen und Funktionen. Ziel ist es, eine klare Grundlage für die Entwicklung zu schaffen, die eine einfache Implementierung und Erweiterbarkeit ermöglicht.
-
-### 1.2 Zielgruppe und Leseempfehlungen
-Dieses Dokument richtet sich an:
-- **Projektbeteiligte:** Für ein umfassendes Verständnis der Funktionen und Einschränkungen.
-- **Entwickler:** Zur Einsicht in funktionale und nicht-funktionale Anforderungen für eine reibungslose Umsetzung.
-- **Qualitätssicherungsteams:** Um Tests an den spezifizierten Anforderungen auszurichten.
-- **Zukünftige Mitwirkende:** Um die Systemarchitektur zu verstehen und Erweiterungen beizutragen.
-
-Leser sollten zunächst die funktionalen Anforderungen durchsehen, um die Kernfunktionen zu verstehen, gefolgt von den nicht-funktionalen Anforderungen für Einblicke in Sicherheit und Performance. Entwickler mit Fokus auf Backend und Architektur sollten die Abschnitte zur Systemarchitektur und Technologie besonders beachten.
-
-### 1.3 Projektumfang
-Das Time Tracking and Management System bietet eine benutzerfreundliche Plattform zur Zeiterfassung, Verwaltung von Projekten und Erstellung von Berichten in einer Multi-Tenant-Umgebung.
-
-**Version 1 (Initiale Version):**
-- Multi-Tenant-Unterstützung mit Datenisolierung.
-- Benutzerverwaltung mit Rollen: User, Manager, Auditor, Company, Admin.
-- Verwaltung von Kunden, Projekten und Tätigkeiten je Unternehmen.
-- Zeiterfassung mit Buchungen (Zeit, Ort, Zweck, Mitarbeiter, Tätigkeit, Beschreibung, Verrechnungspreis, abrechenbarer Prozentsatz).
-- Berichte und Dashboards mit PDF-Export und grafischen Darstellungen.
-- Tracker auf der Startseite mit Standardwerten der letzten Buchung.
-
-**Version 2 (Zukünftige Erweiterungen):**
-- Projekte mit Sprints und Task-Items.
-- Kanban-Boards zur Aufgabenzuweisung.
-- Direkte Task-Auswahl bei Buchungen.
-
-Die modulare Architektur ermöglicht einfache Erweiterungen.
-
----
-
-## 2. Anforderungen
-
-### 2.1 Funktionale Anforderungen
-
-#### FA-1: Multi-Tenant-Unterstützung
-- **Beschreibung:** Das System muss mehrere Unternehmen (Tenants) unterstützen, jedes mit isolierten Daten.
-- **Details:** Jedes Unternehmen hat eigene Kunden, Projekte, Tätigkeiten, Mitarbeiter und Buchungen.
-- **Validierung:** Kein Zugriff auf Daten anderer Tenants möglich.
-
-#### FA-2: Benutzerverwaltung
-- **Beschreibung:** Benutzer können sich registrieren, anmelden und Rollen zugewiesen bekommen.
-- **Details:**
-  - Rollen: User (Zeiterfassung), Manager (Projektübersicht), Auditor (Berichte einsehen), Company (Verwaltung), Admin (Systemweit).
-  - Admin verwaltet Unternehmen, Company verwaltet eigene Daten.
-- **Validierung:** Eindeutige Benutzernamen und E-Mails pro Tenant.
-
-#### FA-3: Kundenverwaltung
-- **Beschreibung:** Unternehmen können Kunden anlegen, bearbeiten und löschen.
-- **Details:** Kunden sind unternehmensspezifisch.
-- **Validierung:** Nur Company- und Admin-Rollen dürfen Kunden verwalten.
-
-#### FA-4: Projektverwaltung
-- **Beschreibung:** Unternehmen können Projekte für Kunden anlegen, bearbeiten und löschen.
-- **Details:** Projekte sind mit Kunden und Unternehmen verknüpft.
-- **Validierung:** Nur Company- und Manager-Rollen dürfen Projekte verwalten.
-
-#### FA-5: Tätigkeitsverwaltung
-- **Beschreibung:** Unternehmen können Tätigkeiten mit Verrechnungspreisen definieren.
-- **Details:** Tätigkeiten sind unternehmensspezifisch.
-- **Validierung:** Verrechnungspreise müssen positiv sein.
-
-#### FA-6: Mitarbeiterverwaltung
-- **Beschreibung:** Unternehmen können Mitarbeiter mit Stundensätzen verwalten.
-- **Details:** Mitarbeiter sind unternehmensspezifisch.
-- **Validierung:** Stundensätze müssen positiv sein.
-
-#### FA-7: Buchungsverwaltung
-- **Beschreibung:** Benutzer können Zeitbuchungen erfassen.
-- **Details:** Buchungen enthalten Zeit, Ort, Zweck, Mitarbeiter, Tätigkeit, optionale Beschreibung, Verrechnungspreis und abrechenbaren Prozentsatz (0-100%).
-- **Validierung:** Buchungen müssen gültige Projekte und Tätigkeiten referenzieren.
-
-#### FA-8: Zeiterfassung
-- **Beschreibung:** Benutzer können einen Tracker starten und stoppen.
-- **Details:** Ohne Auswahl werden die Parameter der letzten Buchung übernommen.
-- **Validierung:** Kein Start möglich, wenn bereits aktiv.
-
-#### FA-9: Berichte
-- **Beschreibung:** Berichte können über Projekte, Mitarbeiter, Kunden und Zeiträume erstellt werden.
-- **Details:** Berichte enthalten Arbeitszeit, abrechenbare Beträge und können als PDF exportiert werden.
-- **Validierung:** Nur autorisierte Rollen dürfen Berichte generieren.
-
-#### FA-10: Dashboard
-- **Beschreibung:** Benutzer sehen auf der Startseite letzte Buchungen und einen Tracker.
-- **Details:** Dashboards zeigen grafische Zusammenfassungen.
-
-### 2.2 Nicht-funktionale Anforderungen
-
-#### NFA-1: Sicherheit
-- **Beschreibung:** Datenisolierung zwischen Tenants und sicherer Zugriff.
-- **Details:** RBAC, JWT-Authentifizierung, Verschlüsselung sensibler Daten.
-
-#### NFA-2: Performance
-- **Beschreibung:** API-Antwortzeit unter 200 ms.
-- **Details:** Optimierte Datenbankabfragen und Caching.
-
-#### NFA-3: Skalierbarkeit
-- **Beschreibung:** Unterstützung vieler gleichzeitiger Benutzer und Tenants.
-- **Details:** Horizontale Skalierung möglich.
-
-#### NFA-4: Benutzbarkeit
-- **Beschreibung:** Intuitive und responsive Benutzeroberfläche.
-- **Details:** Kompatibel mit Desktop, Tablet und Mobilgeräten.
-
-#### NFA-5: Modularität
-- **Beschreibung:** Code in kleine, überschaubare Module aufteilen.
-- **Details:** Erleichtert die Entwicklung mit LLMs.
-
----
-
-## 3. Technische Spezifikation
-
-### 3.1 Gesamtarchitektur
-Das System ist eine Full-Stack-Webanwendung:
-- **Frontend:** Next.js mit React und FPTS.
-- **Backend:** Go mit FPGO.
-- **Datenbank:** PostgreSQL mit GORM als ORM.
-- **API-Dokumentation:** Swagger für RESTful APIs.
-- **Kommunikation:** RESTful APIs, optional WebSockets für Echtzeitfunktionen.
-
-### 3.2 Technologie-Stack
-#### 3.2.1 Frontend
-- **Next.js/React:** Für interaktive Benutzeroberflächen.
-- **FPTS:** Funktionale Programmierung in TypeScript.
-- **Axios:** Für HTTP-Anfragen.
-
-#### 3.2.2 Backend
-- **Go:** Hauptsprache für Backend.
-- **FPGO:** Funktionale Programmierung in Go.
-- **GORM:** ORM für PostgreSQL.
-- **Gin:** Web-Framework für HTTP-Anfragen.
-- **JWT:** Für sichere Authentifizierung.
-
-#### 3.2.3 Datenbank
-- **PostgreSQL:** Relationale Datenbank.
-
-### 3.3 Entitäten
-- **Company:** Tenant-Daten.
-- **User:** Mit Rollen und Unternehmenszuordnung.
-- **Client:** Unternehmensspezifisch.
-- **Project:** Mit Kunden und Unternehmen verknüpft.
-- **Activity:** Mit Verrechnungspreis.
-- **Employee:** Mit Stundensatz.
-- **Booking:** Zeitbuchungen mit Details.
-
----
-
-## 4. Systemdesign
-
-### 4.1 Übersicht
-Das System folgt Domain-Driven Design (DDD) und Clean Architecture mit einer Multi-Tenant-Architektur (gemeinsame Datenbank mit Tenant-IDs).
-
-### 4.2 Architekturdesign
-- **Domain-Schicht:** Geschäftlogik und Entitäten.
-- **Application-Schicht:** Services und Anwendungsfälle.
-- **Infrastructure-Schicht:** Datenbankzugriff via GORM.
-- **Interface-Schicht:** API-Handler.
-- **Frontend:** Next.js mit FPTS.
-
-### 4.3 Moduldesign
-- **Benutzerverwaltung:** Registrierung, Authentifizierung.
-- **Unternehmensverwaltung:** Tenant-Daten.
-- **Projektverwaltung:** Projektzuweisungen.
-- **Buchungsverwaltung:** Zeiterfassung.
-- **Berichte:** Generierung und Export.
-
-### 4.4 Datenbankdesign
-- **Companies:** id, name, created_at, updated_at.
-- **Users:** id, company_id, role, name, email, password_hash.
-- **Clients:** id, company_id, name.
-- **Projects:** id, client_id, company_id, name.
-- **Activities:** id, company_id, name, billing_rate.
-- **Employees:** id, company_id, name, hourly_rate.
-- **Bookings:** id, user_id, project_id, activity_id, start_time, end_time, description, billable_percentage.
-
----
-
-## 5. API-Endpunkte
-
-### 5.1 Übersicht
-RESTful API mit Swagger-Dokumentation, gesichert durch JWT und RBAC.
-
-### 5.2 Endpunkte
-#### 5.2.1 Authentifizierung
-- **POST /api/auth/register:** Neuer Benutzer.
-- **POST /api/auth/login:** Login mit JWT.
-- **POST /api/auth/logout:** Logout.
-- **GET /api/auth/me:** Benutzerdetails.
-
-#### 5.2.2 Unternehmensverwaltung (Admin)
-- **POST /api/companies:** Neues Unternehmen.
-- **GET /api/companies:** Liste aller Unternehmen.
-- **PUT /api/companies/{id}:** Unternehmen bearbeiten.
-- **DELETE /api/companies/{id}:** Unternehmen löschen.
-
-#### 5.2.3 Buchungsverwaltung
-- **POST /api/bookings:** Neue Buchung.
-- **GET /api/bookings:** Buchungen auflisten.
-- **PUT /api/bookings/{id}:** Buchung bearbeiten.
-- **DELETE /api/bookings/{id}:** Buchung löschen.
-
-#### 5.2.4 Berichte
-- **GET /api/reports:** Bericht generieren.
-- **GET /api/reports/export:** PDF-Export.
-
----
-
-## 6. Sicherheitsaspekte
-- **Authentifizierung:** JWT-Token.
-- **RBAC:** Rollenbasierte Zugriffskontrolle.
-- **Datenisolierung:** Tenant-spezifischer Zugriff via Company-ID.
-- **Verschlüsselung:** Sensible Daten verschlüsselt.
-
----
-
-Diese Spezifikation bietet eine klare Anleitung für die Entwicklung eines Multi-Tenant-Zeiterfassungstools mit modularer Struktur, das leicht mit LLMs implementiert werden kann. Die Version 2-Anforderungen sind als zukünftige Erweiterungen berücksichtigt.

docu/dtos.md

@@ -0,0 +1,27 @@
+# Data Transfer Objects (DTOs)
+
+This document describes the Data Transfer Objects (DTOs) used in the Time Tracker application. DTOs are used to transfer data between the backend and frontend, and between different layers of the backend.
+
+## ActivityDto
+
+The `ActivityDto` type represents a specific activity that can be tracked, such as "Development", "Meeting", or "Bug Fixing". It is used to transfer activity data between the backend and frontend.
+
+## CompanyDto
+
+The `CompanyDto` type represents a tenant in the multi-tenant application. Each company has its own set of users, customers, projects, and activities. It is used to transfer company data between the backend and frontend.
+
+## CustomerDto
+
+The `CustomerDto` type represents a customer of a company. It is used to transfer customer data between the backend and frontend.
+
+## ProjectDto
+
+The `ProjectDto` type represents a project for a specific customer. It is used to transfer project data between the backend and frontend.
+
+## TimeEntryDto
+
+The `TimeEntryDto` type represents a time booking for a specific user, project, and activity. It is used to transfer time entry data between the backend and frontend.
+
+## UserDto
+
+The `UserDto` type represents a user of the application. Each user belongs to a company and has a specific role. It is used to transfer user data between the backend and frontend.

frontend/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

frontend/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

frontend/eslint.config.mjs

@@ -0,0 +1,16 @@
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { FlatCompat } from "@eslint/eslintrc";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+});
+
+const eslintConfig = [
+  ...compat.extends("next/core-web-vitals", "next/typescript"),
+];
+
+export default eslintConfig;

frontend/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

frontend/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "frontend",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "next": "15.2.1"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@tailwindcss/postcss": "^4",
+    "tailwindcss": "^4",
+    "eslint": "^9",
+    "eslint-config-next": "15.2.1",
+    "@eslint/eslintrc": "^3"
+  }
+}

frontend/postcss.config.mjs

@@ -0,0 +1,5 @@
+const config = {
+  plugins: ["@tailwindcss/postcss"],
+};
+
+export default config;

frontend/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

frontend/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

frontend/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

frontend/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

frontend/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

frontend/src/app/globals.css

@@ -0,0 +1,26 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}

frontend/src/app/layout.tsx

@@ -0,0 +1,34 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  title: "Create Next App",
+  description: "Generated by create next app",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}

frontend/src/app/page.tsx

@@ -0,0 +1,101 @@
+import Image from "next/image";
+
+export default function Home() {
+  return (
+    <div className="grid grid-rows-[20px_1fr_20px] items-center justify-items-center min-h-screen p-8 pb-20 gap-16 sm:p-20 font-[family-name:var(--font-geist-sans)]">
+      <main className="flex flex-col gap-8 row-start-2 items-center sm:items-start">
+        <Image
+          className="dark:invert"
+          src="/next.svg"
+          alt="Next.js logo"
+          width={180}
+          height={38}
+          priority
+        />
+        <ol className="list-inside list-decimal text-sm text-center sm:text-left font-[family-name:var(--font-geist-mono)]">
+          <li className="mb-2">
+            Get started by editing{" "}
+            <code className="bg-black/[.05] dark:bg-white/[.06] px-1 py-0.5 rounded font-semibold">
+              src/app/page.tsx
+            </code>
+            .
+          </li>
+          <li>Save and see your changes instantly.</li>
+        </ol>
+
+        <div className="flex gap-4 items-center flex-col sm:flex-row">
+          <a
+            className="rounded-full border border-solid border-transparent transition-colors flex items-center justify-center bg-foreground text-background gap-2 hover:bg-[#383838] dark:hover:bg-[#ccc] text-sm sm:text-base h-10 sm:h-12 px-4 sm:px-5"
+            href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            <Image
+              className="dark:invert"
+              src="/vercel.svg"
+              alt="Vercel logomark"
+              width={20}
+              height={20}
+            />
+            Deploy now
+          </a>
+          <a
+            className="rounded-full border border-solid border-black/[.08] dark:border-white/[.145] transition-colors flex items-center justify-center hover:bg-[#f2f2f2] dark:hover:bg-[#1a1a1a] hover:border-transparent text-sm sm:text-base h-10 sm:h-12 px-4 sm:px-5 sm:min-w-44"
+            href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            Read our docs
+          </a>
+        </div>
+      </main>
+      <footer className="row-start-3 flex gap-6 flex-wrap items-center justify-center">
+        <a
+          className="flex items-center gap-2 hover:underline hover:underline-offset-4"
+          href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <Image
+            aria-hidden
+            src="/file.svg"
+            alt="File icon"
+            width={16}
+            height={16}
+          />
+          Learn
+        </a>
+        <a
+          className="flex items-center gap-2 hover:underline hover:underline-offset-4"
+          href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <Image
+            aria-hidden
+            src="/window.svg"
+            alt="Window icon"
+            width={16}
+            height={16}
+          />
+          Examples
+        </a>
+        <a
+          className="flex items-center gap-2 hover:underline hover:underline-offset-4"
+          href="https://nextjs.org?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+          target="_blank"
+          rel="noopener noreferrer"
+        >
+          <Image
+            aria-hidden
+            src="/globe.svg"
+            alt="Globe icon"
+            width={16}
+            height={16}
+          />
+          Go to nextjs.org →
+        </a>
+      </footer>
+    </div>
+  );
+}

frontend/src/types/activity.ts

@@ -0,0 +1,27 @@
+import { BaseEntity } from "./base";
+import { ActivityDto, ActivityCreateDto, ActivityUpdateDto } from "./dto";
+import { UserId, ActivityId } from "./value-ids";
+
+export type Activity = Omit<ActivityDto, "id" | "createdAt" | "updatedAt" | "lastEditorID"> & {
+    id: ActivityId;
+} & BaseEntity;
+
+export const mapActivityDtoToActivity = (dto: ActivityDto): Activity => ({
+    ...dto,
+    id: dto.id as ActivityId,
+    createdAt: new Date(dto.createdAt),
+    updatedAt: new Date(dto.updatedAt),
+    lastEditorID: dto.lastEditorID as UserId,
+});
+
+export type ActivityCreate = ActivityCreateDto;
+
+export const mapActivityCreateDtoToActivityCreate = (dto: ActivityCreateDto): ActivityCreate => ({
+    ...dto,
+});
+
+export type ActivityUpdate = ActivityUpdateDto;
+
+export const mapActivityUpdateDtoToActivityUpdate = (dto: ActivityUpdateDto): ActivityUpdate => ({
+    ...dto,
+});

frontend/src/types/base.ts

@@ -0,0 +1,8 @@
+import { UserId } from "./value-ids";
+
+export type BaseEntity = {
+    createdAt: Date;
+    updatedAt: Date;
+    lastEditorID: UserId;
+};
+

frontend/src/types/company.ts

@@ -0,0 +1,27 @@
+import { BaseEntity } from "./base";
+import { CompanyDto, CompanyCreateDto, CompanyUpdateDto } from "./dto";
+import { UserId, CompanyId } from "./value-ids";
+
+export type Company = Omit<CompanyDto, "id" | "createdAt" | "updatedAt" | "lastEditorID"> & {
+    id: CompanyId;
+} & BaseEntity;
+
+export const mapCompanyDtoToCompany = (dto: CompanyDto): Company => ({
+    ...dto,
+    id: dto.id as CompanyId,
+    createdAt: new Date(dto.createdAt),
+    updatedAt: new Date(dto.updatedAt),
+    lastEditorID: dto.lastEditorID as UserId,
+});
+
+export type CompanyCreate = CompanyCreateDto;
+
+export const mapCompanyCreateDtoToCompanyCreate = (dto: CompanyCreateDto): CompanyCreate => ({
+    ...dto,
+});
+
+export type CompanyUpdate = CompanyUpdateDto;
+
+export const mapCompanyUpdateDtoToCompanyUpdate = (dto: CompanyUpdateDto): CompanyUpdate => ({
+    ...dto,
+});

frontend/src/types/customer.ts

@@ -0,0 +1,27 @@
+import { BaseEntity } from "./base";
+import { CustomerDto, CustomerCreateDto, CustomerUpdateDto } from "./dto";
+import { UserId, CustomerId } from "./value-ids";
+
+export type Customer = Omit<CustomerDto, "id" | "createdAt" | "updatedAt" | "lastEditorID"> & {
+    id: CustomerId;
+} & BaseEntity;
+
+export const mapCustomerDtoToCustomer = (dto: CustomerDto): Customer => ({
+    ...dto,
+    id: dto.id as CustomerId,
+    createdAt: new Date(dto.createdAt),
+    updatedAt: new Date(dto.updatedAt),
+    lastEditorID: dto.lastEditorID as UserId,
+});
+
+export type CustomerCreate = CustomerCreateDto;
+
+export const mapCustomerCreateDtoToCustomerCreate = (dto: CustomerCreateDto): CustomerCreate => ({
+    ...dto,
+});
+
+export type CustomerUpdate = CustomerUpdateDto;
+
+export const mapCustomerUpdateDtoToCustomerUpdate = (dto: CustomerUpdateDto): CustomerUpdate => ({
+    ...dto,
+});

frontend/src/types/dto.ts

@@ -0,0 +1,166 @@
+// Code generated by tygo. DO NOT EDIT.
+
+//////////
+// source: activity_dto.go
+
+export interface ActivityDto {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  lastEditorID: string;
+  name: string;
+  billingRate: number /* float64 */;
+}
+export interface ActivityCreateDto {
+  name: string;
+  billingRate: number /* float64 */;
+}
+export interface ActivityUpdateDto {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+  lastEditorID?: string;
+  name?: string;
+  billingRate?: number /* float64 */;
+}
+
+//////////
+// source: company_dto.go
+
+export interface CompanyDto {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  lastEditorID: string;
+  name: string;
+}
+export interface CompanyCreateDto {
+  name: string;
+}
+export interface CompanyUpdateDto {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+  lastEditorID?: string;
+  name?: string;
+}
+
+//////////
+// source: customer_dto.go
+
+export interface CustomerDto {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  lastEditorID: string;
+  name: string;
+  companyId: number /* int */;
+}
+export interface CustomerCreateDto {
+  name: string;
+  companyId: number /* int */;
+}
+export interface CustomerUpdateDto {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+  lastEditorID?: string;
+  name?: string;
+  companyId?: number /* int */;
+}
+
+//////////
+// source: project_dto.go
+
+export interface ProjectDto {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  lastEditorID: string;
+  name: string;
+  customerId: number /* int */;
+}
+export interface ProjectCreateDto {
+  name: string;
+  customerId: number /* int */;
+}
+export interface ProjectUpdateDto {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+  lastEditorID?: string;
+  name?: string;
+  customerId?: number /* int */;
+}
+
+//////////
+// source: timeentry_dto.go
+
+export interface TimeEntryDto {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  lastEditorID: string;
+  userId: number /* int */;
+  projectId: number /* int */;
+  activityId: number /* int */;
+  start: string;
+  end: string;
+  description: string;
+  billable: number /* int */; // Percentage (0-100)
+}
+export interface TimeEntryCreateDto {
+  userId: number /* int */;
+  projectId: number /* int */;
+  activityId: number /* int */;
+  start: string;
+  end: string;
+  description: string;
+  billable: number /* int */; // Percentage (0-100)
+}
+export interface TimeEntryUpdateDto {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+  lastEditorID?: string;
+  userId?: number /* int */;
+  projectId?: number /* int */;
+  activityId?: number /* int */;
+  start?: string;
+  end?: string;
+  description?: string;
+  billable?: number /* int */; // Percentage (0-100)
+}
+
+//////////
+// source: user_dto.go
+
+export interface UserDto {
+  id: string;
+  createdAt: string;
+  updatedAt: string;
+  lastEditorID: string;
+  username: string;
+  password: string; // Note: In a real application, you would NEVER send the password in a DTO. This is just for demonstration.
+  role: string;
+  companyId: number /* int */;
+  hourlyRate: number /* float64 */;
+}
+export interface UserCreateDto {
+  username: string;
+  password: string; // Note: In a real application, you would NEVER send the password in a DTO. This is just for demonstration.
+  role: string;
+  companyId: number /* int */;
+  hourlyRate: number /* float64 */;
+}
+export interface UserUpdateDto {
+  id: string;
+  createdAt?: string;
+  updatedAt?: string;
+  lastEditorID?: string;
+  username?: string;
+  password?: string; // Note: In a real application, you would NEVER send the password in a DTO. This is just for demonstration.
+  role?: string;
+  companyId?: number /* int */;
+  hourlyRate?: number /* float64 */;
+}

frontend/src/types/project.ts

@@ -0,0 +1,27 @@
+import { BaseEntity } from "./base";
+import { ProjectDto, ProjectCreateDto, ProjectUpdateDto } from "./dto";
+import { UserId, ProjectId } from "./value-ids";
+
+export type Project = Omit<ProjectDto, "id" | "createdAt" | "updatedAt" | "lastEditorID"> & {
+    id: ProjectId;
+} & BaseEntity;
+
+export const mapProjectDtoToProject = (dto: ProjectDto): Project => ({
+    ...dto,
+    id: dto.id as ProjectId,
+    createdAt: new Date(dto.createdAt),
+    updatedAt: new Date(dto.updatedAt),
+    lastEditorID: dto.lastEditorID as UserId,
+});
+
+export type ProjectCreate = ProjectCreateDto;
+
+export const mapProjectCreateDtoToProjectCreate = (dto: ProjectCreateDto): ProjectCreate => ({
+    ...dto,
+});
+
+export type ProjectUpdate = ProjectUpdateDto;
+
+export const mapProjectUpdateDtoToProjectUpdate = (dto: ProjectUpdateDto): ProjectUpdate => ({
+    ...dto,
+});

frontend/src/types/timeentry.ts

@@ -0,0 +1,47 @@
+import { BaseEntity } from "./base";
+import { TimeEntryDto, TimeEntryCreateDto, TimeEntryUpdateDto } from "./dto";
+import { UserId, ProjectId, ActivityId, TimeEntryId } from "./value-ids";
+
+export type TimeEntry = Omit<TimeEntryDto, "id" | "start" | "end" | "userId" | "projectId" | "activityId" | "lastEditorID" | "createdAt" | "updatedAt"> & {
+    id: TimeEntryId;
+    start: Date;
+    end: Date;
+    userId: UserId;
+    projectId: ProjectId;
+    activityId: ActivityId;
+} & BaseEntity;
+
+export const mapTimeEntryDtoToTimeEntry = (dto: TimeEntryDto): TimeEntry => ({
+    ...dto,
+    id: dto.id as TimeEntryId,
+    start: new Date(dto.start),
+    end: new Date(dto.end),
+    userId: dto.userId.toString() as UserId,
+    projectId: dto.projectId.toString() as ProjectId,
+    activityId: dto.activityId.toString() as ActivityId,
+    createdAt: new Date(dto.createdAt),
+    updatedAt: new Date(dto.updatedAt),
+    lastEditorID: dto.lastEditorID as UserId,
+});
+
+export type TimeEntryCreate = Omit<TimeEntryCreateDto, "start" | "end"> & {
+    start: Date;
+    end: Date;
+};
+
+export const mapTimeEntryCreateDtoToTimeEntryCreate = (dto: TimeEntryCreateDto): TimeEntryCreate => ({
+    ...dto,
+    start: new Date(dto.start),
+    end: new Date(dto.end),
+});
+
+export type TimeEntryUpdate = Omit<TimeEntryUpdateDto, "start" | "end"> & {
+    start?: Date;
+    end?: Date;
+};
+
+export const mapTimeEntryUpdateDtoToTimeEntryUpdate = (dto: TimeEntryUpdateDto): TimeEntryUpdate => ({
+    ...dto,
+    start: dto.start ? new Date(dto.start) : undefined,
+    end: dto.end ? new Date(dto.end) : undefined,
+});

frontend/src/types/user.ts

@@ -0,0 +1,27 @@
+import { BaseEntity } from "./base";
+import { UserDto, UserCreateDto, UserUpdateDto } from "./dto";
+import { UserId } from "./value-ids";
+
+export type User = Omit<UserDto, "id" | "createdAt" | "updatedAt" | "lastEditorID"> & {
+    id: UserId;
+} & BaseEntity;
+
+export const mapUserDtoToUser = (dto: UserDto): User => ({
+    ...dto,
+    id: dto.id as UserId,
+    createdAt: new Date(dto.createdAt),
+    updatedAt: new Date(dto.updatedAt),
+    lastEditorID: dto.lastEditorID as UserId,
+});
+
+export type UserCreate = Omit<UserCreateDto, never>;
+
+export const mapUserCreateDtoToUserCreate = (dto: UserCreateDto): UserCreate => ({
+    ...dto,
+});
+
+export type UserUpdate = Omit<UserUpdateDto, never>;
+
+export const mapUserUpdateDtoToUserUpdate = (dto: UserUpdateDto): UserUpdate => ({
+    ...dto,
+});

frontend/src/types/value-ids.ts

@@ -0,0 +1,10 @@
+export type ValueId<T = string> = string & { __valueId: T };
+
+export type CustomerId = ValueId<"CustomerId">;
+export type ProjectId = ValueId<"ProjectId">;
+export type TimeEntryId = ValueId<"TimeEntryId">;
+export type CompanyId = ValueId<"CompanyId">;
+export type UserId = ValueId<"UserId">;
+export type RoleId = ValueId<"RoleId">;
+export type PermissionId = ValueId<"PermissionId">;
+export type ActivityId = ValueId<"ActivityId">;

frontend/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}