Remove Dom prefix from domain models: rename classes to reflect business terminology, update references in tests, repositories, and services; add ADR for new naming conventions.

2026-04-08 23:00:49 +02:00
parent e83b09fd63
commit f2dff2a4d8
5 changed files with 76 additions and 9 deletions
@@ -0,0 +1,57 @@
+---
+type: ADR
+status: ACCEPTED
+date: 2026-04-08
+deciders: Lead Architect, Backend Developer
+---
+
+# ADR-0023: Naming Convention für Domain-Entitäten (kein `Dom`-Präfix)
+
+## Status
+
+**ACCEPTED** – Umgesetzt in Session 2026-04-08 (Phase 1 & 2 Domain Clean-Up).
+
+## Kontext
+
+In der frühen Entwicklungsphase wurden Domain-Klassen mit dem Präfix `Dom` versehen
+(z.B. `DomBewerb`, `DomVeranstaltung`, `DomTurnier`), um sie von DTOs und Datenbank-Entitäten
+zu unterscheiden. Diese Konvention hat sich als unnötig und verwirrend erwiesen, da sie
+gegen die Prinzipien der **Ubiquitous Language** (DDD) und der **Clean Architecture** verstößt.
+
+## Entscheidung
+
+**Domain-Entitäten tragen ab sofort ihren fachlichen Namen ohne Präfix.**
+
+| Schicht         | Namenskonvention        | Beispiel              |
+|-----------------|-------------------------|-----------------------|
+| **Domain**      | `<FachlicheName>`       | `Bewerb`              |
+| **Datenbank**   | `<FachlicheName>Table`  | `BewerbTable`         |
+| **Persistence** | `<FachlicheName>Entity` | `BewerbEntity`        |
+| **API/Transfer**| `<FachlicheName>Dto`    | `BewerbDto`           |
+
+## Durchgeführte Umbenennungen (Phase 1)
+
+| Alt (Dom-Präfix)      | Neu (Clean Name)    | Modul           |
+|-----------------------|---------------------|-----------------|
+| `DomBewerb`           | `Bewerb`            | entries-domain  |
+| `DomAbteilung`        | `Abteilung`         | entries-domain  |
+| `DomNennung`          | `Nennung`           | entries-domain  |
+| `DomNennungsTransfer` | `NennungsTransfer`  | entries-domain  |
+| `DomTurnier`          | `Turnier`           | events-domain   |
+| `DomAusschreibung`    | `Ausschreibung`     | events-domain   |
+| `DomVeranstaltung`    | `Veranstaltung`     | events-domain (bereits vorhanden, Duplikat gelöscht) |
+
+## Konsequenzen
+
+- **Positiv:** Ubiquitous Language im Code – Fachexperten und Entwickler sprechen dieselbe Sprache.
+- **Positiv:** Weniger kognitive Last – kein mentales Mapping zwischen `DomBewerb` und `Bewerb`.
+- **Positiv:** Entspricht Clean Architecture – die Domain-Schicht ist die "reine" Schicht.
+- **Negativ:** Einmalige Umbenennung erfordert Anpassung aller Referenzen (wurde systemweit durchgeführt).
+- **Achtung:** Datenbank-Migrationen (Flyway) und Repository-Mappings werden in Phase 3 separat behandelt.
+
+## Coding Guideline (verbindlich ab sofort)
+
+> **Neue Domain-Klassen werden NIEMALS mit `Dom`, `Model`, `Entity` oder ähnlichen
+> technischen Präfixen/Suffixen versehen. Der fachliche Name ist der Klassenname.**
+>
+> Ausnahmen: Datenbank-Klassen (`...Table`, `...Entity`) und Transfer-Objekte (`...Dto`, `...Request`, `...Response`).