jinflow Einrichtungs-Guide

1. Roots konfigurieren

Bearbeite ~/.jinflow/config.yml:

live_root: ~/jinflow-live         # wo Tenant-Instanzen leben

• live_root — wo jinflow init Tenant-Instanzen erstellt und jinflow make KLS-Dateien schreibt.

Unterstuetzt ~-Expansion und kann auch via JINFLOW_LIVE Umgebungsvariable gesetzt werden.

Optional: Pack Root und DLZ Root

Wenn du Domain Packs verwendest oder Quelldaten via Data Landing Zone erhaeltst:

pack_root: ~/jinflow-packs                  # wo Domain Pack Repos geklont sind
dlz_root: ~/jinflow-datalandingzone         # wo Quelldaten ankommen

• pack_root — wo jinflow Packs nach Name sucht. Nur noetig wenn du --pack bei init verwendest.
• dlz_root — Konvention: {dlz_root}/{pack}/{tenant}/{source_system}/csv/.

Beide koennen auch via Umgebungsvariablen gesetzt werden (JINFLOW_PACKS_ROOT, JINFLOW_DLZ_ROOT).

2. Einen Tenant initialisieren

Von Grund auf starten

jinflow init --tenant my_analysis --source-system opale

Dies erstellt einen leeren Tenant mit einem leeren AFS — du schreibst deine eigenen Signals, Theses und dbt-Modelle.

Von einem Domain Pack starten

jinflow init --pack millesime --tenant domaine_new --source-system opale

Dies kopiert das analytische Framework des Packs in den Tenant. Das Pack ist ein Starter-Kit — nach init ist der Tenant unabhaengig.

Was init erstellt

{live_root}/{pack_or_default}/domaine_new/
  afs/      ← analytisches Framework (deine Instrumente, dbt-Modelle, Contracts)
  raw/      ← lege deine Quell-CSVs hier ab
  build/    ← Intermediäre (kompiliertes SQL, angereicherte CSVs)
  store/    ← KLS + SIS (gebaut von make)

Mit DLZ

jinflow init --pack millesime --tenant domaine_new --source-system opale \
  --dlzroot ~/jinflow-datalandingzone

Dies verknuepft den Tenant auch mit seinem DLZ-Pfad fuer --sync.

3. Pack-qualifizierte Tenant-IDs verwenden

Alle Befehle verwenden pack.tenant Notation:

jinflow make --tenant millesime.domaine_new
jinflow explore --tenant millesime.domaine_new
jinflow afs update --tenant millesime.domaine_new
jinflow us --tenant millesime.domaine_new     # als Standard setzen

Standard-Tenant setzen

jinflow us --tenant millesime.domaine_new

Danach verwenden Befehle ohne --tenant den Standard.

4. Konfiguration pruefen

jinflow us

Zeigt live_root, pack_root, Standard-Tenant und woher jede Einstellung aufgeloest wurde (Umgebungsvariable, config.yml oder Standard).

5. Taeglicher Workflow

# KLS bauen
jinflow make

# Im Browser erkunden
jinflow explore

# Instrumente (Signals, Theses, usw.) in afs/ bearbeiten, neu bauen
jinflow make

# Snapshot einfrieren wenn zufrieden
jinflow make --snapshot

# Bei Verwendung einer DLZ: frische CSVs vor dem Bau kopieren
jinflow make --sync

# Bei Verwendung eines Domain Packs: neueste Pack-Aenderungen holen
jinflow afs update --do-it

Aufloesungsreihenfolge

Einstellung	1.	2.	3.	Standard
live_root	JINFLOW_LIVE Umgebungsvar.	~/.jinflow/config.yml	—	~/.jinflow/live/
pack_root	JINFLOW_PACKS_ROOT Umgebungsvar.	~/.jinflow/config.yml	Engine packs/ Verz.	—
dlz_root	JINFLOW_DLZ_ROOT Umgebungsvar.	~/.jinflow/config.yml	AFS jinflow.yml	—
tenant	JINFLOW_TENANT Umgebungsvar.	~/.jinflow/config.yml	AFS default_tenants	—