Guide de déploiement

jinflow sépare l’application (moteur + Explorer) des données (fichiers KLS tenant).

Architecture

Deploy root (app)              Live root (data)
  _cli/jinflow    ← CLI         millesime/domaine_zufferey/
  _explorer/      ← Explorer      afs/, raw/, build/, store/
  jinflow         ← launcher    millesime/domaine_zufferey/
                                  afs/, raw/, build/, store/

L’application est construite une fois par release. Les données sont construites par tenant via make.

Release desktop

# Bump version, build, package
just release patch

# Build current version without bumping
just release --now

# Skip tests for faster iteration
just release --now --skip-tests

Cela produit :

• jinflow-deploy/_cli/ — binaire PyInstaller (Python + dbt + DuckDB)
• jinflow-deploy/_explorer/ — build SvelteKit + node_modules
• jinflow-deploy/jinflow — binaire CLI

Exécution

Desktop

# Via launcher
./jinflow make --tenant millesime.domaine_zufferey
./jinflow explore --tenant millesime.domaine_zufferey

# Explorer
./jinflow explore     # opens Explorer with tenant selector

Développement

# CLI (from repo)
jin make --tenant millesime.domaine_zufferey

# Explorer dev server
cd explorer && npm run dev    # localhost:4000

Docker (cloud uniquement)

Docker est pour le déploiement cloud. L’Explorer local s’exécute comme serveur web Node.js.

# Build Docker image
scripts/build-docker.sh

# Run with live root mount
docker run -v /path/to/live:/data/live:ro \
  -p 4000:4000 \
  jinflow-explorer

R2 (stockage cloud)

Les fichiers KLS peuvent être stockés dans Cloudflare R2 pour l’Explorer cloud :

# Configure R2 credentials
jin us --r2-account-id ... --r2-key ... --r2-secret ... --r2-bucket jinflow-demo

L’Explorer découvre les fichiers KLS dans R2, les télécharge dans un cache local et les sert depuis le disque. La synchronisation en arrière-plan vérifie les mises à jour toutes les 5 minutes (comparaison ETag).

Variables d’environnement

Explorer

Variable	Usage
JINFLOW_LIVE_ROOT	Live root pour la découverte de tenants
JINFLOW_DB_PATH	Chemin KLS explicite (mode single-tenant)
JINFLOW_AFS_ROOT	Racine AFS pour la configuration de marque
JINFLOW_SYSTEM_DB_PATH	DuckDB système (optionnel)
JINFLOW_SIS_PATH	Chemin SIS explicite (override)
ANTHROPIC_API_KEY	Clé API Claude pour les explications IA
JINFLOW_AI_MODEL	Override du modèle IA (défaut : claude-haiku-4-5-20251001)
KLS_SOURCE	Mode de découverte : local, r2 ou vide
KLS_LOCAL_DIR	Répertoire local pour la découverte KLS

CLI

Variable	Usage
JINFLOW_LIVE	Override du live root
JINFLOW_PACKS_ROOT	Override de la racine des packs
JINFLOW_DLZ_ROOT	Override de la racine DLZ
JINFLOW_TENANT	Tenant par défaut
JINFLOW_DEPLOY_ROOT	Override du deploy root

Prérequis plateformes

Plateforme	CLI	Explorer
macOS (arm64)	Binaire natif	Node.js ou Bun
Windows	Build PyInstaller (sur Windows)	Node.js
Linux	Build PyInstaller (sur Linux)	Node.js

Checklist de release

1. Vérifier que les tests passent : just test
2. Commiter tous les changements
3. Releaser : just release patch (ou minor, major)
4. Tester le binaire déployé : jinflow-deploy/jinflow version
5. Construire les tenants : jin make --all --sync
6. Vérifier l’Explorer : jin explore