Explorer Guide

Der Explorer ist die webbasierte analytische Oberflaeche von jinflow. Er liest aus dem KLS (Knowledge Store) und SIS (System Information Store) und praesentiert Findings, Theses, Dimensionen und Expertenwissen.

Seiten

Seite	Taste	Was sie zeigt
Uebersicht	O	Bestaetigte Theses, bereinigte Exposition, Finding-Anzahl, Dimensions-Zahlen
Neuigkeiten	W	Aktuelle Aenderungen und Aktivitaet
Theses	H	Geschaeftsfragen mit Thesis-Status (confirmed/plausible/not observed)
SMEbits	S	Atomares Expertenwissen (Beobachtungen + Checks)
Use Cases	U	BitBundles — kuratierte Narrative, die SMEbits gruppieren
Notebook	N	Untersuchungsnotizen (YAML aus AFS + Benutzereintraege im SIS). Eintraege direkt erstellen, bearbeiten, loeschen. Siehe Notizen Guide
Signals	P	Diagnostische Abfragen (Perspectives + einzelne Signals)
Signal Findings	F	Alle Signal Findings mit Score-Balken und Treemap
Interpretationen	I	Menschenlesbare Finding-Narrative gruppiert nach Schweregrad
Entities	D	Kern-Business-Nomen (Materialien, Faelle, Lieferanten…) mit Suche, Filter, Sortierung, Group-By
Analytics	D (2.)	Abgeleitete Views und Faktentabellen (Verbrauch, Abrechnung, Price Palette…)
Alle Tabellen	-	Jede KLS-Tabelle ohne Entity-Registrierung durchsuchen (System-Abschnitt)
dbt Docs	-	Eingebettete dbt-Dokumentation — Modelle, Spalten, Lineage (System-Abschnitt)
Taxonomien	T	Hierarchische Klassifikationen und Cross-Taxonomy-Kardinalitaet
Executive Summary	E	High-Level-Bericht fuer die Fuehrung
Reports	R	Detaillierte analytische Berichte
Calibration	C	Signal-Genauigkeitsmetriken (nur synthetische Tenants)
Signal Builder	P (2.)	Formularbasierter Signal-Ersteller mit Typauswahl, Scope-Konfiguration, YAML-Vorschau und Validierungs-Sandbox
Pipeline	P (4.)	Interaktiver dbt DAG mit Ebenenfaerbung und Lineage-Verfolgung
Diff Loupe	C (2.)	KLS-Versionsvergleich — Findings-Delta, Thesis-Status-Aenderungen, AFS-Diff, dbt Docs Diff
Map Salon	M	Geografische und raeumliche Visualisierung von Entity-Verteilungen und Signal Findings
Spend Studio	-	Verbrauchsanalytik — Ausgabemuster, Kategorieaufschluesselungen, Trendanalyse
Instrumente	I (2.)	Interaktiver Signal-Lineage-Graph (Instrumentenabhaengigkeiten)
Bookmarks	B	Gespeicherte benutzerdefinierte Views durchsuchen und verwalten
Price Lab	-	Master- vs. Abrechnungspreis-Vergleich — Scatterplot, Abweichungshistogramm, Pro-Material-Zeitleiste
Zuletzt besucht	-	Kuerzlich besuchte Seiten und Entities mit Navigationshistorie
What is this?	W (2.)	Plattformdokumentation, Analysten-Toolkit, Glossar — Guides, Domain-Glossar, Produkt-Glossar
About	A	Datenherkunft, Mitwirkende, Pipeline-Info, Build-Statistiken, Vertragsliste

Tastenkuerzel

Buchstaben-Navigation

Druecke eine Buchstabentaste um zur Seite zu springen, die mit diesem Buchstaben beginnt. Druecke denselben Buchstaben innerhalb von 800ms erneut um durch mehrere Treffer zu wechseln.

Taste	Seite(n)
O	Uebersicht
W	Neuigkeiten → Ueber (About)
H	Theses
S	SMEbits
U	Use Cases
N	Notebook
P	Signals → Signal Builder → Pipeline
F	Findings
I	Interpretationen
D	Dimensionen
T	Taxonomien
E	Executive Summary
R	Reports
C	Calibration

Sondertasten

Taste	Aktion
J	JumpBar oeffnen
Cmd+K	JumpBar oeffnen/schliessen (funktioniert ueberall)
Backspace	Browser zurueck

JumpBar

Die JumpBar (J oder Cmd+K) ist eine universelle Such- und Befehlspalette. Verwende Praefixe um den Modus zu wechseln:

Praefix	Modus	Was gesucht wird
(keiner)	Suche	Signals, Theses, Entities, Glossar, gespeicherte Views, Dimensionen
?	Glossar	Produkt- und Architekturbegriffe
=	Rechner	Mathematische Ausdruecke (unterstuetzt K, M, B Suffixe)
>	Befehle	Sprache wechseln, Schweregrad filtern, navigieren
@	Tenant	Zu einem anderen Tenant wechseln
:	Filter	Aktuelle Seite filtern (Findings, Dimensionen)
docs:	Dokumentation	docs.jinflow.io durchsuchen (oeffnet neuen Tab)

Suchsyntax

Jede Listenseite hat ein Suchfeld. Freitextsuche durchsucht alle sichtbaren Spalten.

Fuer praezise Filterung verwende die !field:value Syntax:

keyword                          # passt auf jede Spalte
!entity_type:Material            # Feldfilter (exakte Uebereinstimmung)
!severity:high                   # filtert severity auf high
keyword !severity:high           # Freitext + Feldfilter kombiniert

Vergleiche und Bereiche:

!amount:>1000                    # groesser als
!amount:>=500                    # groesser oder gleich
!amount:100..500                 # Bereich (inklusiv)

Negation und OR:

!severity:!high                  # nicht high (Negation)
!status:open|pending             # open ODER pending
!severity:!low|info              # weder low noch info

Datum-Tokens:

!created:today                   # heute
!created:last7d                  # letzte 7 Tage
!created:thismonth               # aktueller Monat
!updated:2025-01                 # Januar 2025
!updated:2025-01-01..2025-03-31  # Datumsbereich

Konfiguration:

!sort:amount:desc                # Sortierung absteigend
!group:status                    # nach Feld gruppieren
!limit:50                        # Ergebnisse begrenzen

Das Autocomplete-Dropdown erscheint wenn du ! tippst — verwende Tab oder Enter um ein Feld auszuwaehlen.

Seitenleiste: Entity-Taxonomie

Die Seitenleiste organisiert durchsuchbare Daten in drei Abschnitte:

Entities — Kern-Business-Nomen einzeln aufgelistet: Materialien, Faelle, Lieferanten, Abteilungen, Lieferketten, Kostenstellen. Plus Taxonomien. Jeder Link fuehrt direkt zur Dimensionsseite.

Analytics — Abgeleitete Views und Faktentabellen (Top 5 angezeigt). Gebookmarkte Entities erscheinen zuerst (alphabetisch), dann fuellen verbleibende Plaetze nach Zeilenanzahl. Bookmarke eine Entity und sie steigt nach oben — persoenliche, organische Priorisierung. Ein “mehr…”-Link oeffnet die vollstaendige Liste.

Referenz — Nachschlagetabellen (Katalogstypen, Verpackungstypen usw.) zugaenglich ueber den Dimensionsindex mit Kind-Filter.

Jede Entity hat ein kind-Feld in ihrer YAML-Definition: core, analytical oder view. Die Seitenleiste liest die Entity Registry aus dem KLS und zeigt Namen in der aktiven Sprache an.

Navigationsjournal (Zuletzt besucht)

Klicke auf das Symbol neben einem Seitenleistenelement um deine letzten 5 Besuche bei dieser Entity zu sehen. Jeder Besuch zeichnet die genaue Seite, Filter, Suche und Sortierung auf — klicke zum Zurueckspringen.

Verfolgte Seiten: Entities, Analytics, Theses, Signal Findings, SMEbits, Notizen, Alle Tabellen.

So funktioniert es:

• Jeder Detailseitenbesuch wird im SIS aufgezeichnet (Fire-and-Forget)
• Gespeichert pro Benutzer (Git-Identitaet) und pro Entity
• Auto-Bereinigung: behaelt letzte 100 pro Entity pro Benutzer
• Keine Synchronisation — Zuletzt besucht lebt nur im SIS (lokaler Komfort)
• Tastenkuerzel: Cmd+B fuer Bookmarks (persistent), Symbol-Klick fuer Zuletzt besucht (automatisch)

Bookmarks

Druecke Cmd+B auf jeder Seite um den aktuellen Zustand zu bookmarken (URL + Filter + Sortierung). Das Bookmark-Symbol in der Kopfzeile zeigt ein Dropdown aller gespeicherten Bookmarks ueber Seiten hinweg. Bookmarks werden im SIS gespeichert.

Persistenz: Bookmarks werden vom SIS zum AFS veroeffentlicht und zurueckgemergt, sodass sie Rebuilds ueberstehen und ueber Maschinen synchronisiert werden, wenn das AFS via jinflow afs push/pull synchronisiert wird.

Seitenleisten-Effekt: Gebookmarkte analytische Entities erhalten automatisch Prioritaetsplatzierung in der Analytics-Sektion der Seitenleiste — sie steigen automatisch nach oben.

Map Salon

Geografische und raeumliche Visualisierung von Entity-Verteilungen und Signal Findings. Map Salon rendert Entities auf einer Karte, wenn sie Standortdaten tragen (Koordinaten, Postleitzahlen, Regionen), und ueberlagert Signal Findings als Heatmaps oder Marker-Cluster.

Features:

• Erkennt automatisch Standortspalten in Entity-Daten
• Signal Findings als farbcodierte Marker ueberlagert (Score bestimmt Intensitaet)
• Filterbar nach Entity-Typ, Signal und Score-Bereich
• Zoom von Laenderebene bis zu einzelnen Standorten
• Klicke auf Marker um in Entity-Detail oder Finding-Evidenz einzutauchen

Spend Studio

Verbrauchsanalytik fuer Ausgabemuster, Kategorieaufschluesselungen und Trendanalyse. Spend Studio ersetzt das fruehere Consumption Lab mit reicheren Visualisierungen und tieferen Drill-Down-Moeglichkeiten.

Features:

• Kategorieaufschluesselung — Treemap- und Sunburst-Ansichten der Ausgaben nach Taxonomie-Knoten
• Trendanalyse — monatliche/quartalweise Ausgaben ueber die Zeit mit Jahresvergleich
• Top-N-Analyse — groesste Verbraucher, am schnellsten wachsende Kategorien, groesste Abweichungen
• Budget vs. Ist — wenn Budgetdaten verfuegbar, Ueberlagerung geplant vs. realisiert
• Cross-Entity-Verlinkung — klicke auf eine Kategorie um die zugrundeliegenden Materialien, Lieferanten oder Kostenstellen zu sehen

Price Lab

Interaktive Preisanalyse zum Vergleich von Masterkatalog-Preisen gegen tatsaechliche Abrechnungspreise. Drei Chart-Modi:

Scatterplot — jedes Material aufgetragen als Masterpreis (x) vs. Abrechnungspreis (y) auf logarithmischer Skala. Punkte ueber der Uebereinstimmungslinie werden hoeher als Master abgerechnet; darunter niedriger. Verbrauchsmaterialien und Medikamente sind farbcodiert. Klicke auf einen Punkt um in die Zeitleiste einzutauchen. Bis zu 5.000 Materialien.

Abweichungshistogramm — Verteilung von (Abrechnung - Master) / Master als Prozentsatz. Gruen = innerhalb ±5%. Rot = unterbewertet. Blau = ueberbewertet. Zeigt wie viele Materialien in jedes Abweichungsband fallen.

Zeitleiste — Preisverlauf fuer ein einzelnes Material ueber die Zeit. Masterpreise als Stufenlinien pro Standort (z.B. Brig, Visp), Abrechnungspreise als einzelne Streupunkte. Tooltips zeigen Rechnungsnummern, Mengen, Aktiv/Inaktiv-Status. Palette-Zusammenfassung im Untertitel.

Features:

• Konfigurierbare Aufloesungsregeln — waehle wie Masterpreis aufgeloest wird (z.B. “wenn nur einer aktiv, verwende ihn; sonst neuesten”) und Abrechnungspreis (z.B. Durchschnitt, neuester)
• Zoombar — Scrollen zum Zoomen, Ziehen zum Schwenken, Reset-Button
• Deep Links — ?material=X oeffnet die Zeitleiste fuer ein bestimmtes Material direkt
• Cross-Navigation — klicke auf einen Streupunkt um zu seiner Zeitleiste zu springen
• Palette Overlay — umschaltbare gestrichelte Referenzlinien fuer Katalogpreisregeln auf der Zeitleiste
• Histogram Drilldown — klicke auf einen Balken um die einzelnen Materialien in diesem Abweichungsband mit ihren Preisen zu sehen

Signal Builder

Ein vereinheitlichtes Signal-Erstellungstool mit zwei Modi. (Signals hiessen frueher Probes — das zugrundeliegende YAML verwendet weiterhin probe_id als Feldname.)

Visual-Modus — Schritt-fuer-Schritt-Assistent durch die Signal-Erstellung:

1. Typ — waehle aus balance, entity_filter, duplicate, enrichment, mandatory_item
2. Scope — Entity-Typ und Contract auswaehlen (gold.v1 oder silver.v1)
3. Konfiguration — typspezifische Konfiguration (Felder, Schwellenwerte, Bedingungen)
4. Score — Bewertungsregeln basierend auf Finding-Metriken (0-100 kontinuierliche Skala)
5. Metadaten — probe_id, Beschreibung, Tags, dreisprachiger Anzeigetext
6. Vorschau — generiertes YAML mit In-die-Zwischenablage-kopieren

YAML-Modus — Raw-Editor fuer volle Kontrolle:

• Signal YAML direkt schreiben oder einfuegen
• Compile — SQL aus dem YAML generieren
• Validate — gegen Contracts und Referenzen pruefen
• Dry-Run — Findings ohne Build vorschauen
• Roundtrip — YAML → Assistent-Zustand → YAML konvertieren um Treue zu testen
• Save to AFS — das Signal direkt in das AFS des Tenants schreiben

Zwischen Modi wechseln mit dem Visual/YAML-Toggle oben. Der Assistent ist fuer Exploration; YAML-Modus ist fuer Power-User.

Computed Aggregates

Beim Gruppieren von Zeilen in einer Dimensionstabelle werden numerische Spalten mit SUM aggregiert. Aber abgeleitete Verhaeltnisse wie delta_qty_pct = (qty_out - qty_in) / qty_in × 100 koennen nicht summiert werden — das Ergebnis waere bedeutungslos.

Computed Aggregates loesen das. Das Entity YAML deklariert SQL-Ausdruecke, die naives SUM bei Group-By ersetzen:

columns:
  computed_aggregates:
    delta_qty_pct:
      expression: "SUM(delta_qty) / NULLIF(SUM(qty_in), 0) * 100"
      format: percent

Der Ausdruck wird serverseitig von DuckDB sowohl in der Aggregat-Kopfzeile als auch in Group-By-Views ausgewertet. Ausdruecke referenzieren nur Spalten desselben Modells — keine Unterabfragen, kein DDL.

Gespeicherte Views (Legacy)

Auf Dimensionsseiten: Filter, Sortierung und Group-By konfigurieren, dann ”+ View speichern” klicken. Der View wird:

• Automatisch aus dem aktuellen Zustand benannt (bearbeitbar)
• Im SIS gespeichert (persistent, browseruebergreifend)
• Als klickbare Pillen ueber dem Suchfeld angezeigt
• In der JumpBar suchbar
• Als YAML fuer Notebook-Notizen kopierbar (Zwischenablage-Symbol)

Sprache

Zwischen DE, EN, FR wechseln mit dem Sprachwechsler am unteren Rand der Seitenleiste, oder via JumpBar: > deutsch, > english, > français.

Alle Inhalte — Theses, Signal-Beschreibungen, Interpretationen, Analysten-Toolkit — sind dreisprachig.