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).

Les catégories que reçoit votre organisation dépendent du bundle sectoriel que vous avez contracté avec Futuh (coopération, tiers secteur d’action sociale, ESS). Dans le cadre de ce qui est contracté, la synchronisation apporte le catalogue complet de chaque type de donnée : il n’y a pas de filtre fin par client sur les enregistrements précis qui arrivent, ce filtrage se fait ensuite, déjà dans votre instance.

Étape 1 : Connecter l’endpoint du Hub

Ouvrez Federación Futuh → Configuración Federación → Hubs configurados et ouvrez l’enregistrement Hub Futuh Central.
Vérifiez l’URL du Hub (préconfigurée sur https://hub.futuh.coop ; ne la changez que si l’équipe Futuh vous en a fourni une autre).
Dans le groupe Configuración, collez le jeton dans le champ Token de autenticación. Le champ s’affiche masqué pendant la saisie.
Enregistrez.

Le module n’a pas de bouton « tester la connexion ». Pour confirmer que la connexion fonctionne, laissez tourner le healthcheck automatique (toutes les 4 heures, il met à jour le groupe Estado de l’enregistrement) ou forcez une synchronisation (Étape 3). Si quelque chose é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 : Vérifier les abonnements canon

Pas besoin d’activer les canons à la main : votre instance s’abonne automatiquement aux types de donnée dont ont besoin les modules que vous avez installés. Si vous avez Radar, elle s’abonne aux bases réglementaires BDNS et aux attributions ; si vous avez Incidencia Política, aux parlementaires ; et ainsi de suite pour chaque module.

Ouvrez Federación Futuh → Configuración Federación → Subscriptions activas.
Vérifiez la liste : vous verrez un abonnement par type de donnée que consomment vos modules (quatre ou plus dans une installation typique).
Chaque abonnement déclare le modèle de destination et la route d’origine dans le Hub, et affiche son état de santé.

Les catégories dont vous disposez dépendent du bundle sectoriel contracté avec Futuh. Le cron de pull quotidien (Étape 3) synchronise les nouveautés de tous les abonnements actifs.

É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 Federación Futuh → Configuración Federación → Histórico de syncs.
Vérifiez que le premier pull apparaît avec l’état OK ou Partial.
S’il affiche Failed ou Hub Unreachable, ouvrez le détail pour voir le motif (le plus fréquent est un timeout : relancez-le depuis le bouton Sincronizar ahora de l’abonnement).

À 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 Paramètres → Technique → Actions planifiées.
Localisez l’entrée Futuh Federation: pull canon diario.
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 manuellement.

Les journaux de chaque exécution se trouvent dans Federación Futuh → Configuración Federación → Histórico de syncs, avec des métriques : nombre d’enregistrements reçus, créés, mis à jour et ignorés pour cause de modification manuelle.

Comment ce flux s’articule avec le reste

Module	Ce qu’il consomme du Hub	Détail
Federación 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
Recepción Inteligente	Catalogue de types documentaires canon	Plataforma de Recepción Inteligente
Incidencia Política	Contacts parlementaires canon (Tier 1)	Incidencia Política
Gestión 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.