Architektur-First bedeutet, die Entscheidungen vor der Umsetzung zu klären, die einen ersten Release unsicher oder spätere Änderungen teuer machen könnten. Dafür braucht ein Startup kein vollständiges Modell eines Geschäfts, dessen Markt noch nicht feststeht.
Das sinnvolle Ergebnis ist überschaubar: ein erster Kundenablauf, klare Daten- und Berechtigungsregeln, bekannte externe Abhängigkeiten und ein Weg, das System zu betreiben und weiterzuentwickeln. Ein Diagramm hilft, wenn es diese Entscheidungen erklärt. Es reicht nicht, wenn daraus niemand funktionierende Software ableiten kann.
Mit einem vollständigen Kundenablauf beginnen
Nehmen wir als Beispiel ein Kundenportal: Ein Kunde lädt eine Anfrage hoch, ein Mitarbeiter prüft sie, anschließend erhält der Kunde ein Ergebnis. Vor der Bibliothekswahl muss feststehen, wer welchen Schritt ausführen darf, wann die Anfrage angenommen ist und was bei einem Fehler passiert.
Das Beispiel ist hypothetisch. Es macht die Architekturfragen konkret:
- Sieht jeder Kunde ausschließlich seine eigenen Anfragen?
- Erzeugt ein Upload einen Entwurf oder eine verbindlich eingereichte Anfrage?
- Wo liegt der maßgebliche Bearbeitungsstatus?
- Darf ein Mitarbeiter Fehler korrigieren, und wird die Änderung protokolliert?
- Was passiert, wenn der Benachrichtigungsdienst ausfällt?
- Kann ein anderer Entwickler diesen Ablauf veröffentlichen und wiederherstellen?
Halten Sie den ersten Release klein. Weitere Rollen und Integrationen können warten. Eine notwendige Berechtigungsprüfung oder ein zuverlässiger Einreichungsstatus gehören dagegen bereits zum gewählten Ablauf. Produktvalidierung und Betriebssicherheit müssen gemeinsam geplant werden.
Domänen und Datenverantwortung festlegen
Eine Domäne beschreibt einen fachlichen Verantwortungsbereich, etwa Identität, Anfragen, Abrechnung oder Benachrichtigungen. Ein Bounded Context gibt den darin verwendeten Begriffen eine eindeutige Bedeutung. Ein Rechnungskunde und eine Person mit Portalzugang können zusammengehören, ohne derselbe Datensatz zu sein.
Legen Sie für wichtige Daten fest, welcher Bereich sie verantwortet, wer sie verändern darf und wie andere Bereiche von Änderungen erfahren. Auch in einer gemeinsamen Datenbank lassen sich klare Zuständigkeiten umsetzen. Getrennte Datenbanken schaffen diese Klarheit nicht automatisch.
Im Portalbeispiel gehört der Prüfstatus zum Anfrageprozess. Eine fehlgeschlagene E-Mail darf eine angenommene Anfrage nicht unbemerkt wieder zum Entwurf machen. Das Versandprotokoll beschreibt die Benachrichtigung; es ersetzt keinen maßgeblichen Anfragedatensatz.
Definieren Sie die Begriffe, über die sonst später Streit entsteht: Entwurf, eingereicht, angenommen, abgeschlossen und storniert. Oberfläche, API, Datenbank und Arbeitsanweisung müssen darunter dasselbe verstehen.
Schnittstellen einschließlich Fehlerfällen beschreiben
Ein API-Vertrag braucht mehr als die erfolgreiche JSON-Antwort. Dazu gehören Eingaben, Validierung, Authentifizierung, objektbezogene Berechtigungen, erwartete Fehler und die Bedeutung einer erfolgreichen Antwort. Wo Wiederholungen doppelte Zahlungen, Anfragen oder externe Aktionen auslösen könnten, muss das Verhalten ausdrücklich geregelt sein.
Für eine externe Integration sind außerdem diese Entscheidungen nötig:
| Entscheidung | Was das Team wissen muss |
|---|---|
| Maßgebliche Quelle | Welches System bei widersprüchlichen Werten zuständig ist |
| Übertragung | Direkter Aufruf, Queue, Webhook oder Polling |
| Fehlerbehandlung | Was wiederholt wird, was ein Mitarbeiter sieht und wer eingreift |
| Kompatibilität | Welche Vertragsversionen Sender und Empfänger unterstützen |
| Wiederherstellung | Wie fehlende oder doppelte Nachrichten erkannt und abgeglichen werden |
Beginnen Sie mit den Abhängigkeiten, die der erste Ablauf tatsächlich benötigt. Eine vorsorglich eingeführte Event-Plattform kann mehr Betriebsaufwand schaffen, als das MVP rechtfertigt.
Ein Betriebsmodell wählen, das das Team beherrscht
Ein modularer Monolith ist häufig ein sinnvoller Anfang: eine gemeinsam veröffentlichte Anwendung mit klaren internen Zuständigkeiten. Auch damit lassen sich erhebliche Lasten bedienen, wenn Datenbank, Abfragen, Workloads und Infrastruktur zum Bedarf passen.
Microservices können sinnvoll sein, wenn unabhängige Releases, Teamzuständigkeiten, Lastverteilung oder Isolation den zusätzlichen Aufwand begründen. Dazu kommen Netzwerkfehler, verteilte Fehlersuche, Vertragskompatibilität und Wiederherstellung über Systemgrenzen. Keines der Modelle garantiert Skalierbarkeit oder einfache Wartung.
Wählen Sie die einfachste Variante, die die bekannten Anforderungen erfüllt. Die Abwägung vertieft unser Artikel zu Monolithen und Microservices für frühe Produkte.
Annahmen und Entscheidungen dokumentieren
Ein Architecture Decision Record kann kurz sein: Kontext, betrachtete Optionen, Entscheidung, Folgen und Anlass für eine erneute Prüfung. Frühe Einträge erklären etwa Mandantentrennung, Dateispeicherung, Zahlungsanbieter oder die Notwendigkeit eines Hintergrundjobs.
Trennen Sie Anforderungen von Annahmen. „Kunden benötigen Zugriff auf die Berichte des letzten Monats“ ist etwas anderes als „wir erwarten zehntausend gleichzeitige Nutzer“. Die erste Aussage wird fachlich geprüft, die zweite untersucht, bevor daraus ein Infrastrukturdesign entsteht.
Wie viel Vorbereitung sinnvoll ist, hängt von Ablauf und Risiko ab. Ein Prototyp mit Wegwerfdaten braucht weniger als ein Produkt mit Zahlungen oder vertraulichen Dokumenten. Eine feste Zahl an Planungstagen macht nicht jedes Projekt baureif.
Den ersten Release betreibbar machen
Architektur muss vor der Veröffentlichung mit prüfbaren Ergebnissen verbunden werden:
| Frage | Sinnvoller Nachweis |
|---|---|
| Werden Zugriffsgrenzen durchgesetzt? | Serverseitige Prüfungen für Rollen, Mandanten und abgewiesene Zugriffe |
| Übersteht der Ablauf Fehler? | Geprüfte Fehlerzustände, Wiederholungen und gegebenenfalls Duplikatschutz |
| Kann das Team Änderungen veröffentlichen? | Reproduzierbarer Build, Deployment-Anleitung und Release-Prüfungen |
| Lassen sich Daten wiederherstellen? | Eine zum System passende Wiederherstellungsprobe mit bekannten Grenzen |
| Kann jemand anderes übernehmen? | Setup, Entscheidungen, Zuständigkeiten und bekannte Risiken |
Eine erfolgreiche Demo zeigt, dass ein bestimmter Pfad funktioniert hat. Sie beweist nicht, dass das System mit abgelaufenen Zugängen, einem fehlerhaften Deployment oder dem Weggang des ursprünglichen Entwicklers zurechtkommt.
Wenn ein bestehendes MVP bereits schwer zu ändern ist
Warnzeichen sind kleine Änderungen, die andere Abläufe beschädigen, Integrationen, die nur eine Person versteht, manuelle Releases und eine Einarbeitung, die vom Gründer abhängt. Diese Beobachtungen rechtfertigen eine Untersuchung; sie begründen noch keinen vollständigen Rewrite.
Erfassen Sie das aktuelle Verhalten und finden Sie die problematische Systemgrenze. Sichern Sie sie durch aussagekräftige Prüfungen ab. Die erste Änderung sollte begrenzt, überprüfbar und reversibel sein. Vergleichen Sie anschließend Aufwand und Fehler bei ähnlichen Änderungen. Die Zahl neuer Funktionen allein zeigt keine gesündere Lieferfähigkeit.
Bei einem Next.js-Produkt untersuchen Sie wiederholte Datenabrufe, sequenzielle externe Aufrufe, Cache-Verantwortung und über UI-Komponenten verteilte Geschäftsregeln. Framework-Fehler sind möglich. Eine Framework-Migration korrigiert aber weder ein unklares Datenmodell noch eine unzuverlässige Integration von selbst.
Was nach der Architekturarbeit vorliegen sollte
Das Team braucht einen abgegrenzten ersten Ablauf, eine System- und Datenflusskarte, Zugriffsregeln, wichtige Schnittstellenverträge, Annahmen zu Deployment und Wiederherstellung, ein kurzes Entscheidungsprotokoll und einen priorisierten Backlog. Offene Risiken brauchen Zuständigkeit und nächsten Schritt.
Unser Architecture Sprint beschreibt einen definierten Rahmen dafür. Die MVP- und SaaS-Entwicklung beginnt mit einer fokussierten Produktionsphase ab 13.000 €; der tatsächliche Umfang folgt dem Ablauf und seinen Risiken. Bei bestehenden Systemen sind gegebenenfalls Projekt-Rettung und Übernahme oder laufender Support der passende Einstieg.
Häufige Fragen
Muss vor dem Programmieren alles fertig entworfen sein?
Nein. Klären Sie wichtige Randbedingungen früh, setzen Sie einen vollständigen kleinen Ablauf um und passen Sie den Entwurf anhand der Ergebnisse an. Detailpläne für hypothetische spätere Funktionen können warten.
Verhindert Architektur-First jeden Rewrite?
Nein. Geschäftsmodell, Plattformabhängigkeiten oder Betriebsanforderungen können sich wesentlich ändern. Klare Grenzen und dokumentierte Entscheidungen helfen bei der Bewertung; sie garantieren nicht, dass der erste Entwurf dauerhaft geeignet bleibt.
Können KI-Werkzeuge diese Vorbereitung übernehmen?
Sie können Optionen untersuchen, Diagramme entwerfen und Code analysieren. Eine verantwortliche Person muss Fachregeln, Zugriffsgrenzen, Abhängigkeiten und Betriebsnachweise prüfen. Generierte Dokumentation hilft nur, wenn sie das tatsächlich gebaute System beschreibt.

