System-Step 8 von 9
Prototyp-Ausschnitt spezifizieren
Den kleinsten durchgehenden Systemlauf spezifizieren, der den Entwurf mit Testfrage, Quellen, Graphpfad, Ergebnis und Anfrageprotokoll prüft.
Was du mitnimmst
Ein Prototyp-Ausschnitt prüft eine Architekturannahme aus dem Systemdesign.
Systemziel
Was hier geklärt wird
Du legst fest, welchen Teil des Systemdesigns der Prototyp nachweist und welche Entscheidungen erst in den Betriebsteil gehören.
Kontext
Die Architekturfrage
Die Architekturfrage lautet: Welcher kleine Prototyp-Ausschnitt zeigt, dass der Systementwurf wirklich funktioniert?
Der Ausschnitt ist schmal. Er zeigt einen repräsentativen Pfad: Richtlinie A definiert eine Pflicht, CRM ist ein kritisches Kundensystem, CRM hängt an Projekt Alpha, Projekt Alpha hat ein verantwortliches Team.
Der Prototyp zeigt den Kern des Systemdesigns: Quelle finden, CRM erkennen, Graphpfad holen, Herkunft beilegen, Ergebnis formulieren und Anfrageprotokoll speichern.
Prinzip
Architekturprinzip
Der Prototyp prüft eine Frageklasse mit einem durchgehenden Systemlauf.
Der Ausschnitt bleibt bewusst klein: eine Testfrage, wenige Quellen, ein Graphpfad, eine Antwort und ein Anfrageprotokoll. So wird sichtbar, ob der Kern trägt: Quelle finden, Entität erkennen, Pfad abfragen, Kontextpaket bauen, Antwort nachvollziehbar machen.
Systementwicklung
Systembaustein
| Prototyp-Ausschnitt | Muss sichtbar funktionieren |
|---|---|
| Testfrage | Welche Projekte sind betroffen, wenn CRM jährlich geprüft werden muss? |
| Textsuche | Richtlinie A Abschnitt 4.2 wird gefunden |
| Graphkontext | CRM -> Projekt Alpha -> Customer Core wird geliefert |
| Antwort | Quelle, Projekt, Team und Pfad werden genannt |
| Anfrageprotokoll | der genutzte Suchweg ist nachvollziehbar |
Betriebsthemen: vollständige UI, produktives Rollenmodell, Live-Updates und produktive Governance. Der Systembaustein ist ein schmaler Prototyp-Ausschnitt, der den Kern prüft.
prototype-check.jsonjson
{
"test_question": "Welche Projekte sind betroffen, wenn CRM jährlich geprüft werden muss?",
"must_find_source": "policy-a#4.2",
"must_link_entity": "system-crm",
"must_return_path": ["Richtlinie A", "CRM", "Projekt Alpha", "Customer Core"],
"must_show_answer_parts": ["Projekt Alpha", "Customer Core", "Quelle", "Graphpfad"],
"must_log": ["text_search", "entity_linking", "graph_query", "context_package", "answer"]
}Abwägen
Trade-off
Was wird einfacher, was schwieriger?
Die Entscheidung: Du baust einen kleinen Prototyp-Ausschnitt, der eine Testfrage von Quelle über Graphpfad bis Antwort und Anfrageprotokoll führt.
Die Konsequenz: UI, Rollen, Live-Importe, Admin-Flows und vollständiges Monitoring bleiben zunächst draußen. Dafür siehst du klar, ob der GraphRAG-Kern trägt: Quelle finden, CRM erkennen, Pfad holen, Kontextpaket bauen, Antwort belegen.
Der Trade-off hilft dir beim Grundverständnis: Ein breiter Prototyp wirkt schneller wie ein Produkt. Ein schmaler Ausschnitt zeigt zuverlässiger, ob die Architekturidee funktioniert.
Fehlerbild
Typischer Baufehler
Worauf du achten musst
Die typische Falle: Der Prototyp wird zur Produktdemo. Es entstehen UI, Admin-Ansichten, Live-Importe und Rollenideen, während die eigentliche Testfrage noch wackelt.
Am Ende sieht die Demo groß aus, aber die Kernfrage bleibt offen: Findet das System die Quelle, erkennt es CRM, traversiert es den Pfad zu Projekt und Team und zeigt es das Anfrageprotokoll?
Halte den Ausschnitt klein und prüfbar. Eine Testfrage, ein Quellenbeleg, ein Graphpfad, eine Antwort und ein Anfrageprotokoll reichen für den ersten Architekturbeleg.
Prüfen
Woran du es erkennst
Prüfpunkt
Du erkennst einen aussagekräftigen Prototyp daran, dass eine konkrete Testfrage von Quelle über Graphpfad bis Anfrageprotokoll nachvollziehbar läuft. Alles, was diesen Nachweis nicht stärkt, gehört in spätere Entscheidungen.
Üben
Mini-Aufgabe
Formuliere für den Mini-Use-Case den kleinsten Prototyp-Ausschnitt. Nenne Testfrage, Quelle, Graphpfad, Antwortbestandteile und Anfrageprotokoll.
Musterlösung
Testfrage
"Welche Projekte sind betroffen, wenn CRM jährlich geprüft werden muss?"
Quelle
Richtlinie A Abschnitt 4.2 zur jährlichen Prüfung kritischer Kundensysteme.
Graphpfad
Richtlinie A -> CRM -> Projekt Alpha -> Customer Core.
Antwortbestandteile
Projekt Alpha, Customer Core, Richtlinienquelle und Graphpfad.
Anfrageprotokoll
Textsuche, CRM-Erkennung, Graphabfrage, Kontextpaket und Antwortstatus.
Reflektieren
Selbsttest
1.Was prüft der Prototyp-Ausschnitt?
Er prüft, ob eine Frageklasse mit Quellen, Graphpfad und Anfrageprotokoll nachvollziehbar beantwortet werden kann.
2.Warum braucht der Prototyp ein Anfrageprotokoll?
Damit sichtbar wird, welcher Suchweg zur Antwort geführt hat.
3.Was gehört in spätere Entscheidungen?
Alles, was für Betrieb, Governance, Rollen, Kosten und produktive Kontrolle wichtig ist, aber den Kernnachweis noch nicht braucht.
Kernaussage
Ein Prototyp-Ausschnitt prüft eine Architekturannahme aus dem Systemdesign.