feat: implement build-time versioning and log service version across all components

Author: maatini

.github/workflows/build.yml

@@ -92,7 +92,9 @@ jobs:
         uses: docker/build-push-action@v6
         with:
           context: .
-          build-args: SERVICE=${{ matrix.service }}
+          build-args: |
+            SERVICE=${{ matrix.service }}
+            VERSION=0.5.0
           platforms: linux/amd64
           load: true
           tags: dispatch/${{ matrix.service }}:ci

Dockerfile

@@ -6,10 +6,12 @@
 #   docker build --build-arg SERVICE=bouncemanagement -t dispatch/bouncemanagement .
 
 ARG SERVICE=mail-gateway
+ARG VERSION=0.5.0
 
 # ── Builder ───────────────────────────────────────────────────────────────────
 FROM golang:1.25-alpine AS builder
 ARG SERVICE
+ARG VERSION
 
 WORKDIR /src
 
@@ -18,7 +20,7 @@ RUN go mod download
 
 COPY . .
 RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
-    go build -trimpath -ldflags="-s -w" \
+    go build -trimpath -ldflags="-s -w -X dispatch/internal/version.Version=${VERSION}" \
     -o /bin/service ./cmd/${SERVICE}
 
 # ── Runtime ───────────────────────────────────────────────────────────────────

cmd/bouncemanagement/main.go

@@ -12,6 +12,7 @@ import (
 	"dispatch/internal/loggy"
 	"dispatch/internal/msgraph"
 	"dispatch/internal/natsutil"
+	"dispatch/internal/version"
 )
 
 var log = loggy.GetLogger("bouncemanagement")
@@ -49,7 +50,7 @@ func main() {
 	ticker := time.NewTicker(15 * time.Minute)
 	defer ticker.Stop()
 
-	log.Info("bouncemanagement started", loggy.Kv("mailbox", cfg.MSGraphBounceMailbox))
+	log.Info("bouncemanagement started", loggy.Kv("version", version.Version), loggy.Kv("mailbox", cfg.MSGraphBounceMailbox))
 
 	// run immediately on start
 	if err := crawler.Run(ctx); err != nil {

cmd/mail-admin/main.go

@@ -14,6 +14,7 @@ import (
 	"dispatch/internal/loggy"
 	"dispatch/internal/natsutil"
 	"dispatch/internal/sender"
+	"dispatch/internal/version"
 )
 
 var log = loggy.GetLogger("mail-admin")
@@ -79,7 +80,7 @@ func main() {
 	defer stop()
 
 	go func() {
-		log.Info("mail-admin started", loggy.Kv("port", cfg.Port))
+		log.Info("mail-admin started", loggy.Kv("version", version.Version), loggy.Kv("port", cfg.Port))
 		if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
 			log.Critical("server error", err)
 			os.Exit(1)

cmd/mail-gateway/main.go

@@ -15,6 +15,7 @@ import (
 	"dispatch/internal/quota"
 	"dispatch/internal/sender"
 	"dispatch/internal/spam"
+	"dispatch/internal/version"
 )
 
 var log = loggy.GetLogger("mail-gateway")
@@ -83,7 +84,7 @@ func main() {
 	defer stop()
 
 	go func() {
-		log.Info("mail-gateway started", loggy.Kv("port", cfg.Port))
+		log.Info("mail-gateway started", loggy.Kv("version", version.Version), loggy.Kv("port", cfg.Port))
 		if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
 			log.Critical("server error", err)
 			os.Exit(1)

cmd/mail-worker/main.go

@@ -11,6 +11,7 @@ import (
 	"dispatch/internal/loggy"
 	"dispatch/internal/msgraph"
 	"dispatch/internal/natsutil"
+	"dispatch/internal/version"
 	"dispatch/internal/worker"
 )
 
@@ -66,7 +67,7 @@ func main() {
 	ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
 	defer stop()
 
-	log.Info("mail-worker started")
+	log.Info("mail-worker started", loggy.Kv("version", version.Version))
 	if err := consumer.Run(ctx); err != nil {
 		log.Critical("consumer error", err)
 		os.Exit(1)

docs/ai-changes.md

@@ -30,6 +30,16 @@
 **Ergebnis:** Keine Tests betroffen (Dokumentation).
 **Hinweis:** **WICHTIG** – Ab sofort nach jeder Änderung Log-Eintrag pflichtig.
 
+## 2026-05-01 — Versionierung: internal/version + ldflags
+
+**Begründung:** Einheitliche Versionsnummer 0.5.0 in allen Services, beim Start geloggt und via `-X dispatch/internal/version.Version` zur Build-Zeit injizierbar.
+**Änderungen:**
+- `internal/version/version.go` (neues Paket, `var Version = "0.5.0"`)
+- `cmd/*/main.go` (alle 4 Services: `loggy.Kv("version", version.Version)` im Startup-Log)
+- `Dockerfile` (`ARG VERSION=0.5.0`, ldflags `-X dispatch/internal/version.Version=${VERSION}`)
+- `.github/workflows/build.yml` (`build-args: VERSION=0.5.0`)
+**Ergebnis:** `go build ./cmd/...` + `go test ./...` → 151 Tests, alles grün.
+
 ## 2026-05-01 — GitHub Workflows: Docker-Build, Trivy-Scan, SBOM
 
 **Begründung:** CI deckt jetzt den vollständigen Image-Lifecycle ab: Build → Vulnerability-Scan → SBOM → Push. Trivy SARIF-Upload ins GitHub Security-Tab ermöglicht Triage ohne externen Scan-Server.

internal/version/version.go

@@ -0,0 +1,4 @@
+package version
+
+// Version is set at build time via -ldflags "-X dispatch/internal/version.Version=x.y.z".
+var Version = "0.5.0"