Aprovisionamiento de Tenant

Super Admin

Total Tenants

Activos

Borradores

Suspendidos

4 tenants registrados

Razón Social	Slug	NIT	Estado	Activación
SE Secretaría de Educación de Cundinamarca Gobernación de Cundinamarca	`sec-ed-cundinamarca`	899.999.227-5	Activo	15 mar 2026
IT IE Técnica Industrial de Pereira Pestaña 1 completa — resto pendiente	`ie-tecnica-pereira`	891.480.038-1	Borrador	—
FC Fundación Cultural Bogotá Asociación sin ánimo de lucro	`fund-cultural-bogota`	800.142.872-4	Suspendido	10 ene 2026
AC Alcaldía Municipal de Chía Municipio de Cundinamarca	`alcaldia-chia`	899.999.341-2	Activo	02 abr 2026

      Módulo: sa_aprovisionamiento_tenant  | 
      Paso: 1 — Creación y activación de tenant  | 
      Generado: 2026-06-23
    
-- ────────────────────────────────────────────
-- TABLA: tenants
-- ────────────────────────────────────────────

          Columna
          Tipo
          Restricciones / Default
          Notas
        
      — Identidad —

          id
          UUID STORAGE PLAIN
          PRIMARY KEY DEFAULT gen_random_uuid()
          
          slug
          VARCHAR(100)
          NOT NULL UNIQUE
          Inmutable tras primer guardado. Auto-generado desde legal_name.
        
— Datos legales —

          legal_name
          VARCHAR(200)
          NOT NULL
          
          trade_name
          VARCHAR(150)
          
          Nombre comercial, opcional.
        
          doc_type
          VARCHAR(20)
          NOT NULL CHECK IN ('NIT','CC','Pasaporte')
          
          doc_number
          VARCHAR(20)
          NOT NULL
          
          dv
          VARCHAR(2)
          
          Dígito de verificación NIT.
        
          tax_regime
          VARCHAR(30)
          
          Régimen tributario.
        
— Ubicación —

          country
          VARCHAR(100)
          DEFAULT 'Colombia'
          
          department
          VARCHAR(100)
          
          municipality
          VARCHAR(100)
          
          addr_street_type
          VARCHAR(30)
          
          Ej: Calle, Carrera, Avenida.
        
          addr_street_number
          VARCHAR(10)
          
          addr_plate1
          VARCHAR(10)
          
          addr_plate2
          VARCHAR(10)
          
          addr_neighborhood
          VARCHAR(100)
          
          addr_complement
          VARCHAR(200)
          
          postal_code
          VARCHAR(10)
          
          addr_formatted
          TEXT
          
          Dirección ensamblada. Calculada en backend al guardar.
        
— Configuración comercial —

          plan
          VARCHAR(150)
          
          Campo libre por ahora. Catálogo de planes es fuera de alcance.
        
          activation_date
          DATE
          
          Fecha contractual de inicio. Distinta de activated_at.
        
          expiration_date
          DATE
          
          Fecha contractual de vencimiento.
        
          currency
          VARCHAR(10)
          DEFAULT 'COP'
          
          timezone
          VARCHAR(50)
          DEFAULT 'America/Bogota'
          
— Branding —

          logo_left
          VARCHAR(500)
          
          URL o path del logo izquierdo.
        
          logo_center
          VARCHAR(500)
          
          logo_right
          VARCHAR(500)
          
— Estado y auditoría —

          status
          VARCHAR(20)
          NOT NULL DEFAULT 'draft' CHECK IN ('draft','active','suspended','archived')
          
          activated_at
          TIMESTAMPTZ STORAGE PLAIN
          
          NULL hasta que se activa.
        
          activated_by
          UUID STORAGE PLAIN
          REFERENCES users(id)
          SA que ejecutó la activación.
        
          suspended_at
          TIMESTAMPTZ STORAGE PLAIN
          
          NULL si no está suspendido.
        
          suspended_by
          UUID STORAGE PLAIN
          REFERENCES users(id)
          AGREGADO — faltaba en especificaciones. SA que suspendió.
        
          reactivated_at
          TIMESTAMPTZ STORAGE PLAIN
          
          AGREGADO — necesario para trazabilidad de reactivaciones.
        
          reactivated_by
          UUID STORAGE PLAIN
          REFERENCES users(id)
          AGREGADO — SA que ejecutó la reactivación.
        
          archived_at
          TIMESTAMPTZ STORAGE PLAIN
          
          Soft delete. NULL si no está archivado.
        
          created_at
          TIMESTAMPTZ STORAGE PLAIN
          NOT NULL DEFAULT now()
          
          updated_at
          TIMESTAMPTZ STORAGE PLAIN
          
          created_by
          UUID STORAGE PLAIN
          NOT NULL REFERENCES users(id)
          
          updated_by
          UUID STORAGE PLAIN
          REFERENCES users(id)
          
    -- ────────────────────────────────────────────
-- TABLA: tenant_phones
-- ────────────────────────────────────────────

          Columna
          Tipo
          Restricciones / Default
          Notas
        
          id
          UUID STORAGE PLAIN
          PRIMARY KEY DEFAULT gen_random_uuid()
          
          tenant_id
          UUID STORAGE PLAIN
          NOT NULL REFERENCES tenants(id) ON DELETE CASCADE
          
          country_code
          VARCHAR(10)
          DEFAULT '+57'
          
          phone_type
          VARCHAR(10)
          DEFAULT 'movil'
          Valores: movil, fijo, fax.
        
          number
          VARCHAR(20)
          NOT NULL
          
          extension
          VARCHAR(10)
          
          Solo aplica a tipo fijo.
        
          is_primary
          BOOLEAN
          DEFAULT FALSE
          Solo un teléfono puede ser principal. Regla de negocio en backend.
        
    -- ────────────────────────────────────────────
-- TABLA: tenant_emails
-- ────────────────────────────────────────────

          Columna
          Tipo
          Restricciones / Default
          Notas
        
          id
          UUID STORAGE PLAIN
          PRIMARY KEY DEFAULT gen_random_uuid()
          
          tenant_id
          UUID STORAGE PLAIN
          NOT NULL REFERENCES tenants(id) ON DELETE CASCADE
          
          email
          VARCHAR(200)
          NOT NULL
          Debe ser único en toda la plataforma (check cross-tenant en el email del admin).
        
          is_primary
          BOOLEAN
          DEFAULT FALSE
          Solo un email puede ser principal. Regla de negocio en backend.
        
    -- ────────────────────────────────────────────
-- TABLA: tenant_document_sequences
-- ────────────────────────────────────────────

          Columna
          Tipo
          Restricciones / Default
          Notas
        
          id
          UUID STORAGE PLAIN
          PRIMARY KEY DEFAULT gen_random_uuid()
          
          tenant_id
          UUID STORAGE PLAIN
          NOT NULL REFERENCES tenants(id)
          Sin CASCADE — las secuencias deben preservarse aunque se archive el tenant.
        
          doc_type
          VARCHAR(10)
          NOT NULL
          Ej: FAC, ND, NC, OC. Definido en activación.
        
          next_number
          BIGINT
          NOT NULL DEFAULT 1
          Incrementado por el backend en cada emisión de documento.
        
          prefix
          VARCHAR(10)
          
          Prefijo opcional. Ej: "FAC-2026-".
        
          UNIQUE (tenant_id, doc_type)
        
    -- ────────────────────────────────────────────
-- CAMPOS ESTÁNDAR NO APLICADOS — justificación
-- ────────────────────────────────────────────

          Campo estándar
          Tabla afectada
          Justificación de exclusión
        
          tenant_id
          tenants, tenant_phones, tenant_emails, tenant_document_sequences
          La tabla tenants ES el catálogo base del sistema; no pertenece a ningún tenant. Las tablas hijas referencian tenant_id como FK de negocio, no como discriminador multi-tenant.
        
          origin_id / origin
          todas
          Los tenants son entidades nativas del sistema; no se importan desde fuentes externas. No hay escenario de integración de datos en este módulo.
        
          status_id
          tenant_phones, tenant_emails, tenant_document_sequences
          Las tablas hijas no tienen ciclo de vida propio. La activación/suspensión/archivo se gestiona únicamente en la tabla tenants padre. Aplicar status_id en hijas sería complejidad sin valor funcional.
        
          created_by / updated_by / created_at / updated_at
          tenant_phones, tenant_emails, tenant_document_sequences
          Las tablas hijas no tienen auditoría independiente. Los cambios en teléfonos y emails se rastrean a través del updated_by/updated_at del tenant padre. Las secuencias de documentos se generan automáticamente en activación, sin acción de usuario directa.
        
      Columnas en verde = agregadas durante análisis de vacíos (2026-06-23). No estaban en el API_ENDPOINTS.md original.

Aprovisionamiento de Tenant

Nuevo Tenant

Información general

Contacto

Configuración comercial

Identidad visual

Revisión y activación

Confirmar activación

Columna	Tipo	Restricciones / Default	Notas
— Identidad —
id	UUID STORAGE PLAIN	PRIMARY KEY DEFAULT gen_random_uuid()
slug	VARCHAR(100)	NOT NULL UNIQUE	Inmutable tras primer guardado. Auto-generado desde legal_name.
— Datos legales —
legal_name	VARCHAR(200)	NOT NULL
trade_name	VARCHAR(150)		Nombre comercial, opcional.
doc_type	VARCHAR(20)	NOT NULL CHECK IN ('NIT','CC','Pasaporte')
doc_number	VARCHAR(20)	NOT NULL
dv	VARCHAR(2)		Dígito de verificación NIT.
tax_regime	VARCHAR(30)		Régimen tributario.
— Ubicación —
country	VARCHAR(100)	DEFAULT 'Colombia'
department	VARCHAR(100)
municipality	VARCHAR(100)
addr_street_type	VARCHAR(30)		Ej: Calle, Carrera, Avenida.
addr_street_number	VARCHAR(10)
addr_plate1	VARCHAR(10)
addr_plate2	VARCHAR(10)
addr_neighborhood	VARCHAR(100)
addr_complement	VARCHAR(200)
postal_code	VARCHAR(10)
addr_formatted	TEXT		Dirección ensamblada. Calculada en backend al guardar.
— Configuración comercial —
plan	VARCHAR(150)		Campo libre por ahora. Catálogo de planes es fuera de alcance.
activation_date	DATE		Fecha contractual de inicio. Distinta de activated_at.
expiration_date	DATE		Fecha contractual de vencimiento.
currency	VARCHAR(10)	DEFAULT 'COP'
timezone	VARCHAR(50)	DEFAULT 'America/Bogota'
— Branding —
logo_left	VARCHAR(500)		URL o path del logo izquierdo.
logo_center	VARCHAR(500)
logo_right	VARCHAR(500)
— Estado y auditoría —
status	VARCHAR(20)	NOT NULL DEFAULT 'draft' CHECK IN ('draft','active','suspended','archived')
activated_at	TIMESTAMPTZ STORAGE PLAIN		NULL hasta que se activa.
activated_by	UUID STORAGE PLAIN	REFERENCES users(id)	SA que ejecutó la activación.
suspended_at	TIMESTAMPTZ STORAGE PLAIN		NULL si no está suspendido.
suspended_by	UUID STORAGE PLAIN	REFERENCES users(id)	AGREGADO — faltaba en especificaciones. SA que suspendió.
reactivated_at	TIMESTAMPTZ STORAGE PLAIN		AGREGADO — necesario para trazabilidad de reactivaciones.
reactivated_by	UUID STORAGE PLAIN	REFERENCES users(id)	AGREGADO — SA que ejecutó la reactivación.
archived_at	TIMESTAMPTZ STORAGE PLAIN		Soft delete. NULL si no está archivado.
created_at	TIMESTAMPTZ STORAGE PLAIN	NOT NULL DEFAULT now()
updated_at	TIMESTAMPTZ STORAGE PLAIN
created_by	UUID STORAGE PLAIN	NOT NULL REFERENCES users(id)
updated_by	UUID STORAGE PLAIN	REFERENCES users(id)

Columna	Tipo	Restricciones / Default	Notas
id	UUID STORAGE PLAIN	PRIMARY KEY DEFAULT gen_random_uuid()
tenant_id	UUID STORAGE PLAIN	NOT NULL REFERENCES tenants(id) ON DELETE CASCADE
country_code	VARCHAR(10)	DEFAULT '+57'
phone_type	VARCHAR(10)	DEFAULT 'movil'	Valores: movil, fijo, fax.
number	VARCHAR(20)	NOT NULL
extension	VARCHAR(10)		Solo aplica a tipo fijo.
is_primary	BOOLEAN	DEFAULT FALSE	Solo un teléfono puede ser principal. Regla de negocio en backend.

Campo estándar	Tabla afectada	Justificación de exclusión
tenant_id	tenants, tenant_phones, tenant_emails, tenant_document_sequences	La tabla tenants ES el catálogo base del sistema; no pertenece a ningún tenant. Las tablas hijas referencian tenant_id como FK de negocio, no como discriminador multi-tenant.
origin_id / origin	todas	Los tenants son entidades nativas del sistema; no se importan desde fuentes externas. No hay escenario de integración de datos en este módulo.
status_id	tenant_phones, tenant_emails, tenant_document_sequences	Las tablas hijas no tienen ciclo de vida propio. La activación/suspensión/archivo se gestiona únicamente en la tabla tenants padre. Aplicar status_id en hijas sería complejidad sin valor funcional.
created_by / updated_by / created_at / updated_at	tenant_phones, tenant_emails, tenant_document_sequences	Las tablas hijas no tienen auditoría independiente. Los cambios en teléfonos y emails se rastrean a través del updated_by/updated_at del tenant padre. Las secuencias de documentos se generan automáticamente en activación, sin acción de usuario directa.