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ú Federación Futuh (menú principal de Odoo; requiere rol de administrador de federación).
• 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).

Qué categorías recibe tu organización depende del bundle sectorial que tengas contratado con Futuh (cooperación, tercer sector de acción social, ESS). Dentro de lo contratado, la sincronización trae el catálogo completo de cada tipo de dato: no hay un filtro fino por cliente sobre qué registros concretos llegan, ese filtrado se hace después, ya en tu instancia.

Paso 1: Conectar el endpoint del Hub

1. Abre Federación Futuh → Configuración Federación → Hubs configurados y abre el registro Hub Futuh Central.
2. Verifica la URL del Hub (viene preconfigurada como https://hub.futuh.coop; solo la cambias si el equipo Futuh te ha facilitado otra).
3. En el grupo Configuración, pega el token en el campo Token de autenticación. El campo se muestra enmascarado mientras escribes.
4. Guarda.

El módulo no trae un botón de “probar conexión”. Para confirmar que la conexión funciona, deja que corra el healthcheck automático (cada 4 horas, actualiza el grupo Estado del registro) o fuerza una sincronización (Paso 3). Si algo falla, lo más habitual es que el token esté caducado o que la URL apunte a un Hub de un entorno equivocado (preproducción en lugar de producción). Contacta con el equipo Futuh para revisarlo.

Paso 2: Revisar las suscripciones canon

No hace falta activar los canon a mano: tu instancia se suscribe automáticamente a los tipos de dato que necesitan los módulos que tienes instalados. Si tienes Radar, se suscribe a bases reguladoras BDNS y adjudicaciones; si tienes Incidencia Política, a parlamentarios; y así con cada módulo.

1. Abre Federación Futuh → Configuración Federación → Subscriptions activas.
2. Revisa la lista: verás una suscripción por cada tipo de dato que consumen tus módulos (cuatro o más en una instalación típica).
3. Cada suscripción declara el modelo destino y la ruta de origen en el Hub, y muestra su estado de salud.

Qué categorías tienes disponibles depende del bundle sectorial contratado con Futuh. El cron diario de pull (Paso 3) sincroniza las novedades de todas las suscripciones activas.

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 Federación Futuh → Configuración Federación → Histórico de syncs.
2. Verifica que el primer pull aparece con estado OK o Partial.
3. Si aparece Failed o Hub Unreachable, abre el detalle para ver el motivo (lo más habitual es un timeout: vuelve a lanzarlo desde el botón Sincronizar ahora de la suscripció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.

Cómo volver al canon tras una edición manual

Si quieres que el Hub vuelva a actualizar un registro que editaste (porque tu cambio local ha quedado obsoleto), de momento hay que retirar la marca Editado localmente del registro, y eso requiere modo desarrollador o la ayuda del equipo Futuh. Un botón de un clic para revertir al canon está en el roadmap.

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 Ajustes → Técnico → Acciones planificadas.
2. Localiza la entrada Futuh Federation: pull canon diario.
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 manualmente.

Los logs de cada ejecución quedan en Federación Futuh → Configuración Federación → Histórico de syncs, con métricas: número de registros recibidos, creados, actualizados y omitidos por edición manual.

Cómo encaja con el resto

Módulo	Qué consume del Hub	Detalle
Federación 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
Recepción Inteligente	Catálogo de tipos documentales canon	Plataforma de Recepción Inteligente
Incidencia Política	Contactos parlamentarios canon (Tier 1)	Incidencia Política
Gestión 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.