Aprovisionamiento y Configuración de Tenants
Proceso paso a paso para dar de alta una nueva entidad financiera, aprovisionar bases de datos y configurar subdominios.
El aprovisionamiento de un nuevo Tenant en DecoCredit es una operación atómica que involucra la validación de identidad corporativa, la reserva de subdominio seguro con certificado TLS, la ejecución de migraciones DDL con políticas de Row Level Security (RLS) y la emisión de credenciales de acceso para el administrador de la entidad.
Video Interactivo de Simulación (Hyperframes)
Reproducí la siguiente simulación interactiva para observar el proceso completo de creación de un tenant desde la consola del SuperAdmin:
Alta de Nueva Entidad (Multi-Tenant)
Diagrama de Flujo Arquitectónico (Archify)
El siguiente diagrama ilustra los componentes que intervienen en el flujo de aprovisionamiento, desde el ingreso de datos hasta la emisión del certificado SSL:
Flujo de Aprovisionamiento & Aislamiento Multi-Tenant
Portal React 19
● Origen del Paso 1Nginx 1.31 + Certbot
● Destino del Paso 1Go / Node Orchestrator
Schema Isolation + RLS
1. Petición de Creación
SuperAdmin envía razón social, slug ("coopandina"), cuotas operativas y correo del administrador inicial.
{
"name": "Coop Andina",
"slug": "coopandina",
"admin_email": "admin@coopandina.com"
}Slug debe ser alfanumérico único en toda la plataforma global.
Procedimiento Operativo Detallado
1. Registro de Razón Social y NIT
En la consola de administración global (https://admin.decocredit.si/tenants/nuevo), el SuperAdmin digita:
- Razón Social de la Entidad: Nombre legal registrado en Cámara de Comercio (p. ej. Cooperativa Financiera Andina).
- NIT / Identificación Fiscal: Con dígito de verificación.
- Correo Electrónico del Administrador Institucional: Casilla donde se remitirá el enlace de activación seguro.
2. Reserva de Slug de Subdominio
El sistema valida la disponibilidad del identificador en tiempo real:
- Debe contener exclusivamente caracteres alfanuméricos en minúscula y guiones (
[a-z0-9-]). - Reserva el hostname
https://[slug].decocredit.sien el servidor DNS y en el proxy Nginx.
3. Aprovisionamiento de Tablas y Seguridad (RLS)
El orquestador de backend ejecuta las migraciones maestras:
- Registra el registro en la tabla
tenantscon untenant_identero secuencial único. - Habilita las políticas de Row Level Security (RLS) en las 24 tablas operativas del sistema (clientes, créditos, garantías, documentos, pagos, etc.).
- Aplica triggers de auditoría para registrar cada mutación con timestamp, IP de origen y usuario ejecutor.
4. Emisión de Credenciales de Activación
Se genera una clave de API maestra y un enlace de un solo uso (One-Time Token) con expiración a 24 horas, que se envía al correo del administrador del tenant para la configuración de su contraseña inicial.
Checklist de Verificación Post-Aprovisionamiento
- El subdominio
https://[slug].decocredit.siresponde con código HTTP 200 y certificado TLS válido. - La consulta de prueba con
SET app.current_tenant = '[tenant_id]'aísla correctamente los registros. - El usuario administrador inicial puede iniciar sesión y acceder al catálogo de configuración de productos.