Fracttal ETL Hub Documentation

Bienvenido a la documentación completa del Fracttal ETL Hub, una plataforma avanzada de integración de datos que permite conectar múltiples sistemas empresariales de manera eficiente y escalable.

¿Qué es Fracttal ETL Hub?

Fracttal ETL Hub es una solución ETL (Extract, Transform, Load) basada en configuraciones JSON que implementa el protocolo JSON-RPC 2.0. La plataforma ofrece:

• 18+ tipos de conexiones nativas a sistemas empresariales
• 40+ operadores de transformación basados en JSON Logic
• Sistema de eventos dinámicos para flujos de trabajo complejos
• Orquestación con Apache Airflow 2.9.3
• Validación automática de configuraciones

Metodología Atomic Design

Organizamos nuestra documentación siguiendo la metodología Atomic Design, adaptada para ETL:

ÁTOMOS - Elementos básicos

Los componentes más pequeños e indivisibles del sistema ETL.

• APIs

  ---

  Conectores disponibles: Database, Fracttal API, HTTP/REST, SOAP, Google Sheets, Email

  Explorar APIs

• Operadores

  ---

  Operadores básicos: format_date, case, rename, substring, switch

  Ver Operadores

• Tipos de Datos

  ---

  Tipos fundamentales: String, Number, Boolean, Array

  Tipos de Datos

MOLÉCULAS - Patrones funcionales

Combinaciones de átomos que trabajan juntos para crear funcionalidades específicas.

• Patrones de Source

  ---

  Database Filter, API Pagination, File Reader - Extracción optimizada de datos

  Patrones de Source (próximamente)

• Cadenas de Transform

  ---

  Data Cleaning, Date Formatting, Text Processing - Transformación de datos

  Transformaciones

• Outputs de Target

  ---

  Database Insert, API Send, File Export - Carga de datos procesados

  Outputs (próximamente)

Explorar Moléculas →

ETL - Flujos completos de ETL

Configuraciones completas que resuelven casos de uso específicos del negocio.

• Casos de Negocio

  ---

  Order Synchronization, User Migration, Inventory Update - Soluciones empresariales

  Casos de Negocio (próximamente)

• Patrones de Integración

  ---

  CRM to ERP, API to Database, File to API - Integraciones entre sistemas

  Integraciones (próximamente)

• Workflows

  ---

  Daily Reports, Real-time Sync, Batch Processing - Flujos automatizados

  Workflows (próximamente)

Guía de navegación

Para principiantes

1. Comienza con Getting Started
2. Explora los Átomos básicos
3. Practica con ejemplos simples

Para desarrolladores

1. Domina las Moléculas
2. Combina patrones para casos específicos
3. Consulta la API Reference

Para arquitectos

1. Estudia los ETL completos (próximamente)
2. Implementa casos de negocio complejos
3. Optimiza con mejores prácticas

Configuración rápida

Ejemplo básico: base de datos → API

{
  "source": {
    "id_type": 1,
    "feature": "filter_table_by_date_column",
    "parameters": {"table": "orders"}
  },
  "transform": {
    "rename": [
      [{"var": "id"}, "order_id", "string"],
      [{"var": "status"}, "order_status", "string"]
    ]
  },
  "target": {
    "id_type": 2,
    "feature": "create_work_orders"
  }
}

Conexiones disponibles

Tipo	ID	Sistema	Descripción
Database	1	Database	SQL Server, MySQL, PostgreSQL, Oracle
Fracttal	2	Fracttal	API nativa con 15+ managers especializados
Google Sheets	3	Google Sheets	Integración con Google Sheets API
HTTP/REST	4	HTTP/REST	Cliente HTTP robusto con reintentos
Email	5	Email	SendGrid para envío de emails
SMS	6	SMS	Twilio para mensajería SMS
Azure	7	Azure	Servicios de Microsoft Azure
AWS	8	AWS	Amazon Web Services (S3, etc.)
JIRA	9	JIRA	Atlassian JIRA API
SOAP	10	SOAP	Servicios web SOAP con Zeep

Ver todas las conexiones →

Casos de uso populares

• Sincronización de Datos: Mantener sistemas empresariales actualizados
• Migración de Datos: Transferir información entre plataformas
• Reportes Automatizados: Generar informes periódicos automáticamente
• Integración API: Conectar servicios web de terceros
• Procesamiento por Lotes: Manejar grandes volúmenes de datos
• Tiempo Real: Sincronización inmediata de cambios críticos

Recursos de aprendizaje

Documentación técnica

• API Reference - Referencia completa del protocolo JSON-RPC
• Operadores JSON Logic - Guía de transformaciones

Ejemplos prácticos

• Sincronización de Órdenes (próximamente) - Caso completo de negocio
• Migración de Usuarios (próximamente) - Transferencia de datos de usuario

Contribución

• Guía de Contribución - Cómo colaborar con el proyecto
• Guías de Desarrollo - Standards de desarrollo
• Testing - Pruebas y validación

---

¡Empieza Ahora!

¿Listo para crear tu primer ETL?

Comenzar → Ver Ejemplos → (próximamente)

Consejos Rápidos

• Usa el buscador para encontrar conexiones específicas
• Todas las configuraciones siguen el esquema JSON-RPC 2.0
• El entorno de producción es production
• Los UUIDs deben ser únicos por configuración

Importante

Recuerda validar todas las configuraciones antes de desplegar a producción.