Tutorial: Neuen Tenant onboarden

In diesem Tutorial boardest du einen neuen Kunden von Grund auf ein: seine Daten empfangen, eine Tenant-Instanz erstellen, die Extraktions- und Build-Pipeline ausfuehren, Ergebnisse erkunden und einen Snapshot einfrieren. Das ist der Workflow, den ein Berater bei einem neuen Kunden befolgt.

Zeit: 15 Minuten Voraussetzungen: jinflow installiert (Schnellstart)

1. Das Szenario

Ein neues Weingut — Domaine Nouveau — moechte dein analytisches Framework nutzen. Sie haben dir einen Excel-Export aus ihrem ERP-System geschickt. Du musst daraus eine funktionierende analytische Umgebung machen.

2. Die Data Landing Zone einrichten

Die DLZ ist, wo Roh-Quelldaten ankommen, getrennt von jinflows Arbeitsverzeichnissen.

# DLZ Root konfigurieren (einmalig)
jinflow us --dlz ~/jinflow-datalandingzone

# DLZ-Verzeichnis des Tenants erstellen
mkdir -p ~/jinflow-datalandingzone/millesime/domaine_nouveau/custom/csv/

Lege die CSV-Dateien des Kunden (oder XLSX zur Extraktion) in dieses Verzeichnis:

jinflow-datalandingzone/
  millesime/
    domaine_nouveau/
      custom/
        csv/
          parcels.csv
          harvests.csv
          wines.csv
          ...

3. Den Tenant erstellen

jinflow init --pack millesime --tenant domaine_nouveau \
  --source-system custom \
  --dlzroot ~/jinflow-datalandingzone \
  --display-name "Domaine Nouveau"

Dies erstellt eine Tenant-Instanz in deinem Live Root:

~/.jinflow/live/millesime/domaine_nouveau/
  afs/       ← Kopie des Millesime-Packs (Signals, Theses, dbt, usw.)
  raw/       ← leer, wartet auf Daten
  build/     ← leer
  store/     ← leer

Als Standard setzen:

jinflow us --tenant millesime.domaine_nouveau

4. Daten aus DLZ synchronisieren

Wenn der Kunde XLSX-Dateien geschickt hat, zuerst extrahieren:

jinflow make --extract    # XLSX → CSV in DLZ, dann sync nach raw/

Wenn sie CSVs direkt geschickt haben:

jinflow make --sync       # CSVs von DLZ nach raw/ kopieren

Daten-Landung pruefen:

jinflow stat

Zeigt Gold-Layer-Zahlen, Signal-Zahlen und Gesundheitschecks.

5. Bauen

jinflow make

Die vollstaendige Pipeline laeuft:

1. CSVs validieren und anreichern
2. Alle Instrumente aus dem Pack kompilieren
3. dbt Build (Bronze → Silver → Gold → Signals → Theses → Verdicts)
4. Berichte und Pipeline-Graph generieren
5. KLS stempeln und SIS erstellen

6. Erkunden

jinflow explore

Ergebnisse auf localhost:4000 durchsuchen:

• Uebersicht — bestaetigte Theses, Gesamtexposition
• Findings — was die Signals erkannt haben
• Theses — welche Geschaeftsfragen Evidenz haben
• Dimensionen — die tatsaechlichen Kundendaten durchsuchen

7. Snapshot

Zufrieden mit der ersten Analyse? Einfrieren:

jinflow make --snapshot onboarding

Dies erstellt einen unveraenderlichen Snapshot, zu dem du jederzeit zurueckkehren kannst:

jinflow explore --snapshot onboarding    # jederzeit wieder besuchen

8. Zusammenarbeiten

Wenn ein Kollege an diesem Tenant arbeiten muss:

# Du: AFS zu GitHub pushen
jinflow afs remote https://github.com/org/afs-millesime-domaine_nouveau.git
jinflow afs push -m "Initial onboarding complete"

# Kollege: klonen und bauen
jinflow init --clone https://github.com/org/afs-millesime-domaine_nouveau.git
jinflow make --tenant millesime.domaine_nouveau --sync

9. Aktuell halten

Wenn der Kunde neue Daten schickt:

# Neue CSVs in die DLZ legen
jinflow make --sync      # neue Daten synchronisieren
jinflow make             # neu bauen
jinflow make --snapshot  # einfrieren wenn signifikant

Wenn das Pack mit neuen Signals aktualisiert wird:

jinflow afs update --do-it    # Pack-Aenderungen holen
jinflow make                  # mit neuen Instrumenten neu bauen

Was du gelernt hast

• DLZ ist die Eingangsgrenze — Rohdaten kommen hier an, nie im jinflow Live Root
• jinflow init --pack kopiert ein Domain Pack in eine neue Tenant-Instanz
• --sync kopiert geaenderte CSVs von DLZ nach raw/; --extract konvertiert zuerst XLSX
• jinflow stat zeigt was im KLS vor und nach Builds ist
• Snapshots frieren deine Arbeit ein — Kunden koennen ihren Onboarding-Zustand jederzeit sehen
• AFS Push/Pull ermoeglicht Teamzusammenarbeit am selben Tenant

Naechste Schritte

• Tutorial: Domain Pack veroeffentlichen — dein Framework zur Wiederverwendung paketieren
• Tenants Guide — Multi-Tenant-Architektur
• Collaboration Guide — Git-Workflows
• Glossar — jeder Begriff erklaert