Catalogue des subbox — visualisations

◆ Ingénieur IA

Les types graphiques sont rendus par le composant Highcharts générique <highcharts-chart> : les options finales proviennent de defaultOptions[subboxType] fusionnées avec subboxOptions. Trois alias SQL reviennent partout : btrim (catégorie), count (valeur), keysplit (séries multiples).

Graphiques cartésiens

column

Colonnes verticales. Type cartésien de base pour comparer des valeurs entre catégories.

Rendu du type column.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Catégorie en abscisse (axe X).
count	number	Valeur (hauteur de la colonne).
keysplit	string	Optionnel : découpe en plusieurs séries côte à côte.

Paramètres subboxOptions principaux :

Option	Effet
subboxAxis.xAxis / yAxis	Nom et unité des axes.
plotOptions.column	borderRadius, pointPadding, groupPadding, color.
plotOptions.column.stacking	normal ou percent pour empiler les séries.
tooltip	Format de l’info-bulle (valueSuffix, pointFormat).
colors	Palette de la série (liste de couleurs hexadécimales).

basicbar

Barres horizontales. Identique à column mais orienté horizontalement — idéal pour des libellés longs.

Rendu du type basicbar.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Catégorie (axe Y horizontal).
count	number	Longueur de la barre.

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.bar	pointWidth, borderRadius, dataLabels.
yAxis.reversed	Inverser l’ordre des catégories.

line

Courbe d’évolution. La référence pour les séries temporelles.

Rendu du type line.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Point en abscisse (souvent une date).
count	number	Valeur en ordonnée.
keysplit	string	Optionnel : une courbe par valeur distincte.

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.line / series	marker, lineWidth, dashStyle, color.
xAxis.type	datetime pour un axe temporel.
yAxis.min / max	Bornes forcées de l’axe.
plotOptions.series.connectNulls	Relier les points malgré les valeurs nulles.

Graphiques empilés

stackedcolumn

Colonnes empilées : la valeur totale par catégorie se décompose en sous-séries.

Rendu du type stackedcolumn.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Catégorie en abscisse.
count	number	Valeur de la sous-série.
keysplit	string	Série d’empilement (obligatoire ici).

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.column.stacking	normal (valeurs) ou percent (100 %).
plotOptions.series.dataLabels	Afficher la valeur sur chaque segment.

stackedbar

Barres empilées horizontales. Même contrat que stackedcolumn, orientation horizontale.

Rendu du type stackedbar.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Catégorie.
count	number	Valeur de la sous-série.
keysplit	string	Série d’empilement.

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.bar.stacking	normal ou percent.

stackedarea

Aires empilées : visualise la contribution cumulée de plusieurs séries dans le temps.

Rendu du type stackedarea.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Point en abscisse (date).
count	number	Valeur de la série.
keysplit	string	Série empilée.

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.area.stacking	normal ou percent — règle le mode d’empilement.
plotOptions.area.fillOpacity	Opacité du remplissage.
plotOptions.area.marker.enabled	Afficher ou masquer les points.

Répartitions — parts d’un tout

pie

Camembert. Représente la part de chaque catégorie dans un total.

Rendu du type pie.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Libellé de la part.
count	number	Valeur (la part en % est calculée automatiquement).

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.pie.innerSize	Transformer en anneau (donut), ex. 60%.
plotOptions.pie.dataLabels.format	Format des étiquettes (point.percentage).
plotOptions.pie.showInLegend	Lister les parts dans la légende.

piechart

Camembert. Alias de pie : même contrat de données et mêmes options.

Rendu du type piechart.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Libellé de la part.
count	number	Valeur.

funnel

Entonnoir : étapes décroissantes d’un processus de conversion.

Rendu du type funnel.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Libellé de l’étape.
count	number	Volume à cette étape (décroissant).

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.funnel.neckWidth / neckHeight	Forme du col de l’entonnoir.
plotOptions.funnel.dataLabels	Affichage du volume et du taux.

sunburst

Sunburst : hiérarchie radiale parent → enfant sur plusieurs niveaux.

Rendu du type sunburst.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
id	string	Identifiant du nœud.
parent	string	Identifiant du parent (vide pour la racine).
count	number	Valeur (taille du secteur).

Paramètres subboxOptions principaux :

Option	Effet
levels	Style par niveau de profondeur (couleurs, dataLabels).
plotOptions.sunburst.allowDrillToNode	Zoom au clic sur un nœud.

Graphiques multidimensionnels

bubble

Bulles : trois dimensions simultanées — position X, position Y et taille.

Rendu du type bubble.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
x	number	Position horizontale.
y	number	Position verticale.
z	number	Taille de la bulle.
name	string	Libellé optionnel de la bulle.

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.bubble.minSize / maxSize	Bornes de diamètre des bulles.
plotOptions.bubble.sizeBy	area (défaut) ou width.

packedbubble

Bulles groupées (packed) : agglomère les bulles par catégorie sans axes cartésiens.

Rendu du type packedbubble.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
name	string	Libellé de la bulle.
value	number	Taille.
keysplit	string	Regroupement par série.

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.packedbubble.minSize / maxSize	Bornes de diamètre.
plotOptions.packedbubble.layoutAlgorithm	Algorithme de placement.

radar

Radar (araignée) : compare plusieurs entités sur un jeu d’axes communs.

Rendu du type radar.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Axe (dimension comparée).
count	number	Valeur sur cet axe.
keysplit	string	Une entité comparée par valeur distincte.

Paramètres subboxOptions principaux :

Option	Effet
chart.polar	true pour activer le mode radar.
pane.size	Diamètre de la toile.
yAxis.min / max	Échelle commune des axes.

polar

Graphique polaire : variante d’un cartésien projeté sur un repère circulaire.

Rendu du type polar.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Catégorie angulaire.
count	number	Valeur radiale.

Paramètres subboxOptions principaux :

Option	Effet
chart.polar	true (obligatoire).
pane.startAngle / endAngle	Plage angulaire.

gaugesolid

Jauge solide : une valeur unique positionnée sur une échelle (KPI visuel).

Rendu du type gaugesolid.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
value	number	La valeur à afficher (une seule ligne attendue).

Paramètres subboxOptions principaux :

Option	Effet
yAxis.min / max	Bornes de l’échelle.
yAxis.stops	Zones de couleur (seuils vert / orange / rouge).
plotOptions.solidgauge.dataLabels	Format de la valeur centrale.

Types à transformation API dédiée

Ces cinq types ne sont pas rendus directement depuis le SQL : un service ChartServices/* reformate d’abord les lignes. Le contrat de données est donc strict — toute colonne manquante déclenche une erreur 400.

waterfall

Cascade (bridge) : effet cumulé de variations successives, avec totaux intermédiaires.

Rendu du type waterfall.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
name	string	Libellé de l’étape (alias btrim accepté).
count	number	Variation, positive ou négative (alias y accepté).
sort_order	number	Ordre d’affichage (optionnel).
is_intermediate_sum	bool	Marque un total intermédiaire (optionnel).
is_sum	bool	Marque le total final (optionnel).
color	string	Couleur forcée du point (optionnel).

Paramètres subboxOptions principaux :

Option	Effet
plotOptions.waterfall.upColor	Couleur des variations positives.
series[0].color	Couleur des variations négatives.
yAxis	Format et bornes de l’axe des valeurs.

Avertissement

Ne jamais inclure de colonne keysplit : le découpage multi-séries est incompatible avec la transformation API de la cascade.

heatmap

Matrice de valeurs colorées selon une échelle continue (colorAxis).

Rendu du type heatmap.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
x	string	Catégorie de l’axe X (alias btrim).
y	string	Catégorie de l’axe Y (alias keysplit, mais une seule série).
value	number	Valeur de la cellule (alias count).

Paramètres subboxOptions principaux :

Option	Effet
colorAxis.min / max	Bornes de l’échelle de couleur.
colorAxis.minColor / maxColor	Couleurs des extrêmes.
plotOptions.heatmap.borderWidth	Bordure entre les cellules.

subboxOptions:
  colorAxis:
    min: 0
    minColor: "#FFFFFF"
    maxColor: "#3B7DD8"

pareto

Pareto : barres triées par fréquence décroissante + courbe cumulée en pourcentage (double axe Y).

Rendu du type pareto.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
btrim	string	Cause / catégorie.
count	number	Fréquence (le tri et le cumul sont calculés par l’API).

Paramètres subboxOptions principaux :

Option	Effet
yAxis[0]	Axe des valeurs (barres).
yAxis[1]	Axe des pourcentages cumulés (courbe).
plotOptions.column	Style des barres.

sankey

Diagramme de flux : l’épaisseur des liens est proportionnelle au poids. Les nœuds sont déduits automatiquement des valeurs from / to.

Rendu du type sankey.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
from	string	Nœud source du flux.
to	string	Nœud destination du flux.
weight	number	Poids du flux (casté en float).
groupfrom / groupto	string	Optionnel : colorisation des nœuds.

Paramètres subboxOptions principaux :

Option	Effet
series[0].nodeWidth	Largeur des nœuds.
series[0].nodePadding	Espacement vertical entre nœuds.
series[0].nodes	Personnalisation par nœud (couleur, niveau).

organization

Organigramme hiérarchique (module organization + sankey).

Rendu du type organization.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
from	string	Nœud parent.
to	string	Nœud enfant.
title	string	Titre affiché sur la carte (optionnel).

Paramètres subboxOptions principaux :

Option	Effet
chart.inverted	Orientation verticale / horizontale.
series[0].nodeWidth	Largeur des cartes.
levels	Style par niveau hiérarchique.
plotOptions.organization.dataLabels.nodeFormat	Gabarit HTML des cartes.

Visualisations de graphes

networkgraph

Graphe de réseau (nœuds et arêtes). Rendu par un workbench dédié app-chart-network-workbench (Sigma.js / Graphology), et non par Highcharts.

Rendu du type networkgraph.

Contrat de données — colonnes attendues en sortie de subboxQuery :

Colonne	Type	Rôle
source_node	string	Nœud source de l’arête.
target_node	string	Nœud destination de l’arête.
weight	number	Poids de l’arête (optionnel).

knowledge_graph

Graphe de connaissances. Présent dans le schéma factonics-utils et l’API. Le rendu Marketplace exact (Highcharts générique ou composant dédié) est à confirmer selon le projet.

Rendu du type knowledge_graph.