Skip to Content
DecoCredit Docs
SuperAdmin de Plataforma

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:

Hyperframes AI Video
Rol: SuperAdmin / Infraestructura
00:00 / 00:16
https://admin.decocredit.si/tenants/nuevo
Alta de Nueva Entidad (Multi-Tenant)
Estado: Pendiente
Razón Social:Cooperativa Financiera Andina
Subdominio Dedicado:Generando...
Escribir Razón Social
[Locución de Escena]:El SuperAdmin ingresa al panel global de infraestructura y selecciona "+ Crear Nuevo 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:

Archify Process FlowArchify v2.4 Spec
Flujo de Aprovisionamiento & Aislamiento Multi-Tenant
Paso 1 de 4
clientSuperAdmin Web UI

Portal React 19

● Origen del Paso 1
gatewayAPI Gateway & Ingress

Nginx 1.31 + Certbot

● Destino del Paso 1
servicePlatform Core Service

Go / Node Orchestrator

databasePostgreSQL 16 DB

Schema Isolation + RLS

1
1. Petición de Creación
SuperAdmin Web UI → API Gateway & Ingress

SuperAdmin envía razón social, slug ("coopandina"), cuotas operativas y correo del administrador inicial.

Contrato / Payload de Transición:
{
  "name": "Coop Andina",
  "slug": "coopandina",
  "admin_email": "admin@coopandina.com"
}
Invariante Arquitectónica Obligatoria

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.si en 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 tenants con un tenant_id entero 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.si responde 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.

On this page