1 · La tesis en una frase
GalaxIA es el sistema operativo de la PYME (la capta, le lleva facturas, cobros, caja, nómina, fiscal, legal, marketing y WhatsApp). SM Family Office es el lado del capital (inversionistas, crédito, factoring, trade finance, pagos entre países, ledger de la casa). Juntos cierran un circuito: GalaxIA produce demanda calificada y datos verificados de miles de PYMEs; el family office pone los productos de capital y el balance. Ninguno sustituye al otro: GalaxIA origina, el family office financia.
Comparten pila y proveedores: Postgres, Anthropic, Resend, Documenso/firma, n8n, JWT RS256 entre sistemas y los mismos cinco países (VE · PA · CO · MX · ES).
2 · Los cuatro repositorios, en limpio
ERP GalaxIA-ERP
Un ERP real y profundo: 187 modelos Prisma, 120 migraciones, 95 controladores. Facturas, cuentas por cobrar y por pagar con aging y doble moneda, cobranza con score de riesgo (modelo sklearn real), contabilidad de doble partida con constraint de balance, bancos y conciliación, inventario y POS, nómina y fiscal de 5 países, multi-tenant con RLS en Postgres. Tiene una API de integración ya hecha: lectura /v1/integration/{facturas,cxc,cxp,clientes,estados-cuenta,snapshots…} y escritura /v1/ingest-bridge/document, autenticada con JWT RS256 + JWKS. Firma con Documenso, pagos Yappy.
Faltantes: no existe el concepto de factura cedida/factoring; no hay API keys ni consentimiento por tenant; el CRM de pipeline (leads/oportunidades) no existe; la emisión fiscal real depende de PACs.
Portal GalaxIA-Empresarial
Monorepo NestJS + Next.js + motor de IA FastAPI (Claude Haiku/Sonnet). 41 módulos: RRHH y nómina de 5 países, CashGuard (tesorería, runway, fugas), legal (148 procesos con PDF), fiscal, cockpit con SSE, routing IA, financiamiento con «PaqueteFinanciero» tipo INVERSIONISTA (un originador de expedientes listo para apuntar al family office), cuentas por cobrar y emisión de factura con CUFE. Onboarding de 16 pasos, auth completo (TOTP, magic link, Google).
Faltantes: pagos en esqueleto (Stripe comentado, Yappy lanza excepción), galaxiaScore existe como campo pero no se calcula, Event-Filler y Estudio Creativo no viven aquí (solo copy comercial).
Infra galaxia-studio-infra
Infraestructura como código de «GalaxIA Studio»: AWS EC2 + Caddy + systemd, CDK para 3 entornos, secretos en Secrets Manager, despliegue por SSM. n8n con 18 flujos exportados (onboarding con tenant + WhatsApp + correo, cierre de cita con ICS, hot lead, insights Meta, reintentos CAPI, cadena de firma con Documenso y cadena de hash Ley 81) y Documenso para firma electrónica.
Riesgo: hay secretos en claro en los JSON de n8n (clave de Resend y token de Meta); rotarlos. Varios webhooks sin firma.
Estudio galaxia-studio-estudio-creativo
137 mil líneas de Python sobre http.server de la librería estándar (no FastAPI), datos en JSON por tenant y Postgres solo para identidad. Construido de verdad: Valentina (asistente WhatsApp con 16 herramientas Anthropic), fábrica F0→F15 con gates, estudio self-service, Event-Filler con calendario y OAuth Google/Microsoft, recuperador de clientes dormidos, 14 monitores, compliance Ley 81 con cadena de hash, contratos Documenso idempotentes, cobros ACH/Yappy/Stripe, router de IA con failover Claude→GPT→Gemini.
Módulos importables tal cual en el family office (misma pila, cero red por defecto): llm.py, compliance/ley81.py, compliance/contrato.py + firma, dispatch_protocol.py (rate-limit por contacto), agenda.py + calendar_store.py + connections/, el patrón de tools/, consent_generator.py (PDF con marca), cost_ledger.py.
3 · Mapa de integración · qué alimenta qué
| Negocio del family office | Lo que GalaxIA ya tiene | Por dónde | Qué falta |
|---|---|---|---|
| Nexus Factoring · cartera del cedente y deudores | ERP: Factura + CuentaPorCobrar (saldo, vencimiento, moneda, CUFE, RUC normalizado), Cliente con límite y días de crédito. Portal: CxcFactura, aging real. | GET /v1/integration/facturas, /cxc, /clientes | Estado «factura cedida» en el ERP (hoy seguiría cobrándola) y consentimiento del tenant para compartir cartera. |
| Nexus Financing / originación · solicitudes de crédito | Portal: PaqueteFinanciero tipo INVERSIONISTA con documentos y POST /financiamiento/paquete/:id/enviar. Señales: CashGuard (runway, fugas), presión de nómina, paz y salvo DGI/CSS. ERP: CollectionRiskScore (sklearn, Python). | El «enviar» apunta a solicitudes_credito / negocios de originación del family office; el score se importa. | Calcular galaxiaScore (hoy vacío); hacerlo en el family office con esas señales. |
| Nexus Pay · pagos y cobros | Portal: interfaz limpia PaymentProvider (createCheckoutSession/verifyWebhook, PAYMENT_PROVIDER=mock|yappy|stripe). ERP: factory de GatewayProvider + webhook HMAC. | Añadir NexusPayProvider en los dos. | Suscripción recurrente y dunning en el portal (hoy solo plan + fin de trial). Es el cambio de mayor retorno: desbloquea el cobro SaaS y da a las PYMEs pagos entre VE/PA/CO/MX/ES. |
| Nexus Trade / confirming | ERP: CuentaPorPagar, OrdenCompra, Proveedor. | /v1/integration/cxp | Mapear OC → operación de Trade; el rol pagador confirmante ya existe en el family office. |
| Conciliación y desembolsos | ERP: BankTransaction con huella de duplicados, BankStatement. | /v1/integration/estados-cuenta | Nada estructural: cruzar con la conciliación propia. |
| Identidad entre sistemas | ERP y portal: JWT RS256 + /.well-known/jwks.json + guardas de «emisor confiable». | El family office publica su JWKS y entra en ERP_TRUSTED_ISSUERS. | Scopes y consentimiento por tenant. No inventar API keys nuevas. |
| Firma y compliance | Documenso (infra + ERP), firma HMAC propia del portal, cadena Ley 81 (estudio e infra). | Una decisión: firma propia del family office para cesiones, pagarés y mandatos; Documenso para contratos SaaS. Cadena Ley 81 importada para consentimientos de inversionistas. | Plantillas de contrato (no están en infra) y API key de Documenso. |
| Canales y agenda | Valentina (WhatsApp con herramientas), flujos n8n (onboarding, cierre de cita, hot lead), agenda con OAuth, PDF con marca. | Webhooks n8n → family office; tools/ para «estado de cuenta», «mis aportes», «mis pagos»; agenda para reuniones con inversionistas. | WhatsApp Business oficial con plantillas aprobadas (hoy Wassenger). El sender del brain nuevo está desconectado. |
Lo que NO se junta
- Los ledgers. El ERP lleva los libros de cada PYME (doble partida propia); el family office lleva los libros de la casa. Se consumen
/v1/integration/{periodos,saldos}para vigilar al cedente o deudor; no se fusionan. - El asistente. El family office conserva el suyo (manual como datos, pantallas reales). Puede adoptar el router con failover de
llm.py. - La fábrica creativa y los monitores. Son de captación de PYMEs; se usan por API para producir teasers y material de captación de inversionistas, no se importan.
4 · En qué orden
- Identidad mutua RS256/JWKS entre los tres sistemas. Días.
- Nexus Pay como proveedor de pagos en el portal (cobro de suscripciones) y en el ERP (pagos de PYMEs entre países). Retorno inmediato; sustituye el Stripe comentado y el Yappy en esqueleto.
- Cartera del ERP → Factoring: lectura de facturas y CxC, consentimiento del tenant, estado «cedida» de vuelta al ERP.
- PaqueteFinanciero → Financing/originación con score calculado en el family office.
- CxP → Trade/confirming.
- n8n, Documenso y Valentina para onboarding, firma y avisos de la casa.
5 · Riesgos que conviene atender ya
- Historia aplanada. Los cuatro repos tienen un solo commit (Raúl purgó el historial por fugas de secretos). Un espejo protege de hoy en adelante, no recupera el pasado.
- Datos fuera de git. Estudio Creativo y Event-Filler guardan sus datos en JSON en el EC2 (
data/no está en el repo) y la documentación del portal reconoce que viven en una máquina sin remoto ni respaldo. Un espejo del código no respalda esos datos: hace falta un respaldo de la máquina. - Secretos en claro en los flujos n8n del repo de infraestructura (Resend, Meta). Rotar.
- Pagos en esqueleto en el portal y sin concepto de cesión en el ERP: son los dos huecos que el family office llena primero.
- Propiedad. Los cuatro repos están en la cuenta personal de Raúl y tú eres colaborador con permiso de escritura; los espejos en tu cuenta son la garantía mínima.