Aide-mémoire opérateur

Astuce

Imprimez cette page (Cmd+P) pour une référence de bureau.

Installation

Téléchargez la dernière version. Le package est autonome — pas besoin de Python, Node ou dbt.

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

Première configuration

jinflow us --live-root ~/jinflow-live            # where tenant data lives
jinflow us millesime.domaine_zufferey                 # set default tenant
jinflow us --api-key sk-ant-...                  # Claude API key

Cycle de vie des tenants

jinflow init --pack millesime --tenant szo --source-system opale  # from pack
jinflow clone millesime.domaine_zufferey --name sandbox           # clone
jinflow ls                                                   # list all
jinflow pick                                                 # interactive picker
jinflow stat                                                 # health check

Opérations de build

jinflow make                              # build default tenant
jinflow make --all                        # all tenants, all packs
jinflow make --clean                      # drop + full rebuild
jinflow make --sync                       # sync DLZ → raw/ first
jinflow make --extract                    # XLSX → CSV → sync → build
jinflow make --snapshot post-audit        # freeze after build

Gestion des snapshots

jinflow make --snapshot                   # auto-tag: YYYYMMDD-HHMM
jinflow snapshot review-q1                # standalone (no build)
jinflow explore --snapshot post-audit     # browse a snapshot

Opérations git AFS

jinflow afs status                        # branch, tags, dirty files
jinflow afs pull                          # fast-forward from remote
jinflow afs push -m "Updated signals"      # commit + push
jinflow afs update --do-it                # sync pack → tenant
jinflow afs reset --do-it                 # hard reset to pack state

Synchronisation cloud (R2)

jinflow cloud ls                          # list KLS files + R2 status
jinflow cloud sync --do-it                # upload to R2
jinflow instance refresh --all            # refresh all instances

Structure du répertoire tenant

{live_root}/{pack}/{tenant}/
  afs/        ← analytical framework (git-backed)
  raw/        ← immutable source CSVs
  build/      ← intermediaries
  store/      ← KLS + SIS + snapshots
    {pack}_{tenant}_kls.duckdb       working KLS
    {pack}_{tenant}_sis.duckdb       mutable SIS
    YYYYMMDD-HHMM_kls.duckdb        auto snapshot
    post-audit_kls.duckdb            named snapshot

Dépannage

Symptôme	Cause	Solution
dbt échoue avec mauvais adaptateur	Le dbt système est dbt-fusion	Utiliser .venv/bin/dbt
Erreur de catalogue KLS avec des points	Points dans le nom de fichier DuckDB	Utiliser des underscores
Hook rejette le commit	Préfixe sémantique manquant	Commencer par feat:, fix:, etc.
jinflow make saute des phases	Build incrémental	Utiliser --clean
Explorer affiche des données obsolètes	KLS pas reconstruit	Exécuter jinflow make