Synchroniser votre instance avec la Fédération Futuh

Ce qui est fédéré aujourd’hui

La version actuelle de la Federación Futuh distribue quatre catégories de données canon depuis un unique Hub Central opéré par l’équipe Futuh au sein de l’infrastructure de l’Asamblea de Cooperación Por la Paz :

Bases réglementaires BDNS analysées par l’IA : chaque appel à projets publié dans la BDNS est traité une seule fois dans le Hub pour en extraire les exigences formelles, les critères d’évaluation et les bénéficiaires éligibles. Votre instance reçoit l’analyse structurée, pas le PDF.
Attributions BDNS : historique de qui a reçu quelle subvention, pour que Radar puisse estimer les taux de succès par appel.
Modèles documentaires : conventions types, mémoires modèles, clauses juridiques habituelles (LGPL, RGPD, contrats coopératifs).
Agent Pack de Silvio : agents IA pré-entraînés que Silvio utilise pour des tâches spécifiques (résumer des bases, suggérer des clauses, rédiger des e-mails client).

Chaque catégorie peut être activée ou désactivée indépendamment depuis la configuration du client, selon les bundles sectoriels contractés par votre organisation.

Étape 1 : Connecter l’endpoint du Hub

Ouvrez Settings → Federación Futuh → Configuration du Hub.
Collez l’URL du Hub Central que l’équipe Futuh vous a fournie lors de la souscription de votre cotisation.
Collez le jeton d’authentification. L’interface le sauvegarde chiffré dans votre base de données.
Cliquez sur Tester la connexion. Vous recevrez une réponse 200 OK avec le catalogue de canon disponible si tout est correct.

Si la connexion échoue, la cause la plus fréquente est que le jeton est expiré ou que l’URL pointe vers le Hub d’un environnement incorrect (préproduction au lieu de production). Contactez l’équipe Futuh pour vérification.

Étape 2 : Activer les canons que vous souhaitez recevoir

Dans la même vue de configuration, ouvrez l’onglet Canons disponibles.
Activez ceux qui s’appliquent à votre organisation : bases réglementaires BDNS, attributions, modèles documentaires, Agent Pack.
Pour chaque canon activé, vérifiez le bundle sectoriel qui s’applique (coopération, tiers secteur d’action sociale, ESS) et confirmez.
Sauvegardez la configuration.

À partir de ce moment, chaque canon activé a un cron quotidien associé qui synchronise les nouveautés.

Étape 3 : Première synchronisation complète

La première fois que vous activez un canon, le cron télécharge le catalogue historique complet. Cela peut prendre plusieurs minutes selon le volume.

Ouvrez Settings → Federación Futuh → Logs de synchronisation.
Vérifiez que le premier pull apparaît avec l’état partial ou success.
S’il affiche failed ou error, ouvrez le détail pour voir le motif (le plus fréquent est un timeout : relancez manuellement depuis le bouton Forcer la synchronisation).

À partir du deuxième cron, les pulls sont incrémentaux : seules les nouveautés depuis la dernière synchronisation sont téléchargées. C’est rapide (quelques secondes) sauf lors des journées de mise à jour massive du canon.

Ce qui vient de l’extérieur vs ce qui est propre

La distinction est importante pour comprendre ce qui se passe avec un enregistrement quand vous le modifiez manuellement :

Ce qui vient du Hub porte une marque interne appelée canonical_signature, une signature MD5 du contenu canon que le Hub a envoyé. Cette marque permet à votre instance de distinguer un enregistrement fédéré d’un enregistrement créé par votre organisation.
Ce que votre organisation ajoute par-dessus est signalé par le flag manually_edited=True. Quand le cron quotidien détecte une nouveauté canon sur un enregistrement que vous avez modifié, il ne l’écrase pas : il la laisse passer et enregistre un avertissement dans le log.

Cela signifie que vous pouvez adapter à votre contexte n’importe quel modèle documentaire, ajuster l’analyse d’une base réglementaire ou personnaliser un Agent Pack, sans craindre que la prochaine synchronisation efface vos modifications.

Modèle de coûts Tier 0 vs Tier 1

La fédération fonctionne avec deux tiers :

Tier 0 : canon du domaine public ou produit par la communauté Futuh. Inclut les bases réglementaires BDNS analysées, les marqueurs CAD/AOD, les ODS Agenda 2030, les vocabulaires officiels. Disponible pour toute instance sans coût supplémentaire sur la cotisation Futuh.
Tier 1 : canon à valeur ajoutée propriétaire Futuh. Inclut des modèles documentaires canon rédigés par l’équipe, des Agent Packs pré-entraînés, des contacts parlementaires européens enrichis avec HowTheyVote. Nécessite un abonnement Tier 1 actif.

La cotisation annuelle Futuh que votre organisation paie (calculée à partir de vos revenus triennaux, en cinq tranches jusqu’à 25 M€) couvre la fédération entière, sans facturation à la consommation. Il n’y a pas de limite de téléchargements, ni de supplément par nombre d’appels suivis, ni de prix par modèle téléchargé. Le raisonnement du projet canon est que si la fédération tient sa promesse, il n’y a pas de sens à vous facturer son usage.

Si vous décidez de ne pas renouveler la cotisation, les modules continuent de fonctionner avec ce qui a été synchronisé en dernier, mais ils ne reçoivent plus de nouvelles mises à jour canon. Le code Futuh est libre et téléchargeable sans fédération ; les services fédérés sont le filtre qui distingue l’abonnement de l’installation simple.

Vérifier le cron

Ouvrez Settings → Technique → Actions planifiées.
Localisez l’entrée Futuh Federation: Pull quotidien canon hubs.
Vérifiez qu’elle est active et que son prochain déclenchement est planifié.
Si vous devez forcer un pull immédiat, ouvrez l’entrée et cliquez sur Exécuter maintenant.

Les logs de chaque exécution se trouvent dans Settings → Federación Futuh → Logs de synchronisation, avec des métriques : nombre d’enregistrements reçus, créés, mis à jour, ignorés pour cause de modification manuelle.

Comment ce flux s’articule avec le reste

Module	Ce qu’il consomme du Hub	Détail
[[Federacion_Futuh]]	La couche qui organise la synchronisation elle-même	Federación Futuh
[[Radar]]	Bases réglementaires BDNS analysées + attributions	Radar de subventions
[[Silvio]]	Agent Pack canon par défaut	Silvio
[[Plataforma_de_Recepcion_Inteligente]]	Catalogue de types documentaires canon	Plataforma de Recepción Inteligente
[[Incidencia_Politica]]	Contacts parlementaires canon (Tier 1)	Incidencia Política
[[Gestion_de_ayudas]]	Modèles documentaires pour les étapes du projet	Gestión de ayudas

Pour en savoir plus

Connecter votre instance au Hub Central pour le détail technique de la configuration.
Federación Futuh pour comprendre l’architecture hub-and-spoke.
Glossaire pour les termes canon : Hub Central, canon documentaire, canonical signature.