Guide de configuration jinflow

1. Configurer vos racines

Éditez ~/.jinflow/config.yml :

live_root: ~/jinflow-live         # where tenant instances live

• live_root — où jinflow init crée les instances tenant et jinflow make écrit les fichiers KLS.

Supporte l’expansion ~ et peut aussi être défini via la variable d’environnement JINFLOW_LIVE.

Optionnel : racine des packs et racine DLZ

Si vous utilisez des domain packs ou recevez des données source via une Data Landing Zone :

pack_root: ~/jinflow-packs                  # where domain pack repos are cloned
dlz_root: ~/jinflow-datalandingzone         # where source data arrives

• pack_root — où jinflow cherche les packs par nom. Nécessaire uniquement si vous utilisez --pack lors de l’init.
• dlz_root — convention : {dlz_root}/{pack}/{tenant}/{source_system}/csv/.

Les deux peuvent aussi être définis via des variables d’environnement (JINFLOW_PACKS_ROOT, JINFLOW_DLZ_ROOT).

2. Initialiser un tenant

En partant de zéro

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

Cela crée un tenant vide avec un AFS vierge — vous écrivez vos propres Signals, Theses et modèles dbt.

En partant d’un domain pack

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

Cela copie le framework analytique du pack dans le tenant. Le pack est un kit de démarrage — après l’init, le tenant est indépendant.

Ce que l’init crée

{live_root}/{pack_or_default}/domaine_new/
  afs/      ← analytical framework (your instruments, dbt models, contracts)
  raw/      ← place your source CSVs here
  build/    ← intermediaries (compiled SQL, enriched CSVs)
  store/    ← KLS + SIS (built by make)

Avec DLZ

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

Cela lie également le tenant à son chemin DLZ pour --sync.

3. Utiliser des ID tenant qualifiés par pack

Toutes les commandes utilisent la notation pack.tenant :

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     # set as default

Définir un tenant par défaut

jinflow us --tenant millesime.domaine_new

Après cela, les commandes sans --tenant utiliseront le défaut.

4. Vérifier votre configuration

jinflow us

Affiche live_root, pack_root, tenant par défaut et d’où chaque paramètre a été résolu (variable d’env, config.yml ou défaut).

5. Workflow quotidien

# Build the KLS
jinflow make

# Explore in browser
jinflow explore

# Edit instruments (signals, theses, etc.) in afs/, rebuild
jinflow make

# Freeze a snapshot when happy
jinflow make --snapshot

# If using a DLZ: copy fresh CSVs before building
jinflow make --sync

# If using a domain pack: pull latest pack changes
jinflow afs update --do-it

Ordre de résolution

Paramètre	1er	2e	3e	Défaut
live_root	JINFLOW_LIVE env	~/.jinflow/config.yml	—	~/.jinflow/live/
pack_root	JINFLOW_PACKS_ROOT env	~/.jinflow/config.yml	répertoire engine packs/	—
dlz_root	JINFLOW_DLZ_ROOT env	~/.jinflow/config.yml	AFS jinflow.yml	—
tenant	JINFLOW_TENANT env	~/.jinflow/config.yml	AFS default_tenants	—