Sincronizar tu instancia con la Federación Futuh

Para qué sirve

Activar el canal de sincronización canon desde el Hub Central hacia tu instancia, entender qué datos llegan de fuera, qué datos siguen siendo tuyos, y qué modelo de costes aplica.

Antes de empezar

• Rol: administradora de la instancia Futuh.
• Tu organización tiene contratada una cuota Futuh con suscripción a la federación.
• Acceso al menú Settings → Federación Futuh.
• Tiempo estimado: 10-15 min de configuración inicial, el resto sucede solo.

Qué se federa hoy

La versión actual de la Federación Futuh distribuye cuatro categorías de datos canon desde un único Hub Central operado por el equipo Futuh dentro de la infraestructura de Asamblea de Cooperación Por la Paz:

• Bases reguladoras BDNS analizadas con IA: cada convocatoria publicada en BDNS se procesa una vez en el Hub para extraer requisitos formales, criterios de valoración y beneficiarios elegibles. Tu instancia recibe el análisis estructurado, no el PDF.
• Adjudicaciones BDNS: histórico de quién recibió qué subvención, para que Radar pueda estimar tasas de éxito por convocatoria.
• Plantillas documentales: convenios tipo, memorias modelo, cláusulas legales habituales (LGPL, RGPD, contratos cooperativos).
• Agent Pack de Silvio: agentes IA preentrenados que Silvio usa para tareas específicas (resumir bases, sugerir cláusulas, redactar correos cliente).

Cada categoría puede activarse o desactivarse de forma independiente desde la configuración del cliente, según los bundles sectoriales que tu organización tenga contratados.

Paso 1: Conectar el endpoint del Hub

1. Abre Settings → Federación Futuh → Configuración del Hub.
2. Pega la URL del Hub Central que el equipo Futuh te ha facilitado al contratar tu cuota.
3. Pega el token de autenticación. La interfaz lo guarda cifrado en tu base de datos.
4. Pincha Probar conexión. Recibirás respuesta 200 OK con el catálogo de canon disponible si todo está correcto.

Si la conexión falla, lo más habitual es que el token esté caducado o que la URL apunte al Hub de un entorno equivocado (preproducción en lugar de producción). Contacta con el equipo Futuh para revisarlo.

Paso 2: Activar los canon que quieres recibir

1. En la misma vista de configuración, abre la pestaña Canon disponibles.
2. Activa los que aplican a tu organización: bases reguladoras BDNS, adjudicaciones, plantillas, Agent Pack.
3. Para cada canon activado, revisa el bundle sectorial que aplica (cooperación, tercer sector de acción social, ESS) y confirma.
4. Guarda la configuración.

A partir de este momento, cada canon activado tiene un cron diario asociado que sincroniza las novedades.

Paso 3: Primera sincronización completa

La primera vez que activas un canon, el cron descarga el catálogo histórico completo. Esto puede tardar varios minutos según el volumen.

1. Abre Settings → Federación Futuh → Logs de sincronización.
2. Verifica que el primer pull aparece con estado partial o success.
3. Si aparece failed o error, abre el detalle para ver el motivo (lo más habitual es timeout: vuelve a lanzar manualmente desde el botón Forzar sincronización).

A partir del segundo cron, los pulls son incrementales: solo se descargan las novedades desde la última sincronización. Esto es rápido (pocos segundos) salvo en días de actualización masiva del canon.

Qué llega de fuera vs qué es propio

La distinción importa para entender qué pasa con un registro cuando lo editas a mano:

• Lo que llega del Hub tiene una marca interna llamada canonical_signature, una firma MD5 del contenido canon que el Hub envió. Esta marca permite a tu instancia distinguir un registro federado de uno creado en tu organización.
• Lo que tu organización añade encima queda señalado con el flag manually_edited=True. Cuando el cron diario detecta una novedad canon sobre un registro que tú has editado, no la sobrescribe: la deja pasar de largo y registra un aviso en el log.

Esto significa que puedes adaptar a tu contexto cualquier plantilla, ajustar el análisis de una base reguladora o personalizar un Agent Pack, sin miedo a que la próxima sincronización borre tus cambios.

Cuándo se reactiva la sincronización tras edición manual

Si quieres volver al canon (porque tu modificación local ha quedado obsoleta), abre el registro, pulsa Resincronizar desde Hub y confirma. Esto borra tu versión local y restaura la versión canon vigente.

Modelo de costes Tier 0 vs Tier 1

La federación funciona con dos tiers:

• Tier 0: canon de dominio público o producido por la comunidad Futuh. Incluye bases reguladoras BDNS analizadas, marcadores CAD/AOD, ODS Agenda 2030, vocabularios oficiales. Disponible para cualquier instancia sin coste adicional sobre la cuota Futuh.
• Tier 1: canon de valor añadido propietario Futuh. Incluye plantillas documentales canon redactadas por el equipo, Agent Packs preentrenados, contactos parlamentarios europeos enriquecidos con HowTheyVote. Requiere suscripción Tier 1 activa.

La cuota anual Futuh que tu organización paga (calculada a partir de tus ingresos trienales, en cinco tramos hasta 25 M€) cubre la federación entera, sin facturación por consumo. No hay límite de descargas, ni recargo por número de convocatorias rastreadas, ni precio por plantilla descargada. El razonamiento del proyecto canon es que si la federación cumple su promesa, no tiene sentido cobrarte por usarla.

Si decides dejar de renovar la cuota, los módulos siguen funcionando con lo último que sincronizaron, pero ya no reciben actualizaciones canon nuevas. El código Futuh es libre y descargable sin federación; los servicios federados son el filtro que distingue la suscripción de la instalación pelada.

Verificar el cron

1. Abre Settings → Técnico → Acciones programadas.
2. Localiza la entrada Futuh Federation: Pull diario canon hubs.
3. Verifica que está activa y que su próximo disparo aparece programado.
4. Si necesitas forzar un pull inmediato, abre la entrada y pulsa Ejecutar ahora.

Los logs de cada ejecución quedan en Settings → Federación Futuh → Logs de sincronización, con métricas: número de registros recibidos, creados, actualizados, skipped por edición manual.

Cómo encaja con el resto

Módulo	Qué consume del Hub	Detalle
[[Federacion_Futuh]]	La capa que organiza la sincronización en sí	Federación Futuh
[[Radar]]	Bases reguladoras BDNS analizadas + adjudicaciones	Radar de ayudas
[[Silvio]]	Agent Pack canon de fábrica	Silvio
[[Plataforma_de_Recepcion_Inteligente]]	Catálogo de tipos documentales canon	Plataforma de Recepción Inteligente
[[Incidencia_Politica]]	Contactos parlamentarios canon (Tier 1)	Incidencia Política
[[Gestion_de_ayudas]]	Plantillas documentales para etapas del proyecto	Gestión de ayudas

Para entender más

• Conectar tu instancia al Hub Central para el detalle técnico del setup.
• Federación Futuh para entender la arquitectura hub-and-spoke.
• Glosario para los términos canon: Hub Central, canon documental, canonical signature.