Construire une Console

◆ Ingénieur IA ● Profil digital

Objectif : publier une subbox Console (subboxType: frame) qui affiche un rendu HTML versionné, validé HITL, alimenté par Postgres.

Prérequis : un projet, une table résultat déclarée dans outputInference, un rôle projet WRITE.

Déclarer la subbox

Dans le dashboard YAML :

subboxType: frame
subboxId: "1"
subboxTitle: "Synthèse"
subboxRowsArea: 8
subboxColsArea: 12
subboxQuery: "SELECT metric, value FROM project_<project_id>_result_frame_metrics"

subboxQuery sert au dry-run wizard. Au runtime, l’API exécute frameQuery stockée dans l’artefact.

Studio auteur (WRITE)

Console Studio permet de modifier la Console via un shell à cinq zones (barre de gouvernance, structure, canvas iframe, inspecteur / chat, tiroir SQL). Le chat appelle POST /api/v1/projects/{project_id}/frame/studio/run.

Règles stables :

  • Un run sans effet mesuré (hash identique) n’est pas un succès.

  • Les erreurs sont explicites (SQL, patch rejeté, Postgres 503).

  • Clic simple : cible unique. Ctrl/⌘+clic : empile le contexte.

  • Publication gouvernée : récapitulatif, soumission à validation, puis VALIDATED. Si requireAllBlocksValidated, les blocs modifiés doivent être revalidés.

Serve lecture

POST /api/v1/projects/{project_id}/frame/serve charge l’artefact actif VALIDATED et injecte NEXA_DATA dans l’iframe sandboxée.

Kiosque public : POST /api/v1/public/dashboard/frame/serve (artefact validé, sans Studio ni HITL). Voir Lien public kiosque.

Tables projet

Suffixes project_{id}_result_frame_* : artefacts, validations de blocs, événements d’audit, snippets, registre de datasets. À déclarer dans outputInference.

Voir aussi