Guide Explorer

L’Explorer est l’interface analytique web de jinflow. Il lit depuis le KLS (Knowledge Store) et le SIS (System Information Store) pour présenter les findings, Theses, dimensions et connaissances expertes.

Pages

Page	Touche	Ce qu’elle affiche
Overview	O	Theses confirmées, exposition ajustée, nombre de findings, comptages de dimensions
What’s New	W	Changements récents et activité
Theses	H	Questions métier avec statut de Thesis (confirmed/plausible/not observed)
SMEbits	S	Connaissances expertes atomiques (observations + checks)
Use Cases	U	BitBundles — narratifs curés regroupant des SMEbits
Notebook	N	Notes d’investigation (YAML depuis l’AFS + entrées utilisateur dans le SIS). Créer, éditer, supprimer des entrées directement. Voir Guide Notes
Signals	P	Requêtes diagnostiques (Perspectives + Signals individuels)
Signal Findings	F	Tous les Signal Findings avec barres de score et treemap
Interpretations	I	Narratifs lisibles des findings groupés par sévérité
Entities	D	Noms métier principaux (Materials, Cases, Suppliers…) avec recherche, filtre, tri, group-by
Analytics	D (2e)	Vues dérivées et tables de faits (Consumption, Billing, Price Palette…)
All Tables	-	Parcourir n’importe quelle table KLS sans enregistrement Entity (section System)
dbt Docs	-	Documentation dbt intégrée — modèles, colonnes, lineage (section System)
Taxonomies	T	Classifications hiérarchiques et cardinalité inter-taxonomies
Executive Summary	E	Rapport de haut niveau pour la direction
Reports	R	Rapports analytiques détaillés
Calibration	C	Métriques de précision des Signals (tenants synthétiques uniquement)
Signal Builder	P (2e)	Créateur de Signal basé formulaire avec sélecteur de type, configuration de scope, aperçu YAML et sandbox de validation
Pipeline	P (4e)	DAG dbt interactif avec coloration par couche et traçage de lineage
Diff Loupe	C (2e)	Comparaison de versions KLS — delta de findings, changements de statut de Thesis, diff AFS, diff dbt docs
Map Salon	M	Visualisation géographique et spatiale des distributions d’entités et Signal Findings
Spend Studio	-	Analytique de consommation — patterns de dépenses, ventilations par catégorie, analyse de tendances
Instruments	I (2e)	Graphe interactif de lineage des Signals (dépendances d’instruments)
Bookmarks	B	Parcourir et gérer les vues personnalisées sauvegardées
Price Lab	-	Comparaison prix catalogue vs prix facturé — scatter plot, histogramme de déviation, timeline par matériau
Recents	-	Pages et entités visitées récemment avec historique de navigation
What is this?	W (2e)	Documentation de la plateforme, boîte à outils analyste, glossaire — guides, glossaire domaine, glossaire produit
About	A	Provenance des données, contributeurs, info pipeline, stats de build, liste des contrats

Raccourcis clavier

Navigation par lettre

Appuyez sur une touche lettre pour sauter à la page commençant par cette lettre. Appuyez à nouveau sur la même lettre dans les 800ms pour parcourir les correspondances multiples.

Touche	Page(s)
O	Overview
W	What’s New → What is this? (About)
H	Theses
S	SMEbits
U	Use Cases
N	Notebook
P	Signals → Signal Builder → Pipeline
F	Findings
I	Interpretations
D	Dimensions
T	Taxonomies
E	Executive Summary
R	Reports
C	Calibration

Touches spéciales

Touche	Action
J	Ouvrir JumpBar
Cmd+K	Ouvrir/fermer JumpBar (fonctionne partout)
Backspace	Retour navigateur

JumpBar

La JumpBar (J ou Cmd+K) est une palette universelle de recherche et de commandes. Utilisez des préfixes pour changer de mode :

Préfixe	Mode	Ce qui est cherché
(aucun)	Recherche	Signals, Theses, entités, glossaire, vues sauvegardées, dimensions
?	Glossaire	Termes produit et architecture
=	Calculatrice	Expressions mathématiques (supporte suffixes K, M, B)
>	Commandes	Changer de langue, filtrer la sévérité, naviguer
@	Tenant	Basculer vers un autre tenant
:	Filtre	Filtrer la page courante (findings, dimensions)
docs:	Documentation	Rechercher docs.jinflow.io (ouvre dans un nouvel onglet)

Syntaxe de recherche

Chaque page de liste a un champ de recherche. La recherche en texte libre parcourt toutes les colonnes visibles.

Pour un filtrage précis, utilisez la syntaxe !field:value :

keyword                          # correspond à n'importe quelle colonne
!entity_type:Material            # filtre de champ (correspondance exacte)
!severity:high                   # filtre severity sur high
keyword !severity:high           # texte libre + filtre de champ combinés

Comparaisons et plages :

!amount:>1000                    # supérieur à
!amount:>=500                    # supérieur ou égal
!amount:100..500                 # plage (inclusive)

Négation et OR :

!severity:!high                  # pas high (négation)
!status:open|pending             # open OU pending
!severity:!low|info              # ni low ni info

Tokens de date :

!created:today                   # aujourd'hui
!created:last7d                  # 7 derniers jours
!created:thismonth               # mois en cours
!updated:2025-01                 # janvier 2025
!updated:2025-01-01..2025-03-31  # plage de dates

Configuration :

!sort:amount:desc                # tri décroissant
!group:status                    # grouper par champ
!limit:50                        # limiter les résultats

Le menu déroulant d’autocomplétion apparaît quand vous tapez ! — utilisez Tab ou Enter pour sélectionner un champ.

Barre latérale : taxonomie Entity

La barre latérale organise les données consultables en trois sections :

Entities — noms métier principaux listés individuellement : Materials, Cases, Suppliers, Departments, Supply Chains, Cost Centers. Plus Taxonomies. Chacun renvoie directement à sa page de dimension.

Analytics — vues dérivées et tables de faits (top 5 affichées). Les entités mises en favoris apparaissent en premier (alphabétiquement), puis les emplacements restants se remplissent par nombre de lignes. Mettez une entité en favori et elle remonte en haut — priorisation personnelle et organique. Un lien « more… » ouvre la liste complète.

Reference — tables de référence (Catalogue Types, Packaging Types, etc.) accessibles via l’index des dimensions avec un filtre de type.

Chaque entité a un champ kind dans sa définition YAML : core, analytical ou view. La barre latérale lit le registre d’entités depuis le KLS et affiche les noms dans la langue active.

Journal de navigation (Recents)

Cliquez sur l’icône à côté de n’importe quel élément de la barre latérale pour voir vos 5 dernières visites à cette entité. Chaque visite enregistre la page exacte, les filtres, la recherche et le tri utilisés — cliquez pour y retourner.

Pages suivies : Entities, Analytics, Theses, Signal Findings, SMEbits, Notes, All Tables.

Comment ça fonctionne :

• Chaque visite de page de détail est enregistrée dans le SIS (fire-and-forget)
• Stockée par utilisateur (identité git) et par entité
• Nettoyage automatique : garde les 100 dernières par entité par utilisateur
• Pas de synchronisation — les recents vivent uniquement dans le SIS (commodité locale)
• Raccourci clavier : Cmd+B pour les favoris (persistants), clic sur l’icône pour les recents (automatique)

Bookmarks

Appuyez sur Cmd+B sur n’importe quelle page pour mettre en favori l’état actuel (URL + filtres + tri). L’icône de favori dans l’en-tête affiche un menu déroulant de tous les favoris sauvegardés sur toutes les pages. Les favoris sont stockés dans le SIS.

Persistance : Les favoris sont publiés du SIS vers l’AFS et fusionnés en retour, de sorte qu’ils survivent aux rebuilds et sont partagés entre machines quand l’AFS est synchronisé via jinflow afs push/pull.

Effet barre latérale : Les entités analytiques mises en favoris obtiennent un placement prioritaire dans la section Analytics de la barre latérale — elles remontent automatiquement.

Map Salon

Visualisation géographique et spatiale des distributions d’entités et Signal Findings. Map Salon rend les entités sur une carte quand elles portent des données de localisation (coordonnées, codes postaux, régions), superposant les Signal Findings comme cartes thermiques ou clusters de marqueurs.

Fonctionnalités :

• Détection automatique des colonnes de localisation dans les données Entity
• Signal Findings superposés comme marqueurs colorés (le score détermine l’intensité)
• Filtrable par type d’entité, Signal et plage de score
• Zoom du niveau pays jusqu’aux sites individuels
• Cliquer sur les marqueurs pour accéder au détail Entity ou aux preuves du Finding

Spend Studio

Analytique de consommation pour les patterns de dépenses, ventilations par catégorie et analyse de tendances. Spend Studio remplace l’ancien Consumption Lab avec des visualisations plus riches et des capacités de drill-down plus profondes.

Fonctionnalités :

• Ventilation par catégorie — vues treemap et sunburst des dépenses par noeud de taxonomie
• Analyse de tendances — dépenses mensuelles/trimestrielles dans le temps avec comparaison année-sur-année
• Analyse Top-N — plus gros consommateurs, catégories en plus forte croissance, plus grandes variances
• Budget vs réel — quand les données budgétaires sont disponibles, superposition prévu vs réalisé
• Lien inter-entités — cliquer sur n’importe quelle catégorie pour voir les matériaux, fournisseurs ou centres de coûts sous-jacents

Price Lab

Analyse interactive des prix pour comparer les prix catalogue master aux prix de facturation réels. Trois modes de graphique :

Scatter plot — chaque matériau tracé en prix master (x) vs prix facturé (y) sur échelle logarithmique. Les points au-dessus de la ligne d’accord sont facturés plus cher que le master ; en dessous, moins cher. Consommables et médicaments sont colorés différemment. Cliquer sur n’importe quel point pour accéder à sa timeline. Jusqu’à 5 000 matériaux.

Histogramme de déviation — distribution de (facturation - master) / master en pourcentage. Vert = dans ±5%. Rouge = sous-tarifé. Bleu = sur-tarifé. Montre combien de matériaux tombent dans chaque bande de déviation.

Timeline — historique des prix pour un matériau unique dans le temps. Prix master affichés comme lignes en escalier par site (par ex. Brig, Visp), prix de facturation comme points scatter individuels. Info-bulles montrant les numéros de facture, quantités, statut actif/inactif. Résumé de palette dans le sous-titre.

Fonctionnalités :

• Règles de résolution configurables — choisir comment résoudre le prix master (par ex. « si un seul actif, l’utiliser ; sinon le plus récent ») et le prix de facturation (par ex. moyenne, plus récent)
• Zoomable — défiler pour zoomer, glisser pour déplacer, bouton de réinitialisation
• Deep links — ?material=X ouvre la timeline d’un matériau spécifique directement
• Navigation croisée — cliquer sur un point scatter pour sauter à sa timeline
• Palette overlay — lignes de référence pointillées activables pour les règles de prix catalogue sur la timeline
• Histogram drilldown — cliquer sur n’importe quelle barre pour voir les matériaux individuels dans cette bande de déviation avec leurs prix

Signal Builder

Un outil unifié de création de Signal avec deux modes. (Les Signals étaient auparavant appelés probes — le YAML sous-jacent utilise toujours probe_id comme nom de champ.)

Mode Visual — assistant étape par étape vous guidant à travers la création de Signal :

1. Type — choisir parmi balance, entity_filter, duplicate, enrichment, mandatory_item
2. Scope — sélectionner le type d’entité et le Contract (gold.v1 ou silver.v1)
3. Config — configuration spécifique au type (champs, seuils, conditions)
4. Score — règles de scoring basées sur les métriques de Finding (échelle continue 0-100)
5. Metadata — probe_id, description, tags, texte d’affichage trilingue
6. Preview — YAML généré avec copie dans le presse-papiers

Mode YAML — éditeur brut pour un contrôle total :

• Écrire ou coller du YAML de Signal directement
• Compile — générer du SQL depuis le YAML
• Validate — vérifier contre les Contracts et les références
• Dry-run — prévisualiser les findings sans construire
• Roundtrip — convertir YAML → état wizard → YAML pour tester la fidélité
• Save to AFS — écrire le Signal directement dans l’AFS du tenant

Basculer entre les modes avec le toggle Visual/YAML en haut. L’assistant est pour l’exploration ; le mode YAML est pour les utilisateurs avancés.

Computed Aggregates

Lors du regroupement de lignes dans une table de dimension, les colonnes numériques sont agrégées avec SUM. Mais les ratios dérivés comme delta_qty_pct = (qty_out - qty_in) / qty_in × 100 ne peuvent pas être sommés — le résultat serait dénué de sens.

Les computed aggregates résolvent cela. Le YAML Entity déclare des expressions SQL qui remplacent le SUM naïf lors du group-by :

columns:
  computed_aggregates:
    delta_qty_pct:
      expression: "SUM(delta_qty) / NULLIF(SUM(qty_in), 0) * 100"
      format: percent

L’expression est évaluée côté serveur par DuckDB dans la ligne d’en-tête agrégée et les vues group-by. Les expressions ne référencent que des colonnes du même modèle — pas de sous-requêtes, pas de DDL.

Vues sauvegardées (Legacy)

Sur les pages de dimension, configurez vos filtres, tri et group-by, puis cliquez « + Save view ». La vue est :

• Nommée automatiquement depuis votre état actuel (modifiable)
• Stockée dans le SIS (persistante, partagée entre navigateurs)
• Affichée comme pilules cliquables au-dessus du champ de recherche
• Cherchable dans la JumpBar
• Copiable en YAML pour les notes de notebook (icône presse-papiers)

Locale

Basculer entre DE, EN, FR en utilisant le sélecteur de locale en bas de la barre latérale, ou via JumpBar : > deutsch, > english, > français.

Tout le contenu — Theses, descriptions de Signal, interprétations, boîte à outils analyste — est trilingue.