System-Step 1 von 9
Systementwurf spezifizieren
Aus dem Practice Brief den Systementwurf ableiten: Welche Fähigkeiten muss das System bereitstellen, damit die vorbereitete Frage nachvollziehbar geklärt wird?
Was du mitnimmst
Aus dem Practice Brief wird ein Systementwurf: Welche Systemfähigkeiten ausgearbeitet werden müssen.
Systemziel
Was hier geklärt wird
Du formulierst, was das System leisten muss, damit der vorbereitete Fall technisch umgesetzt werden kann.
Kontext
Die Architekturfrage
Die Architekturfrage lautet: Welche technischen Fähigkeiten braucht ein GraphRAG-System, damit die vorbereitete Fachfrage belastbar beantwortet werden kann?
Das gewünschte Ergebnis gibt die Richtung vor. Es soll zeigen, welche Regel für CRM gilt, welche Projekte und Teams dadurch relevant werden, aus welchen Quellen das kommt und über welchen Pfad die Verbindung entsteht. Daraus entstehen fünf Arbeitsstränge.
Erstens braucht das System eine Ingestion-Pipeline, die Quellen in nutzbare Artefakte überführt. Zweitens braucht es eine Speicherarchitektur für Text, Graphdaten, Belege und Anfrageprotokolle. Drittens braucht es ein Graphschema für Labels, Beziehungstypen und Pflichtfelder. Viertens braucht es einen Anfrageweg für Textsuche, Entity Linking, Graphpfad und Kontextpaket. Fünftens braucht es einen Prototyp-Slice, der diesen Systementwurf prüft.
Prinzip
Architekturprinzip
Zuerst ist klar, was das System liefern soll. Daraus entsteht der Systementwurf.
Der Systemdesign-Entwurf wächst aus dem Systementwurf: Dieser Schritt formuliert ihn, die folgenden Schritte arbeiten ihn technisch aus.
Systementwicklung
Systementwurf
Der Systementwurf übersetzt den Practice Brief in technische Arbeit: links steht, was fachlich schon vorbereitet ist, rechts steht, was das System daraus leisten muss.
| Aus dem Practice Brief | Daraus folgt für den Entwurf |
|---|---|
| Was geklärt werden soll | Regel, Projekt, Team, Quellenbeleg und Pfad müssen gemeinsam sichtbar werden |
| Quellenlage | Quellen müssen verarbeitet, versioniert und auffindbar gemacht werden |
| Beziehungspfad | Fachliche Beziehungen müssen als Graphstruktur abfragbar sein |
| Nachweisbarkeit | Aussagen brauchen Herkunft, Gültigkeit und verwendete Quellen |
| Laufzeitverhalten | Die Anfrage braucht eine Route über Textsuche, Entity Linking, Graphpfad und Kontextpaket |
| Prüfung | Ein kleiner Prototyp-Slice muss den Ablauf mit einer Testfrage zeigen |
Dieser Systementwurf ist der Startpunkt für das Systemdesign. Er sagt, welche Fähigkeiten die Architektur danach ausarbeiten muss.
Abwägen
Trade-off
Was wird einfacher, was schwieriger?
Die Entscheidung: Du startest mit einem schmalen Systementwurf. Er beschreibt genau den Kern, der für die vorbereitete Frage gebraucht wird: Quellen verarbeiten, CRM erkennen, den Pfad zu Projekt und Team abfragen, Ergebnis belegen und Trace speichern.
Die Konsequenz: Mehrere Systeme, Rollenmodelle, Live-Updates, Kosten und Betriebsregeln bleiben zunächst offen. Dafür werden die nächsten Architekturentscheidungen leichter, weil klar ist, welche Komponenten, technischen Ablagen und Laufzeitwege wirklich zum Kern gehören.
Der Trade-off hilft dir beim Grundverständnis: Du spezifizierst zuerst den GraphRAG-Kern und ziehst Betrieb, Governance und Produktumfang später nach.
Fehlerbild
Typischer Baufehler
Worauf du achten musst
Die typische Falle: Der Systementwurf bleibt eine Wiederholung des Practice Briefs. Die fachliche Frage ist beschrieben, aber die benötigten Systemfähigkeiten sind noch nicht sichtbar.
Das erkennst du an Sätzen wie: "Wir brauchen Quellen und Beziehungen", ohne zu benennen, welche Komponente Quellen verarbeitet, welcher Pfad abgefragt wird, wo Belege liegen und welcher Trace den Ablauf zeigt.
Halte zuerst den Systementwurf fest: Was soll geklärt werden, welche Informationen braucht das System, welche Fähigkeiten folgen daraus?
Prüfen
Woran du es erkennst
Prüfpunkt
Du erkennst den Bedarf an einem Systementwurf, wenn fachlicher Fall und technische Arbeit noch ineinanderlaufen. Der Prüfpunkt ist erfüllt, wenn du jede nötige Systemfähigkeit einem folgenden Schritt zuordnen kannst.
Üben
Mini-Aufgabe
Formuliere den Systementwurf für den Mini-Use-Case. Notiere, was geklärt werden soll, welche Systemfähigkeiten dafür nötig sind und wo diese Fähigkeiten später ausgearbeitet werden.
Musterlösung
Was geklärt werden soll
Das System zeigt, welche Projekte und Teams betroffen sind, wenn CRM jährlich geprüft werden muss.
Benötigte Systemfähigkeiten
- 1Quellen aus Richtlinie, Systemkatalog und Projektliste verarbeiten.
- 2CRM als System eindeutig erkennen.
- 3Beziehungen von System zu Projekt und Team als Graphpfad abfragen.
- 4Textbelege und Graphpfad zu einem Kontextpaket verbinden.
- 5Ergebnis mit Quellen und Trace erzeugen.
Architekturbereiche
Die folgenden Schritte spezifizieren Komponenten, Ingestion-Pipeline, Speicherarchitektur, Graphschema, Anfrageweg, Toolklassen und Prototyp-Slice.
Reflektieren
Selbsttest
1.Was ist das Ziel dieses Schritts?
Du leitest aus dem Practice Brief den Systementwurf ab.
2.Warum steht der Systementwurf am Anfang?
Der Systementwurf macht sichtbar, welche Systemfähigkeiten in den folgenden Schritten spezifiziert werden.
3.Was muss im Systementwurf sichtbar sein?
Was geklärt werden soll, benötigte Systemfähigkeiten, Architekturbereiche und Prüffrage.
Kernaussage
Aus dem Practice Brief wird ein Systementwurf: Welche Systemfähigkeiten ausgearbeitet werden müssen.