Terminology Style Guide

Die Dokumentation bleibt deutsch. Etablierte Fachbegriffe – insbesondere Mehrwortbegriffe – bleiben im englischen Original. Bei der ersten Nennung steht die deutsche Erklärung in Klammern.

Codefluss vom Request bis zur Plattform

Der Code Explorer ist wie ein Stadtplan für einen Request. Jede Datei übernimmt eine klar begrenzte Aufgabe: Der Controller nimmt die Anfrage an, der Use Case koordiniert, das Aggregate schützt Regeln, Adapter sprechen Datenbank und Messaging an.

Alltagstaugliche Ablaufbeschreibung

Dieser Abschnitt beschreibt den Ablauf ohne unnötige Fachsprache. Er dient als Brücke zwischen dem sichtbaren Ergebnis und der technischen Umsetzung.

HTTP Request
Controller
Command
Application Service
Domain Aggregate
Repository Port
JPA Adapter
PostgreSQL
Outbox Adapter
Kafka
Telemetrie.

Fachlicher Ablauf

Ein fachliches Ereignis informiert andere Bereiche darüber, dass sich etwas Relevantes geändert hat. Der sendende Bereich bleibt verantwortlich für seine Aussage; empfangende Bereiche entscheiden selbst, wie sie darauf reagieren.

Fachliches Ziel: Der Ablauf liefert ein fachlich eindeutiges und für Benutzer beziehungsweise Betrieb nachvollziehbares Ergebnis.
Verantwortung: Jeder beteiligte Bereich entscheidet nur innerhalb seiner eigenen fachlichen Zuständigkeit.
Sichtbares Ergebnis: Order, Inventory, Payment und Notification können unabhängig reagieren, ohne eng gekoppelte synchrone Aufrufketten.

Technischer Ablauf

Der Producer schreibt ein Event in ein Topic. Partitionierung bestimmt Reihenfolge und Parallelität, Consumer Groups verteilen Arbeit, Offsets dokumentieren den Verarbeitungsstand. Retry, Idempotenz und Dead Letter Queue schützen vor Doppelwirkung und dauerhaft fehlerhaften Nachrichten.

Daten und Schnittstellen: Daten werden an jeder Grenze validiert und nur über definierte APIs, Ports oder Events weitergegeben.
Fehlerbehandlung: Fehler werden dort behandelt, wo ausreichender Kontext und Verantwortung vorhanden sind; Wiederholungen müssen sicher und nachvollziehbar bleiben.
Technischer Nachweis: Geprüft werden Producer-Erfolg, Topic/Partition, Consumer Lag, Offset-Fortschritt, Retry-Zahl und DLQ-Einträge.

Zusammenspiel: Der fachliche Ablauf erklärt, warum etwas geschieht und welches Ergebnis zählt. Der technische Ablauf erklärt, wie dieses Ergebnis zuverlässig, sicher und beobachtbar umgesetzt wird.

Verbindliche Regeln

Mehrwortbegriffe haben Vorrang vor Einzelwörtern.
Erstnennung: Transaction Boundary (Transaction Boundary).
Danach: Transaction Boundary.
Code, Identifiers, APIs, Dateinamen und technische Schlüssel werden nicht automatisch verändert.
Mehrdeutige Begriffe werden nur gemeldet und manuell geprüft.

Tatsächlich geprüfte deutsche Varianten

Deutsche Variante	Bevorzugter Fachbegriff	Regel	Automatisch korrigierte Vorkommen
Transaction Boundaries	Transaction Boundaries	first-bilingual	2
Transaction Boundary	Transaction Boundary	first-bilingual	1
Trust Boundaries	Trust Boundaries	first-bilingual	18
Trust Boundary	Trust Boundary	first-bilingual	0
Service Boundaries	Service Boundaries	first-bilingual	0
Service Boundary	Service Boundary	first-bilingual	0
Aggregate Root	Aggregate Root	first-bilingual	0
Value Object	Value Object	first-bilingual	0
Domain Event	Domain Event	first-bilingual	0
Domänendienst	Domain Service	first-bilingual	0
Consumer Groups	Consumer Groups	first-bilingual	0
Consumer Group	Consumer Group	first-bilingual	0
Dead Letter Queue	Dead Letter Queue	first-bilingual	0
Dead Letter Queue	Dead Letter Queue	first-bilingual	0
Access Token	Access Token	first-bilingual	2
Refresh Token	Refresh Token	first-bilingual	0
Authorization Server	Authorization Server	first-bilingual	0
Resource Server	Resource Server	first-bilingual	0
Identity Provider	Identity Provider	first-bilingual	0
Service Account	Service Account	first-bilingual	0
Deployment Strategy	Deployment Strategy	first-bilingual	0
Rollende Aktualisierung	Rolling Update	first-bilingual	0
Blau-Grün-Bereitstellung	Blue-Green Deployment	first-bilingual	0
Kanarenbereitstellung	Canary Deployment	first-bilingual	0
Infrastructure as Code	Infrastructure as Code	first-bilingual	0
Kontinuierliche Integration	Continuous Integration	first-bilingual	0
Kontinuierliche Bereitstellung	Continuous Delivery	first-bilingual	0
Kontinuierliches Deployment	Continuous Deployment	first-bilingual	0
Error Budget	Error Budget	first-bilingual	12
Burn Rate	Burn Rate	first-bilingual	0
Recovery Point Objective	Recovery Point Objective	first-bilingual	0
Recovery Time Objective	Recovery Time Objective	first-bilingual	0
Lebensfähigkeitsprüfung	Liveness Probe	first-bilingual	0
Readiness Probe	Readiness Probe	first-bilingual	0
Startup Probe	Startup Probe	first-bilingual	0
Correlation ID	Correlation ID	first-bilingual	0
Garbage Collector	Garbage Collector	first-bilingual	0
Ablaufverfolgung	Tracing	first-bilingual	0
Workbook	Workbook	always-english	0
Arbeitsbereich	Workspace	context-review	0
Knowledge Graph	Knowledge Graph	always-english	2
Learning Path	Learning Path	first-bilingual	27

Geschützte englische Begriffe

Access Token
Aggregate Root
Artifact
Authorization Server
Blue-Green Deployment
Bounded Context
Burn Rate
Canary Deployment
Circuit Breaker
Class Loader
Clean Architecture
ConfigMap
Consumer Group
Consumer Lag
Continuous Delivery
Continuous Deployment
Continuous Integration
Correlation ID
DaemonSet
Dashboard
Dead Letter Queue
Deployment
Deployment Strategy
Dockerfile
Domain Event
Domain Service
Error Budget
Event Sourcing
Garbage Collector
Health Check
Hexagonal Architecture
Horizontal Pod Autoscaler
Identity Provider
Incident
Infrastructure as Code
Knowledge Graph
Learning Path
Liveness Probe
OpenTelemetry
Persistent Volume
Pipeline
Playbook
Playground
Postmortem
Rate Limiting
Readiness Probe
Recovery Point Objective
Recovery Time Objective
Refresh Token
ReplicaSet
Resource Server
Rollback
Rolling Update
Runbook
Schema Registry
Service Account
Service Boundary
Site Reliability Engineering
Stage
Startup Probe
StatefulSet
Storage Class
StorageClass
Testcontainers
Thread Pool
Transaction Boundary
Trust Boundary
Value Object
Virtual Thread
Workbook
Workspace