Plan site — Guide chatbot FractaVolta

Roadmap agile pour un guide public du corpus FractaVolta/Cogentia

Plan site — Guide chatbot FractaVolta

Objectif

Ajouter au site public fractavolta.com un Guide capable d'orienter les visiteurs dans le corpus public FractaVolta/Cogentia.

Ce Guide est une instance publique, immature et strictement limitee du jumeau numerique du proprietaire. Il n'est pas le noyau prive du jumeau, et il ne parle pas avec toute l'autorite du proprietaire. C'est une face publique infant/child au sens du modele de maturite Cogentia :

autorisé : orienter, chercher, citer, expliquer, proposer une lecture
interdit : agir, muter, publier, depenser du quota hors politique, exposer du prive

Le Guide doit aider un visiteur à comprendre :

• ce qu'est FractaVolta ;
• le lien entre énergie, calcul, paquets et capacité territoriale ;
• le rôle de Cogentia, Fractanet, Fracta, Inseme et MareNostrum ;
• où lire ensuite ;
• ce que le corpus affirme, et ce qu'il ne permet pas encore d'affirmer.

Principe agile

Le plan avance par petites tranches réversibles.

Quand l'erreur est réversible, apprendre par action traçable.
Quand l'erreur touche la confiance publique, filtrer avant exposition.

Le Guide public doit donc commencer sobrement. Il ne doit pas promettre une conversation intelligente complète avant que les frontières de confiance, d'usage de quota, de citation et de confidentialité soient vérifiées.

Mise a jour v0.2 : la tranche demonstrative cible directement une route publique gouvernee POST /guide/chat. Cette route reste cote serveur, utilise la vue publique Cogentia et peut appeler Magistral comme routeur d'intelligence sans exposer de cle API au navigateur.

Mise a jour v0.3 : le Guide est decrit comme une instance publique du jumeau, pas comme un simple chatbot separe. Cette instance a son propre mandat, sa vue du corpus, sa maturite et son autorite.

Contraintes de confiance

Le Guide public :

• utilise uniquement la vue publique ;
• cite les sources quand il répond depuis le corpus ;
• affiche quand il ne sait pas ;
• ne présente pas des hypothèses comme des capacités réalisées ;
• ne crée pas de compte utilisateur ;
• ne collecte pas de données personnelles en v0.1 ;
• ne déclenche pas d'action administrative ou commerciale ;
• ne contacte pas directement de fournisseur d'IA depuis le navigateur ;
• passe par le point public Cogentia MCP/API gouverné.

Architecture cible

fractavolta.com
  -> widget Guide public
  -> endpoint public Cogentia /guide/chat
  -> mandat d'instance public: infant, read-only, public corpus
  -> Cogentia Context Gateway sur Fracta
  -> index public du corpus
  -> Magistral local si synthese conversationnelle disponible
  -> sources citées GitHub/fractavolta.com

Plus tard :

Guide public
  -> retrieval public
  -> génération conversationnelle gouvernée
  -> réponses sourcées + limites visibles

La première version peut rester extractive : recherche, contexte, extraits et liens. La génération libre n'est pas obligatoire pour prouver l'utilité.

Parcours utilisateur v0.1

Bouton flottant ou bloc visible :

Guide

Panneau :

Ask the public FractaVolta Guide
Answers are grounded in the public corpus.

Prompts proposés :

• What is FractaVolta?
• What is Fractanet?
• How does Cogentia relate to FractaVolta?
• Give me a 10-minute reading path.
• What does the corpus say about Fracta, Caddy and MCP?

Réponse attendue :

• résumé court ;
• 3 à 5 sources ;
• liens vers les pages/documents ;
• mention explicite si la réponse est seulement partielle.

Tranches

Tranche 0 — Préparation documentaire

Objectif : stabiliser l'intention avant de coder.

Acceptation :

• ce plan existe ;
• les frontières public/privé/action sont explicites ;
• le Guide est defini comme instance publique du jumeau, pas comme noyau prive ;
• les prompts de test sont listés.

Statut : fait.

Tranche 1 — Widget et prompts

Objectif : ajouter une présence visible reliee a la route publique gouvernee.

Implémentation :

• inclure un bouton/panneau Guide dans le layout ;
• afficher les prompts proposés ;
• chaque prompt peut appeler la route publique gouvernee ;
• afficher les erreurs et les sources.

Acceptation :

• le site reste deployable comme site statique ;
• le Guide ne contacte pas directement un fournisseur d'IA ;
• le panneau fonctionne mobile/desktop ;
• le texte public reste sobre et non commercialement excessif.

Statut : implemente localement dans le layout Jekyll.

Tranche 2 — Recherche publique via Cogentia

Objectif : brancher le Guide sur la recherche publique sans génération libre.

Implémentation possible :

• appel direct à https://cogentia.fractavolta.com/mcp avec cogentia_search;
• ou petite façade /guide/search si CORS, format ou sécurité exigent un proxy ;
• affichage des résultats avec source id, titre, extrait et lien.

Acceptation :

• cogentia_search fonctionne depuis le site ;
• les résultats affichent repo, chemin, lignes et lien ;
• aucune clé API n'est exposée ;
• les erreurs réseau sont affichées simplement ;
• le Guide reste utilisable sans JavaScript comme liste de liens de départ.

Statut : premiere version via POST /guide/chat, avec fallback extractif cote serveur si la synthese conversationnelle n'est pas disponible.

Tranche 3 — Context packs et lignes citées

Objectif : permettre au Guide de construire une réponse plus utile sans halluciner.

Implémentation :

• cogentia_context_pack pour les questions larges ;
• cogentia_get_lines pour vérifier un résultat ;
• UI qui montre les sources avant ou avec la réponse.

Acceptation :

• une question large produit un pack limité ;
• l'utilisateur peut ouvrir les sources ;
• le Guide peut dire "insufficient public corpus evidence";
• pas de mutation, pas de session privée.

Statut : en cours via les context packs que la route Cogentia construit avant la synthese.

Tranche 4 — Réponse conversationnelle gouvernée

Objectif : transformer les résultats en réponse synthétique, avec prudence.

Précondition :

• une politique claire de coût/provider ;
• une route conversationnelle publique gouvernée ;
• citations obligatoires ;
• limites visibles ;
• logs non sensibles.

Acceptation :

• la réponse cite les sources ;
• les sources sont consultables ;
• les réponses non sourcées sont refusées ou marquées comme orientation ;
• quota et provider calls passent par la politique Cogentia/Magistral prévue.

Tranche 5 — Feedback public

Objectif : recueillir les corrections sans ouvrir un canal de capture.

Implémentation possible :

• bouton "This answer needs correction";
• lien vers GitHub issue préremplie ;
• ou formulaire public limité, modéré, sans données personnelles inutiles.

Acceptation :

• aucun feedback ne modifie le corpus directement ;
• les objections deviennent des traces ;
• les corrections utiles peuvent devenir issues ou continuations.

Questions de conception ouvertes

• Faut-il un widget global ou une page /guide dédiée d'abord ?
• Le premier appel doit-il viser /mcp ou une façade /tools/cogentia_search ?
• Faut-il une version française dès v0.1 ou après la tranche 2 ?
• Le Guide doit-il afficher "beta", "infant" ou une autre maturité publique ?
• Quel volume de logs publics est acceptable sans tracking intrusif ?

Prompts de validation

What is FractaVolta?
What is Fractanet?
How does Cogentia relate to FractaVolta?
Give me a 10-minute reading path about FractaVolta.
What does the corpus say about Fracta, Caddy and MCP?
What is the link between energy packets and cognitive infrastructure?

Pour chaque prompt, le Guide doit :

• répondre brièvement ;
• montrer les sources ;
• ne pas inventer de capacité opérationnelle ;
• proposer une prochaine lecture.

Prochain pas recommandé

Continuer par le durcissement de la route publique :

deployer /guide/chat sur Fracta, verifier CORS, tester une question publique

Puis brancher Magistral/OpenAI via la politique serveur, avec mesure de quota et fallback local.