Design-Tools für Junior-Entwickler: Der Blick über CRUD hinaus

Du hast CRUD-Funktionen fertiggestellt, aber nun kommen Zweifel an der Wartbarkeit auf. Die Angewohnheit, direkt mit dem Tabellendesign zu beginnen, führt oft dazu, dass sich das System verstrickt. Dieser Artikel enthält konkrete Methoden, um Code in Domänen zu unterteilen und Umgebungen zu standardisieren, um den Änderungsaufwand zu minimieren.

Code-Kohäsion erhöhen: Datenzugriff und Logik trennen

Wenn Geschäftslogik in den Controllern vermischt ist, musst du bei jeder Änderung der Datenbankstruktur den gesamten Code anpassen. Führe eine Layered Architecture ein, um beides zu isolieren. Dadurch kannst du die Wartungszeit der Codebasis um etwa 40 % reduzieren.

Die Schritte zur Trennung von Datenzugriff und Logik sind:

Verschiebe Validierungscode aus den Controllern in Request-DTOs und verwende Validierungs-Annotationen.
Bündle Logik, die in Transaktionsskripten verstreut ist, in Methoden innerhalb der Domänen-Entitäten.
Deklariere Schnittstellen, die Persistenzverhalten definieren, anstatt konkrete DB-Treiber zu verwenden, um die Trennung von der Domänenschicht zu gewährleisten.

Selbst wenn sich ein spezifisches Tabellenschema ändert, bleiben die Kernregeln unverändert erhalten.

Testumgebungen durch Dependency Injection schaffen

Wenn du Objekte innerhalb einer Klasse direkt mit dem new-Operator erzeugst, werden Unit-Tests unmöglich. Realisiere Inversion of Control (IoC), um unabhängige Tests mit Mock-Objekten durchzuführen, ohne externe Server zu benötigen.

Dies ist ein bewährtes Verfahren zur Effizienzsteigerung bei Tests:

Deklariere die Kollaborateure, die ein Objekt benötigt, als Schnittstellen statt als konkrete Klassen.
Konfiguriere den externen Container so, dass er zur Laufzeit die passenden Implementierungen injiziert.
Nutze Werkzeuge wie @automock/jest, um die Konfiguration von Test-Doubles zu automatisieren.

Durch diese Struktur kannst du die Ausführungsgeschwindigkeit deiner Tests um mehr als 20 % steigern.

Entitäten und DTOs isolieren

Wenn UI-Strukturen und DB-Tabellen eins zu eins aufeinander abgebildet werden, musst du bei jeder kleinen Änderung am UI auch das DB-Schema anfassen. Trenne strikt zwischen DTOs für Netzwerknachrichten und Domänen-Entitäten.

So isolierst du beide mittels Mappern:

Erstelle reine Mapper-Klassen, die sich ausschließlich auf die Datentransformation konzentrieren.
Übertrage Daten nur innerhalb des Mappers, um direkte Abhängigkeiten zwischen DTOs und Entitäten zu vermeiden.
Erzwinge, dass die Dienstschicht (Service Layer) nur Entitäten verwendet.

Selbst beim Austausch des Datenspeichers ist keine Anpassung der Logik erforderlich.

Entwicklungsumgebungen mit Docker Compose harmonisieren

Wenn die lokale Umgebung jedes Entwicklers anders aussieht, kommt die Zusammenarbeit zum Erliegen. Nutze Docker Compose, um die Infrastruktur als Code abzubilden und Umgebungen zu synchronisieren.

Das Verfahren zur Erstellung einer Standardumgebung:

Definiere die Versionen von DB- und Cache-Servern sowie Umgebungsvariablen in der docker-compose.yml Datei.
Lege das initiale SQL-Schema über Volume-Mounts in den Pfad /docker-entrypoint-initdb.d.
Verwende Paket-Linker wie pnpm Workspaces, um Abhängigkeitskonflikte zu vermeiden.

Nach dieser Konfiguration kannst du die Standard-Infrastruktur innerhalb von 3 Sekunden starten, ohne dich um die Konfiguration deiner lokalen Maschine sorgen zu müssen.

Domänenmodellierung vor dem Tabellendesign

Wer zuerst das ERD zeichnet, erhält oft nur eine datenzentrierte, fragmentierte Logik. Bei Shopify stellten über 800 Ingenieure ihr Modell von einem physikalischen, schemazentrierten Legacy-Ansatz auf ein geschäftsobjektorientiertes Modell um.

So startest du mit der Domänenmodellierung:

Liste die wichtigsten Substantive und Verben der Domäne basierend auf Use-Cases und einer Ubiquitous Language auf.
Definiere Entitäten, die Zustandsübergänge erfordern, sowie Value Objects mit unveränderlichen Eigenschaften.
Bestimme Aggregate Roots, um die geschäftliche Integrität auf Transaktionsebene zu verifizieren.

Dieser Ansatz begrenzt den Änderungsbereich auf bestimmte Module, selbst wenn sich die Anforderungen ändern. Die Modellierung komplexer Systeme ist das effektivste Mittel gegen das Gefühl der Überforderung.

Design-Tools für Junior-Entwickler: Der Blick über CRUD hinaus

Code-Kohäsion erhöhen: Datenzugriff und Logik trennen

Die Schritte zur Trennung von Datenzugriff und Logik sind:

Verschiebe Validierungscode aus den Controllern in Request-DTOs und verwende Validierungs-Annotationen.
Bündle Logik, die in Transaktionsskripten verstreut ist, in Methoden innerhalb der Domänen-Entitäten.
Deklariere Schnittstellen, die Persistenzverhalten definieren, anstatt konkrete DB-Treiber zu verwenden, um die Trennung von der Domänenschicht zu gewährleisten.

Selbst wenn sich ein spezifisches Tabellenschema ändert, bleiben die Kernregeln unverändert erhalten.

Testumgebungen durch Dependency Injection schaffen

Dies ist ein bewährtes Verfahren zur Effizienzsteigerung bei Tests:

Deklariere die Kollaborateure, die ein Objekt benötigt, als Schnittstellen statt als konkrete Klassen.
Konfiguriere den externen Container so, dass er zur Laufzeit die passenden Implementierungen injiziert.
Nutze Werkzeuge wie @automock/jest, um die Konfiguration von Test-Doubles zu automatisieren.

Durch diese Struktur kannst du die Ausführungsgeschwindigkeit deiner Tests um mehr als 20 % steigern.

Entitäten und DTOs isolieren

So isolierst du beide mittels Mappern:

Erstelle reine Mapper-Klassen, die sich ausschließlich auf die Datentransformation konzentrieren.
Übertrage Daten nur innerhalb des Mappers, um direkte Abhängigkeiten zwischen DTOs und Entitäten zu vermeiden.
Erzwinge, dass die Dienstschicht (Service Layer) nur Entitäten verwendet.

Selbst beim Austausch des Datenspeichers ist keine Anpassung der Logik erforderlich.

Entwicklungsumgebungen mit Docker Compose harmonisieren

Wenn die lokale Umgebung jedes Entwicklers anders aussieht, kommt die Zusammenarbeit zum Erliegen. Nutze Docker Compose, um die Infrastruktur als Code abzubilden und Umgebungen zu synchronisieren.

Das Verfahren zur Erstellung einer Standardumgebung:

Definiere die Versionen von DB- und Cache-Servern sowie Umgebungsvariablen in der docker-compose.yml Datei.
Lege das initiale SQL-Schema über Volume-Mounts in den Pfad /docker-entrypoint-initdb.d.
Verwende Paket-Linker wie pnpm Workspaces, um Abhängigkeitskonflikte zu vermeiden.

Nach dieser Konfiguration kannst du die Standard-Infrastruktur innerhalb von 3 Sekunden starten, ohne dich um die Konfiguration deiner lokalen Maschine sorgen zu müssen.

Domänenmodellierung vor dem Tabellendesign

So startest du mit der Domänenmodellierung:

Liste die wichtigsten Substantive und Verben der Domäne basierend auf Use-Cases und einer Ubiquitous Language auf.
Definiere Entitäten, die Zustandsübergänge erfordern, sowie Value Objects mit unveränderlichen Eigenschaften.
Bestimme Aggregate Roots, um die geschäftliche Integrität auf Transaktionsebene zu verifizieren.

Design-Tools für Junior-Entwickler: Der Blick über CRUD hinaus

관련 영상

Hör bitte auf, NUR CRUD-Projekte zu bauen (Ein häufiger Fehler bei Entwicklern)

Design-Tools für Junior-Entwickler: Der Blick über CRUD hinaus

Code-Kohäsion erhöhen: Datenzugriff und Logik trennen

Testumgebungen durch Dependency Injection schaffen

Entitäten und DTOs isolieren

Entwicklungsumgebungen mit Docker Compose harmonisieren

Domänenmodellierung vor dem Tabellendesign

커뮤니티의 다른 글

사내 시스템에 llm api 붙일 때 마주하는 현실적인 한계와 대응법

레거시 백엔드에 GPT-6 Astra 붙일 때 예산 승인과 보안 통과를 먼저 끝내는 법이 있습니다

에이전트끼리 대화하다 6천만 원 청구서가 나오는 이유

사내 RAG 벡터 검색에 Okta 권한 필터를 직접 거는 방법

브라우저 에이전트에게 내 구글 계정을 통째로 넘기면 안 되는 이유

Apple Won the AI Race

댓글 (0)

Design-Tools für Junior-Entwickler: Der Blick über CRUD hinaus

Code-Kohäsion erhöhen: Datenzugriff und Logik trennen

Testumgebungen durch Dependency Injection schaffen

Entitäten und DTOs isolieren

Entwicklungsumgebungen mit Docker Compose harmonisieren

Domänenmodellierung vor dem Tabellendesign