WALKTHROUGH INTERACTIVO (LECTURA < 2 MINUTOS) | HAZ CLIC EN CUALQUIER NODO DEL DIAGRAMA PARA INSPECCIONARLO

Modelo Mental de la Arquitectura Innovia

Resumen Ejecutivo del Sistema: Zero Lock-in Guarantee

Innovia Messaging es una plataforma SaaS propia multi-tenant donde Innovia gestiona usuarios, campañas, audiencias CSV, API keys y estados de entrega en PostgreSQL. Toda comunicación con Meta WhatsApp se desacopla mediante el contrato MessagingProvider. Kapso resuelve la infraestructura pesada (onboarding sin Meta App propia, colas masivas y Managed Billing), permitiendo validar el producto en semanas sin quedar atrapados en un solo proveedor.

MAPA DE COMPONENTES DEL SISTEMA

100%

graph LR subgraph ingress ["1. Acceso & Clientes"] clientWeb["Dashboard Web Innovia"] publicApi["API REST Pública /v1"] end subgraph core ["2. Núcleo Soberano Innovia"] tenantCore["Tenants & Aislamiento"] campaignEngine["Gestor Campañas & CSV"] msgRouter["Router Transaccional"] eventNormalizer["Normalizador Webhooks"] end subgraph port ["3. Capa de Desacople"] providerPort["MessagingProvider Interface"] kapsoAdapter["KapsoAdapter"] end subgraph infra ["4. Acelerador Kapso & Meta"] metaOnboard["Meta Embedded Signup"] broadcastEngine["Colas Masivas & Throughput"] end clientWeb -->|"crea & programa"| campaignEngine publicApi -->|"dispara mensaje"| msgRouter tenantCore -.->|"aísla datos"| campaignEngine tenantCore -.->|"aísla datos"| msgRouter campaignEngine -->|"createBroadcast()"| providerPort msgRouter -->|"sendTemplate()"| providerPort providerPort -->|"ejecuta"| kapsoAdapter kapsoAdapter -->|"provisiona línea"| metaOnboard kapsoAdapter -->|"envía batch"| broadcastEngine broadcastEngine -.->|"webhook status"| eventNormalizer eventNormalizer -->|"actualiza estado"| tenantCore click clientWeb nodeClickHandler "Ver detalles de Dashboard Web" click publicApi nodeClickHandler "Ver detalles de API Transaccional" click tenantCore nodeClickHandler "Ver detalles de Tenants & Aislamiento" click campaignEngine nodeClickHandler "Ver detalles de Gestor de Campañas" click msgRouter nodeClickHandler "Ver detalles de Router Transaccional" click eventNormalizer nodeClickHandler "Ver detalles de Normalizador de Webhooks" click providerPort nodeClickHandler "Ver detalles de MessagingProvider Interface" click kapsoAdapter nodeClickHandler "Ver detalles de KapsoAdapter" click metaOnboard nodeClickHandler "Ver detalles de Meta Embedded Signup" click broadcastEngine nodeClickHandler "Ver detalles de Colas Masivas Kapso"

LEYENDA: Componente Innovia Puerto / Interface Acelerador Kapso Cliente Externo

MÓDULO DE DOMINIO

tenantCore

Tenants & Aislamiento de Identidad

Mantiene la representación propia e independiente de cada empresa cliente en PostgreSQL. Ningún tenant puede leer números, mensajes o campañas de otra organización.

Garantía de Soberanía / Anti Lock-in:

La identidad de la empresa y sus credenciales son 100% de Innovia. El ID de Kapso (provider_customer_id) es solo un dato secundario de interoperabilidad.

ARCHIVOS FUENTE ASOCIADOS:

src/modules/tenants/tenants.service.ts

src/database/schema.prisma (Model Tenant)

SNIPPET CLAVE DE IMPLEMENTACIÓN:

export async function getTenantScopedData(tenantId: string) {
  return prisma.campaign.findMany({
    where: { tenant_id: tenantId },
    include: { phone_number: true }
  });
}

EXPLORAR OTROS COMPONENTES: