Operator Spickzettel

Tipp

Drucke diese Seite (Cmd+P) als Schreibtischreferenz.

Installation

# macOS
export PATH="$HOME/jinflow:$PATH"
jinflow version

Erstkonfiguration

jinflow us --live-root ~/jinflow-live            # wo Tenant-Daten leben
jinflow us millesime.domaine_zufferey                 # Standard-Tenant setzen
jinflow us --api-key sk-ant-...                  # Claude API Key (fuer KI-Features)

Tenant-Lebenszyklus

jinflow init --pack millesime --tenant szo --source-system opale  # aus Pack erstellen
jinflow clone millesime.domaine_zufferey --name sandbox           # klonen
jinflow ls                                                   # alle auflisten
jinflow pick                                                 # interaktiv waehlen
jinflow stat                                                 # Gesundheitscheck

Build-Operationen

jinflow make                              # Standard-Tenant bauen
jinflow make --all                        # alle Tenants, alle Packs
jinflow make --clean                      # loeschen + vollstaendiger Rebuild
jinflow make --sync                       # DLZ → raw/ zuerst synchronisieren
jinflow make --extract                    # XLSX → CSV → Sync → Build
jinflow make --snapshot post-audit        # nach Build einfrieren

Snapshot-Verwaltung

jinflow make --snapshot                   # Auto-Tag: YYYYMMDD-HHMM
jinflow snapshot review-q1                # eigenstaendig (kein Build)
jinflow explore --snapshot post-audit     # Snapshot durchsuchen

AFS Git-Operationen

jinflow afs status                        # Branch, Tags, geaenderte Dateien
jinflow afs log                           # Commit-Historie
jinflow afs pull                          # vom Remote pullen
jinflow afs push -m "Updated signals"      # committen + pushen
jinflow afs update --do-it                # Pack → Tenant synchronisieren (Three-Way-Merge)
jinflow afs reset --do-it                 # Hard Reset auf Pack-Zustand

Cloud Sync (R2)

jinflow cloud ls                          # KLS-Dateien + R2-Status auflisten
jinflow cloud sync --do-it                # zu R2 hochladen
jinflow cloud blacklist millesime.domaine_zufferey      # Tenant von Sync ausschliessen

Explorer

jinflow explore                           # Standard-Tenant, Port 4000
jinflow explore --port 3000               # benutzerdefinierter Port
jinflow explore --docker                  # in Docker ausfuehren
jinflow explore --cloud                   # R2 Cloud KLS verwenden

Fehlerbehebung

Symptom	Ursache	Loesung
dbt schlaegt mit falschem Adapter fehl	System-dbt ist dbt-fusion	.venv/bin/dbt verwenden
KLS Catalog-Fehler mit Punkten	Punkte im DuckDB-Dateinamen	Unterstriche verwenden: pack_tenant_kls.duckdb
Hook lehnt Commit ab	Fehlendes semantisches Praefix	Nachricht mit feat:, fix: usw. beginnen
jinflow make ueberspringt Phasen	Inkrementeller Build	--clean fuer vollstaendigen Rebuild verwenden
Explorer zeigt veraltete Daten	KLS nicht neu gebaut	jinflow make ausfuehren, Browser aktualisieren