Tutoriel : Onboarding d'un nouveau tenant

Dans ce tutoriel, vous allez onboarder un nouveau client de zéro : recevoir ses données, créer une instance tenant, exécuter le pipeline d’extraction et de build, explorer les résultats et figer un snapshot. C’est le workflow qu’un consultant suit quand il démarre avec un nouveau client.

Durée : 15 minutes Prérequis : jinflow installé (Démarrage rapide)

1. Le scénario

Un nouveau domaine viticole — Domaine Nouveau — veut utiliser votre framework analytique. Il vous a envoyé un export Excel depuis son ERP. Vous devez transformer cela en un environnement analytique fonctionnel.

2. Configurer la Data Landing Zone

La DLZ est l’endroit où les données source brutes arrivent, séparément des répertoires de travail de jinflow.

# Configure your DLZ root (one-time)
jinflow us --dlz ~/jinflow-datalandingzone

# Create the tenant's DLZ directory
mkdir -p ~/jinflow-datalandingzone/millesime/domaine_nouveau/custom/csv/

Placez les fichiers CSV du client (ou XLSX pour l’extraction) dans ce répertoire :

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

3. Créer le tenant

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

Cela crée une instance tenant dans votre live root :

~/.jinflow/live/millesime/domaine_nouveau/
  afs/       ← copy of the millesime pack (signals, theses, dbt, etc.)
  raw/       ← empty, waiting for data
  build/     ← empty
  store/     ← empty

Définissez-le comme défaut :

jinflow us --tenant millesime.domaine_nouveau

4. Synchroniser les données depuis la DLZ

Si le client a envoyé des fichiers XLSX, extrayez-les d’abord :

jinflow make --extract    # XLSX → CSV in DLZ, then sync to raw/

S’il a envoyé des CSV directement :

jinflow make --sync       # copy CSVs from DLZ to raw/

Vérifiez que les données sont arrivées :

jinflow stat

Cela affiche les comptages de la couche Gold, les comptages de Signals et les vérifications de santé. Lors d’une première synchronisation avant le premier build, il affichera les comptages de fichiers CSV dans raw/.

5. Construire

jinflow make

Le pipeline complet s’exécute :

1. Valider et enrichir les CSV
2. Compiler tous les instruments depuis le pack
3. dbt build (Bronze → Silver → Gold → Signals → Theses → Verdicts)
4. Générer les rapports et le graphe de pipeline
5. Estampiller le KLS et créer le SIS

Observez la sortie — si des CSV échouent à la validation, les messages d’erreur vous diront exactement ce qui ne va pas (colonnes manquantes, mauvais types, etc.).

6. Explorer

jinflow explore

Parcourez les résultats à localhost:4000 :

• Overview — Theses confirmées, exposition totale
• Findings — ce que les Signals ont détecté
• Theses — quelles questions métier ont des preuves
• Dimensions — parcourir les données réelles du client

C’est le moment où vous montrez au client : « Voici ce que nous avons trouvé dans votre premier jeu de données. »

7. Snapshot

Satisfait de l’analyse initiale ? Figez-la :

jinflow make --snapshot onboarding

Cela crée un snapshot immuable auquel vous pouvez toujours revenir :

jinflow explore --snapshot onboarding    # revisit anytime

8. Collaborer

Si un collègue doit travailler sur ce tenant :

# You: push the AFS to GitHub
jinflow afs remote https://github.com/org/afs-millesime-domaine_nouveau.git
jinflow afs push -m "Initial onboarding complete"

# Colleague: clone and build
jinflow init --clone https://github.com/org/afs-millesime-domaine_nouveau.git
jinflow make --tenant millesime.domaine_nouveau --sync

9. Garder à jour

Quand le client envoie de nouvelles données :

# Place new CSVs in the DLZ
jinflow make --sync      # sync new data
jinflow make             # rebuild
jinflow make --snapshot  # freeze if significant

Quand le pack est mis à jour avec de nouveaux Signals :

jinflow afs update --do-it    # pull pack changes
jinflow make                  # rebuild with new instruments

Ce que vous avez appris

• La DLZ est la frontière d’entrée — les données brutes arrivent ici, jamais dans le live root jinflow
• jinflow init --pack copie un domain pack dans une nouvelle instance tenant
• --sync copie les CSV modifiés depuis la DLZ vers raw/ ; --extract convertit d’abord les XLSX
• jinflow stat montre ce qu’il y a dans le KLS avant et après les builds
• Les snapshots figent votre travail — les clients peuvent voir leur état d’onboarding à tout moment
• AFS push/pull permet la collaboration en équipe sur le même tenant

Prochaines étapes

• Tutoriel : Publier un Domain Pack — emballer votre framework pour la réutilisation
• Guide Tenants — architecture multi-tenant
• Guide Collaboration — workflows git
• Glossaire — chaque terme expliqué