baton-core
Baton es una plataforma auto-hospedable para automatización de flujos de trabajo que conecta webhooks verificados de múltiples fuentes (Salesforce, HubSpot, Zendesk) con Docusign Workflow Builder. Incluye un constructor visual de flujos, carga masiva CSV y gestión centralizada de errores bajo licenc
Ficha actualizada 27 sept 2026, 15:37 · upstream 27 sept 2026, 15:32 · release v1.0.1
Qué es baton-core
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Baton actúa como un middleware seguro que escucha eventos verificados desde plataformas CRM o herramientas de soporte, valida las firmas HMAC o autenticación básica y dispara los flujos correspondientes en Docusign. La arquitectura asincrónica almacena webhooks idempotentemente en una cola SQS para procesamiento robusto con reintentos y colas de mensajes muertos.
El entorno de desarrollo utiliza Node.js 20, Express y TypeScript para la API, mientras que el frontend está construido con React 18 y Vite. La persistencia de datos se maneja mediante DynamoDB (AWS o emuladores locales), y el sistema cuenta con autenticación nativa sin dependencias externas ni telemetría.
Destaca por su capacidad de carga masiva, permitiendo procesar archivos CSV o XLSX mapeando columnas a entradas del flujo, y un centro de control para gestionar fallos, pausar automatizaciones ante picos de error y revisar logs en tiempo real. Todo el despliegue es agnóstico al proveedor de nube gracias a la compatibilidad con emuladores locales o infraestructura AWS nativa mediante CloudFormation.
- Integración directa entre CRM (Salesforce, HubSpot) y Docusign para firma automática de documentos tras eventos específicos.
- Procesamiento masivo de archivos CSV para disparar flujos en lotes con control de velocidad y mapeo de columnas.
- Gestión centralizada de fallos mediante cola de errores, reintentos automáticos y pausado automático ante picos de error.
- Auditoría completa sin telemetría externa, ideal para cumplimiento normativo estricto en entornos corporativos.
- Desarrollo de conectores personalizados para sistemas que envían JSON vía POST siguiendo la estructura definida.
- Licencia Sustainable Use (fair-code) permitiendo auto-hospedaje y modificación libre dentro del negocio sin restricciones comerciales.
- Verificación de seguridad con firmas HMAC en tiempo constante y cifrado AES-256-GCM para secretos almacenados.
- Constructor visual ReactFlow integrado para diseñar, monitorizar y corregir automatizaciones sin código.
- Arquitectura asincrónica con SQS que garantiza la entrega de eventos incluso ante fallos transitorios o picos de carga.
- Sin telemetría externa ni dependencias de autenticación externas (email/password nativo), manteniendo el control total.
- Destino exclusivo limitado a Docusign Workflow Builder mediante OAuth, sin soporte para otros destinos de firma directa.
- Dependencia de AWS para servicios gestionados (DynamoDB, SQS) o uso de emuladores locales en entornos de evaluación.
- Configuración manual requerida para claves de cifrado y secretos JWT en el archivo .env antes del primer arranque.
- No incluye servicio de facturación ni gestión de usuarios externos integrada por defecto, requiriendo autogestión.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Docker Compose. Generar dos secretos aleatorios (TOKEN_ENCRYPTION_KEY, AUTH_JWT_SECRET) antes de iniciar con openssl. Para producción, usar docker-compose.prod.yml con TLS y backups programados. Asegurar APP_URL y API_URL en el reverse proxy para recibir webhooks externos. Actualizar mediante pinning de versión en .env y pull de imágenes. Consultar docs/deploy-production.md para infraestructura AWS nativa.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.