docs: massive restructuring of documentation, development guides and agent playbooks

2026-06-15 12:54:38 +02:00
parent e4988b4397
commit ce63303b2c
686 changed files with 45423 additions and 319 deletions
@@ -0,0 +1,65 @@
+---
+type: Journal
+status: ACTIVE
+owner: Curator
+last_update: 2026-04-10
+---
+
+# Journal Entry: 2026-04-10 - Billing Service Setup & ZNS Importer Hardening
+
+## 👷 [Backend Developer] / 🏗️ [Lead Architect] / 🧹 [Curator]
+
+### Zusammenfassung der Session
+
+In dieser Session wurde das Fundament für den Kassa-Service (`billing-context`) gelegt und die Robustheit des
+ZNS-Importers durch zusätzliche Integrationstests für Funktionäre gesteigert.
+
+### Wichtigste Ergebnisse
+
+1. **Billing Service Initialisierung & API:**
+  * `billing-service` Modul erstellt, konfiguriert und mit `core-domain` (Serialisierung) verknüpft.
+  * Exposed-Tabellendefinitionen (v1) für `TeilnehmerKonto` und `Buchung` implementiert.
+  * `BillingController` mit REST-Endpunkten für Konten, Buchungen und Historie erstellt.
+  * `TeilnehmerKontoService` um API-Methoden (`getKontoById`, `getKonto`, `getBuchungsHistorie`, `buche`) erweitert.
+  * Integrationstests (`TeilnehmerKontoServiceTest`) erfolgreich mit H2-In-Memory-DB durchgeführt.
+  * **OpenAPI-Dokumentation:** `documentation.yaml` für `billing-service` erstellt und CRUD-Endpunkte für Konten und
+    Buchungen dokumentiert.
+2. **Entries-Integration (Neu):**
+  * Automatische Buchung von Nenngeld und Nachnenngebühren bei Einreichung einer Nennung implementiert.
+  * Erweiterung der `Bewerb`-Entität um Finanzfelder (`nenngeld_cent`, `nachnenngebuehr_cent`).
+  * Neue Flyway-Migration `V8__add_bewerb_financial_fields.sql` im `entries-service` hinzugefügt.
+  * `NennungUseCases` nutzt nun den `TeilnehmerKontoService` zur automatischen Belastung der Teilnehmerkonten (negativer
+    Saldo).
+  * `EntriesServiceApplication` scannt nun auch `at.mocode.billing` Pakete für die Cross-Context Integration.
+3. **ZNS-Importer Hardening:**
+  * Erweiterung von `ZnsImportServiceTest` um Tests für mehrfache Qualifikationen und die Update-Strategie (
+    Delete+Insert) bei Funktionären (`RICHT01.dat`).
+  * Alle 11 Integrationstests sind erfolgreich durchgelaufen.
+4. **Kompilations-Fixes (Billing):**
+  * `billing-service` auf korrekte Exposed DSL Syntax (`selectAll().where { ... }`) umgestellt.
+  * Explizite `transaction { ... }` Blöcke in `TeilnehmerKontoService` eingeführt.
+  * Typ-Konsistenz für `Instant` (kotlin.time) in `billing-domain` zur Übereinstimmung mit `core-domain` hergestellt.
+
+### Betroffene Dateien
+
+- `backend/services/billing/` (Neuer SCS-Kontext)
+- `backend/infrastructure/zns-importer/src/test/kotlin/at/mocode/zns/importer/ZnsImportServiceTest.kt`
+
+### Nächste Schritte
+
+- [x] Integration des Billing-Services in den `entries-context` (automatische Buchung bei Nennung).
+- [x] Fix von Kompilationsfehlern und Test-Regressionen (H2/Exposed Kompatibilität).
+- UI-Anbindung im Frontend für Kontenübersicht und manuelle Buchungen.
+- Erweiterung der Abrechnungs-Logik (z.B. Rechnungserstellung als PDF).
+
+### Technische Details & Fixes
+
+- **Exposed / H2:** `TIMESTAMPTZ` in Flyway-Migrationen auf `TIMESTAMP WITH TIME ZONE` umgestellt, um H2-Kompatibilität
+  in Integrationstests zu gewährleisten.
+- **Multi-Tenancy:** `ExposedTenantTransactions` unterstützt nun sowohl PostgreSQL (`SET search_path`) als auch H2 (
+  `SET SCHEMA`).
+- **Billing Config:** `BillingDatabaseConfiguration` ist nun robust gegen fehlende JDBC-URLs (wichtig für modularisierte
+  Tests).
+
+---
+*Co-authored-by: Junie <junie@jetbrains.com>*