feat(devops): configure desktop packaging and introduce semantic versioning

- Added `nativeDistributions` for Linux (.deb), Windows (.msi), and macOS (.dmg) in `build.gradle.kts` with platform-specific settings, embedded JRE, and JVM-args. - Implemented centralized semantic versioning via `version.properties` as the single source of truth, applying it across all builds. - Introduced CI/CD release workflow (`.gitea/workflows/release.yml`) for auto-tagging, artifact builds, and release summaries. - Created `CHANGELOG.md` following Keep-a-Changelog format for tracking changes. - Documented icon requirements and packaging steps in `ICONS_PLACEHOLDER.md`. - Updated DevOps roadmap to reflect completed Sprint C-1 and C-2 tasks. Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
2026-04-03 11:26:43 +02:00
parent c696b8c50e
commit 7ff48ed3d7
9 changed files with 598 additions and 35 deletions
@@ -28,24 +28,37 @@
  - [x] Headless-Flag: `-Djava.awt.headless=true`
  - [x] Gradle Wrapper auf `9.4.0` aktualisiert

+### Sprint C — Abgeschlossen
+
+- [x] **C-1** | Desktop-App Packaging konfiguriert
+  - [x] `compose.desktop.nativeDistributions` vollständig in `build.gradle.kts` konfiguriert
+  - [x] Linux: `.deb`-Paket — `packageDeb` Task, Icon PNG 512×512, `debMaintainer`, `menuGroup`
+  - [x] Windows: `.msi`-Installer — `packageMsi` Task, Icon ICO, `upgradeUuid`, `menuGroup`, `shortcut`
+  - [x] macOS: `.dmg`-Image — `packageDmg` Task, Icon ICNS, `bundleID`, `appCategory`
+  - [x] App-Metadaten: `packageName`, `description`, `vendor`, `copyright`, `licenseFile`
+  - [x] Eingebettetes JRE: `modules(...)` mit minimalem JRE-Footprint konfiguriert
+  - [x] JVM-Args für gepackte App: `-Xms128m`, `-Xmx512m`, `-Dfile.encoding=UTF-8`
+  - [x] Icon-Ressourcen-Verzeichnis angelegt + `ICONS_PLACEHOLDER.md` mit Anforderungen
+  - [ ] ⚠️ **Offen:** Echte Icon-Dateien (`icon.png`, `icon.ico`, `icon.icns`) erstellen/einfügen
+  - [ ] ⚠️ **Offen:** Testinstallation auf Ziel-Betriebssystem durchführen (nach Icon-Erstellung)
+
+- [x] **C-2** | Semantic Versioning eingeführt
+  - [x] Versionierungsschema definiert: `MAJOR.MINOR.PATCH[-QUALIFIER]`
+  - [x] Zentrale Versionsquelle: `version.properties` im Root-Projekt (Single Source of Truth)
+  - [x] Root `build.gradle.kts`: Version wird aus `version.properties` gelesen (kein Hardcode mehr)
+  - [x] Desktop `build.gradle.kts`: `packageVersion` aus `version.properties` (reines `MAJOR.MINOR.PATCH`)
+  - [x] Git-Tagging-Strategie definiert: `vMAJOR.MINOR.PATCH` (z. B. `v1.0.0`)
+  - [x] Release-Workflow angelegt: `.gitea/workflows/release.yml`
+    - Trigger: Änderung an `version.properties` auf `main`/`master` + manuell (Dry-Run-Option)
+    - Job 1: Version lesen, Tag-Duplikat-Check, Git-Tag erstellen & pushen
+    - Job 2: Linux `.deb` bauen & als Artefakt hochladen
+    - Job 3: Windows `.msi` bauen & als Artefakt hochladen
+    - Job 4: Release-Summary (Markdown-Report)
+  - [x] `CHANGELOG.md` angelegt (Keep-a-Changelog-Format, SemVer)
+
 ---

-## 🔴 Sprint C — Priorität 1 (diese Woche)
-
- [ ] **C-1** | Desktop-App Packaging konfigurieren
-  - [ ] `compose.desktop.nativeDistributions` in `build.gradle.kts` konfigurieren
-  - [ ] Windows: `.msi`-Installer bauen
-  - [ ] Linux: `.deb`-Paket bauen
-  - [ ] macOS: `.dmg`-Image bauen (falls erforderlich)
-  - [ ] App-Icon und Metadaten (Name, Version, Publisher) eintragen
-  - [ ] Testinstallation auf Ziel-Betriebssystem durchführen
-
- [ ] **C-2** | Semantic Versioning einführen
-  - [ ] Versionierungsschema definieren: `MAJOR.MINOR.PATCH`
-  - [ ] Gemeinsame Versions-Quelle für Frontend und Backend festlegen
-  - [ ] Git-Tagging-Strategie definieren (`v1.0.0`, `v1.0.0-backend`, etc.)
-  - [ ] Release-Tagging in CI/CD-Pipeline integrieren
-  - [ ] `CHANGELOG.md`-Vorlage anlegen
+## 🔴 Sprint C — Restpunkte

 - [ ] **C-3** | Produktions-Deployment vorbereiten
  - [ ] Reverse-Proxy-Konfiguration (Nginx / Traefik) für Backend prüfen
@@ -71,17 +84,34 @@

 ## 📌 Abhängigkeiten

-| Warte auf                  | Von wem           | Betrifft            |
-|----------------------------|-------------------|---------------------|
-| ADR-0022 LAN-Sync          | 🏗️ Architect B-1 | D-2 mDNS-Infra      |
-| QA: Test-Integration in CI | 🧐 QA C-4         | C-1 Packaging-Tests |
+| Warte auf                   | Von wem           | Betrifft            |
+|-----------------------------|-------------------|---------------------|
+| ADR-0022 LAN-Sync           | 🏗️ Architect B-1 | D-2 mDNS-Infra      |
+| QA: Test-Integration in CI  | 🧐 QA C-4         | C-1 Packaging-Tests |
+| Icon-Dateien (PNG/ICO/ICNS) | 🖌️ UI/UX         | C-1 Release-Build   |

 ---

 ## 💡 Empfehlungen (nach Priorität)

-1. **C-1 Desktop-Packaging** — Für erste echte Auslieferung an Endnutzer zwingend notwendig; `.msi`/`.deb` sollten vor
-   dem ersten Beta-Test bereitstehen.
-2. **C-2 Semantic Versioning** — Ohne klare Versionierung ist kein koordiniertes Release möglich; einfach zu
-   implementieren, hoher Nutzen.
-3. **D-1 Tenant-Backup** — Wenn eine Veranstaltung = eine Datenbank, muss jeder Tenant einzeln gesichert werden können.
+1. **Icons erstellen** — Vor dem ersten echten Release-Build müssen `icon.png`, `icon.ico` und
+   `icon.icns` in `frontend/shells/meldestelle-desktop/src/jvmMain/resources/` abgelegt werden.
+   Siehe `ICONS_PLACEHOLDER.md` für Anforderungen und ImageMagick-Schnell-Befehle.
+2. **Testinstallation** — Nach Icon-Erstellung: `.deb` auf Ubuntu/Debian, `.msi` auf Windows 10/11
+   installieren und Startmenü-Eintrag / Desktop-Verknüpfung prüfen.
+3. **C-3 Produktions-Deployment** — Reverse-Proxy + HTTPS vor erstem Beta-Test konfigurieren.
+4. **D-1 Tenant-Backup** — Wenn eine Veranstaltung = eine Datenbank, muss jeder Tenant einzeln
+   gesichert werden können.
+
+---
+
+## 🗂️ Geänderte Dateien (diese Session)
+
+| Datei                                                                            | Änderung                                                               |
+|----------------------------------------------------------------------------------|------------------------------------------------------------------------|
+| `version.properties`                                                             | **NEU** — Zentrale SemVer-Quelle (`1.0.0-SNAPSHOT`)                    |
+| `build.gradle.kts` (root)                                                        | Version aus `version.properties` statt hardcoded                       |
+| `frontend/shells/meldestelle-desktop/build.gradle.kts`                           | Vollständige `nativeDistributions`-Konfiguration (Linux/Windows/macOS) |
+| `frontend/shells/meldestelle-desktop/src/jvmMain/resources/ICONS_PLACEHOLDER.md` | **NEU** — Icon-Anforderungen dokumentiert                              |
+| `.gitea/workflows/release.yml`                                                   | **NEU** — Release-Workflow (Tag + Packaging)                           |
+| `CHANGELOG.md`                                                                   | **NEU** — Keep-a-Changelog-Format                                      |
@@ -14,7 +14,7 @@
 | 👷 Backend    | ⚠️ A-1/A-3 offen | 🔴 B-1 teilweise                         | ⬜ Nicht gestartet | A-1 Rollout + Reiter/Pferde-APIs                      |
 | 🎨 Frontend   | ✅ Abgeschlossen  | 🟡 B-2 teilweise/B-3 teilweise/B-4 offen | ⬜ Nicht gestartet | B-2 StoreV2-Ablösung + B-3 Bewerb-Kontext-Validierung |
 | 📜 Rulebook   | ✅ Abgeschlossen  | 🔴 B-2 offen                             | ⬜ Nicht gestartet | B-2 Spec an Backend übergeben                         |
-| 🐧 DevOps     | ✅ Abgeschlossen  | ✅ Abgeschlossen                          | 🔴 C-1 offen      | C-1 Desktop-Packaging (.msi/.deb)                     |
+| 🐧 DevOps     | ✅ Abgeschlossen  | ✅ Abgeschlossen                          | ✅ C-1/C-2 fertig  | C-3 Produktions-Deployment                            |
 | 🧐 QA         | ✅ Abgeschlossen  | 🔴 B-1..B-4 offen                        | ⬜ Nicht gestartet | B-2 Onboarding-Tests + B-3 Abteilungs-Tests           |
 | 🖌️ UI/UX     | ✅ Abgeschlossen  | 🔴 B-1/B-4 offen                         | ⬜ Nicht gestartet | B-1 Finale Entscheidung Editier-Formulare             |
 | 🧹 Curator    | ✅ Abgeschlossen  | 🔴 B-1..B-3 offen                        | ⬜ Nicht gestartet | B-1 Roadmaps pflegen ← *diese Session*                |
@@ -63,8 +63,14 @@ Diese Aufgaben blockieren andere Agenten und müssen zuerst erledigt werden:

 ### 🐧 DevOps Engineer

-1. **C-1** Desktop-Packaging (`.msi` / `.deb`) konfigurieren
-2. **C-2** Semantic Versioning + Git-Tagging einführen
+1. ✅ **C-1** Desktop-Packaging (`.msi` / `.deb` / `.dmg`) konfiguriert
+  - `nativeDistributions` vollständig (Linux/Windows/macOS), JRE-Module, JVM-Args
+  - ⚠️ Icons (`icon.png`/`icon.ico`/`icon.icns`) noch ausstehend → 🖌️ UI/UX
+2. ✅ **C-2** Semantic Versioning + Git-Tagging eingeführt
+  - `version.properties` als Single Source of Truth
+  - `.gitea/workflows/release.yml`: Auto-Tag + `.deb`/`.msi` Packaging
+  - `CHANGELOG.md` angelegt
+3. 🔴 **C-3** Produktions-Deployment vorbereiten (nächste Session)

 ### 🧐 QA Specialist