# Portal de Administración SaaS - Especificación Completa

**Versión:** 1.0
**Fecha:** 2025-11-17
**Modelo:** SaaS Multi-tenant B2B

---

## 📋 Resumen Ejecutivo

El Portal de Administración SaaS es el centro de control de la plataforma multi-tenant, permitiendo gestionar tenants, usuarios, módulos, facturación y métricas del negocio desde una interfaz centralizada.

**Usuarios objetivo:**
- **Super Admin**: Administrador de la plataforma (equipo interno)
- **Tenant Admin**: Administrador de empresa cliente
- **Support**: Equipo de soporte técnico
- **Billing**: Equipo de facturación y cobranza

---

## 🎯 Roles y Permisos

### Super Admin (Plataforma)

**Acceso completo a:**
- ✅ Gestión de todos los tenants (crear, editar, suspender, cancelar)
- ✅ Configuración global de la plataforma
- ✅ Feature flags y experimentos A/B
- ✅ Métricas de negocio (MRR, ARR, churn)
- ✅ Logs y auditoría de todos los tenants
- ✅ Configuración de pricing y planes
- ✅ Gestión de marketplace (aprobar extensiones)

**Dashboard principal:**
```
┌─────────────────────────────────────────────────────────────┐
│  Super Admin Dashboard                                       │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  📊 Métricas Clave (Últimos 30 días)                        │
│  ┌────────────┬────────────┬────────────┬────────────┐     │
│  │  Tenants   │    MRR     │   Churn    │  Nuevos    │     │
│  │    234     │  $156,780  │    2.3%    │    28      │     │
│  │   +12%     │    +8.5%   │   -0.5%    │    +4      │     │
│  └────────────┴────────────┴────────────┴────────────┘     │
│                                                              │
│  📈 Crecimiento MRR                                         │
│  [Gráfica de línea - últimos 12 meses]                     │
│                                                              │
│  🔥 Alertas Críticas                                        │
│  • 3 tenants en riesgo de churn (NPS < 30)                 │
│  • 5 tenants excediendo límites de uso                     │
│  • 2 incidentes de seguridad en las últimas 24h           │
│                                                              │
│  📋 Últimas Acciones                                        │
│  • Tenant "constructora-abc" actualizado a Enterprise      │
│  • Feature "ai_risk_prediction" activado para 10 tenants   │
│  • Extension "SAP Connector v2.0" aprobada en marketplace  │
│                                                              │
└─────────────────────────────────────────────────────────────┘
```

---

### Tenant Admin (Cliente)

**Acceso limitado a su tenant:**
- ✅ Gestión de usuarios de su empresa
- ✅ Configuración de módulos activados (según plan)
- ✅ Personalización (branding, workflows)
- ✅ Reportes de uso de su tenant
- ✅ Facturación y métodos de pago
- ✅ Extensiones instaladas
- ❌ NO puede ver otros tenants
- ❌ NO puede modificar pricing

**Dashboard del tenant:**
```
┌─────────────────────────────────────────────────────────────┐
│  Constructora ABC - Admin Dashboard                         │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  📊 Uso del Sistema (Últimos 30 días)                       │
│  ┌────────────┬────────────┬────────────┬────────────┐     │
│  │  Usuarios  │  Proyectos │  Módulos   │    Uso     │     │
│  │   18/25    │     12     │   10/12    │    78%     │     │
│  └────────────┴────────────┴────────────┴────────────┘     │
│                                                              │
│  💳 Suscripción Actual                                      │
│  Plan: Profesional ($799/mes)                               │
│  Add-ons: RRHH ($100/mes), INFONAVIT ($75/mes)             │
│  Total: $974/mes                                            │
│  Próxima factura: 2025-12-01 ($974 USD)                    │
│  [Actualizar Plan] [Agregar Módulos]                       │
│                                                              │
│  👥 Usuarios (18/25)                                        │
│  [+ Invitar Usuario]  [Gestionar Roles]                    │
│                                                              │
│  ⚙️ Módulos Activos (10/12)                                │
│  ✅ Proyectos  ✅ Presupuestos  ✅ Compras  ✅ Control     │
│  ✅ RRHH  ✅ Estimaciones  ✅ CRM  ✅ INFONAVIT            │
│  ⚪ Calidad ($50/mes) [Activar]                            │
│  ⚪ Contratos ($75/mes) [Activar]                          │
│                                                              │
└─────────────────────────────────────────────────────────────┘
```

---

### Support (Equipo de Soporte)

**Acceso de solo lectura:**
- ✅ Ver datos de cualquier tenant (para troubleshooting)
- ✅ Ver logs y errores
- ✅ Ejecutar queries de diagnóstico
- ❌ NO puede modificar datos de tenants
- ❌ NO puede suspender/cancelar tenants
- ✅ Puede crear tickets internos
- ✅ Puede ver historial de soporte del tenant

---

### Billing (Facturación)

**Acceso específico:**
- ✅ Ver uso y facturación de todos los tenants
- ✅ Generar facturas manualmente
- ✅ Suspender tenants por falta de pago
- ✅ Aplicar descuentos y créditos
- ❌ NO puede modificar funcionalidad
- ✅ Exportar reportes contables

---

## 🏗️ Funcionalidades del Portal

### 1. Gestión de Tenants

#### 1.1 Listado de Tenants

**Vista principal:**
```
┌──────────────────────────────────────────────────────────────────────────────┐
│  Tenants (234 total)                                       [+ Nuevo Tenant]  │
├──────────────────────────────────────────────────────────────────────────────┤
│  🔍 Buscar: [________________]  Filtros: [Plan ▼] [Estado ▼] [Región ▼]   │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  Tenant          Plan          Usuarios  Módulos  Estado      MRR    Acción│
│  ──────────────  ────────────  ────────  ───────  ─────────  ──────  ──────│
│  🏢 const-abc    Enterprise    45/50     15/18    🟢 Activo  $1,500  ⚙️📊📧│
│  🏢 viviendas    Profesional   18/25     10/18    🟢 Activo  $750   ⚙️📊📧│
│  🏢 obras-norte  Básico        8/10      6/18     🟡 Prueba  $0     ⚙️📊📧│
│  🏢 desarr-sur   Enterprise    12/100    18/18    🔴 Susp.   $2,000  ⚙️📊📧│
│  🏢 edificios    Profesional   22/25     12/18    🟢 Activo  $899   ⚙️📊📧│
│  ...                                                                         │
│                                                                              │
│  Mostrando 1-5 de 234  [< 1 2 3 ... 47 >]                                  │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

⚙️ = Configurar  📊 = Analytics  📧 = Contactar
```

**Filtros avanzados:**
- Por plan (Básico, Profesional, Enterprise)
- Por estado (Activo, Trial, Suspendido, Cancelado)
- Por región/país
- Por fecha de creación
- Por MRR (rango)
- Por uso (% de capacidad)
- Por riesgo de churn (NPS score)

#### 1.2 Onboarding de Nuevo Tenant

**Wizard de 5 pasos:**

**Paso 1: Información de Empresa**
```
┌─────────────────────────────────────────────────┐
│  Nuevo Tenant - Paso 1/5: Información Empresa  │
├─────────────────────────────────────────────────┤
│                                                 │
│  Nombre Empresa: [_____________________________]│
│  RFC/Tax ID:     [_____________________________]│
│  Industria:      [Construcción Residencial ▼]  │
│  Tamaño:         [ ] <10  [x] 10-50  [ ] 50-100│
│  País:           [México ▼]                     │
│  Zona Horaria:   [America/Mexico_City ▼]       │
│                                                 │
│               [Cancelar]  [Siguiente >]         │
└─────────────────────────────────────────────────┘
```

**Paso 2: Subdominio y Admin**
```
┌─────────────────────────────────────────────────┐
│  Nuevo Tenant - Paso 2/5: Acceso               │
├─────────────────────────────────────────────────┤
│                                                 │
│  Subdominio:                                    │
│  [constructora-abc].erp-construccion.com        │
│  ✅ Disponible                                  │
│                                                 │
│  Administrador Principal:                       │
│  Nombre:  [Juan Pérez________________________]  │
│  Email:   [admin@constructora-abc.com_______]  │
│  Teléfono: [+52 442 123 4567________________]  │
│                                                 │
│               [< Anterior]  [Siguiente >]       │
└─────────────────────────────────────────────────┘
```

**Paso 3: Selección de Plan**
```
┌─────────────────────────────────────────────────────────────────┐
│  Nuevo Tenant - Paso 3/5: Plan de Suscripción                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐                 │
│  │  BÁSICO   │  │PROFESIONAL│  │ ENTERPRISE│                 │
│  │  $399/mes │  │  $799/mes │  │$1,499/mes │                 │
│  ├───────────┤  ├───────────┤  ├───────────┤                 │
│  │10 usuarios│  │25 usuarios│  │100 usuario│  ← Seleccionado│
│  │ 6 módulos │  │12 módulos │  │18 módulos │                 │
│  │  10 GB    │  │   50 GB   │  │  200 GB   │                 │
│  │Email 48h  │  │Chat 24h   │  │Dedic. 4h  │                 │
│  │           │  │           │  │           │                 │
│  │[Elegir]   │  │[Elegir]   │  │[✓Elegido] │                 │
│  └───────────┘  └───────────┘  └───────────┘                 │
│                                                                 │
│  ☑️ Trial de 14 días (sin cargo)                              │
│  ☐ Facturación anual (15% descuento)                          │
│                                                                 │
│               [< Anterior]  [Siguiente >]                       │
└─────────────────────────────────────────────────────────────────┘
```

**Paso 4: Módulos Add-on** (si aplica)
```
┌─────────────────────────────────────────────────┐
│  Nuevo Tenant - Paso 4/5: Módulos Adicionales  │
├─────────────────────────────────────────────────┤
│                                                 │
│  Módulos incluidos en Plan Enterprise: (18)    │
│  ✅ Todos los módulos core                     │
│  ✅ Todos los módulos enterprise               │
│  ✅ HSE + IA predictiva                        │
│                                                 │
│  ¿Desea agregar servicios adicionales?         │
│                                                 │
│  ☐ Modelo ML custom (+$100/mes)                │
│     Modelo de IA personalizado con datos propios│
│                                                 │
│  ☐ Usuarios adicionales (+$10 c/u)             │
│     Agregar más de 100 usuarios: [____] users  │
│                                                 │
│  ☐ Almacenamiento adicional (+$2/GB)           │
│     Agregar más de 200 GB: [____] GB           │
│                                                 │
│               [< Anterior]  [Siguiente >]       │
└─────────────────────────────────────────────────┘
```

**Paso 5: Confirmación y Provisioning**
```
┌─────────────────────────────────────────────────┐
│  Nuevo Tenant - Paso 5/5: Confirmación         │
├─────────────────────────────────────────────────┤
│                                                 │
│  Resumen:                                       │
│  ────────────────────────────────────────       │
│  Empresa: Constructora ABC SA de CV            │
│  Subdominio: constructora-abc                   │
│  Plan: Enterprise                               │
│  Admin: admin@constructora-abc.com              │
│                                                 │
│  Costo mensual:                                 │
│  - Plan Enterprise:        $1,499/mes           │
│  - Usuarios extra (0):        $0/mes            │
│  - Almacenamiento (0):        $0/mes            │
│  ─────────────────────────────────────          │
│  Total:                    $1,499/mes           │
│                                                 │
│  Trial: 14 días gratis                          │
│  Primera factura: 2025-12-01                    │
│                                                 │
│  ☑️ He leído y acepto los Términos de Servicio │
│                                                 │
│        [< Anterior]  [Crear Tenant]             │
└─────────────────────────────────────────────────┘
```

**Al hacer clic en "Crear Tenant":**
```
┌─────────────────────────────────────────────────┐
│  ⏳ Provisionando Tenant...                     │
├─────────────────────────────────────────────────┤
│                                                 │
│  ✅ Creando registro en tabla constructoras     │
│  ✅ Generando UUID único                        │
│  ⏳ Creando usuario admin... (2s)               │
│  ⏳ Vinculando usuario a constructora...        │
│  ⏳ Activando módulos (18)...                   │
│  ⏳ Configurando subdomain DNS...               │
│  ⏳ Generando datos seed (catálogos)...         │
│  ⏳ Generando datos demo...                     │
│  ⏳ Enviando email de bienvenida...             │
│                                                 │
│  Progreso: ████████████░░░░░░░ 65%             │
│                                                 │
└─────────────────────────────────────────────────┘
```

**Confirmación final:**
```
┌─────────────────────────────────────────────────┐
│  ✅ Tenant Creado Exitosamente!                 │
├─────────────────────────────────────────────────┤
│                                                 │
│  El tenant "Constructora ABC" ha sido          │
│  provisionado correctamente.                    │
│                                                 │
│  URL de acceso:                                 │
│  https://constructora-abc.erp-construccion.com  │
│                                                 │
│  Credenciales enviadas a:                       │
│  admin@constructora-abc.com                     │
│                                                 │
│  Estado: Trial (14 días)                        │
│  Expira: 2025-12-01                             │
│                                                 │
│        [Ver Tenant]  [Volver al Listado]        │
└─────────────────────────────────────────────────┘
```

---

### 2. Configuración de Tenant

#### 2.1 Información General

```
┌─────────────────────────────────────────────────────────────┐
│  Tenant: Constructora ABC - Configuración                  │
├─────────────────────────────────────────────────────────────┤
│  [General] [Módulos] [Usuarios] [Facturación] [Seguridad]  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  📝 Información de Empresa                                 │
│  ────────────────────────────────────────────              │
│  Nombre:         [Constructora ABC SA de CV___________]    │
│  RFC:            [CABC850101AAA_______________________]    │
│  Dirección:      [Av. Constituyentes 123_____________]    │
│  Ciudad:         [Querétaro________________________]       │
│  País:           [México ▼]                                │
│  Zona Horaria:   [America/Mexico_City ▼]                   │
│  Idioma:         [Español (México) ▼]                      │
│  Moneda:         [MXN - Peso Mexicano ▼]                   │
│                                                             │
│  🎨 Branding                                               │
│  ────────────────────────────────────────────              │
│  Logo:           [📁 Subir Logo] (actual: logo.png)        │
│  Color Primario: [#0066CC] 🎨                              │
│  Color Secundario: [#FF6600] 🎨                            │
│                                                             │
│  📧 Contactos                                              │
│  ────────────────────────────────────────────              │
│  Email Admin:    [admin@constructora-abc.com__________]    │
│  Email Soporte:  [soporte@constructora-abc.com________]    │
│  Teléfono:       [+52 442 123 4567___________________]     │
│                                                             │
│  🌐 Dominio Custom (opcional)                              │
│  ────────────────────────────────────────────              │
│  ☑️ Usar dominio personalizado                            │
│  Dominio:        [erp.constructora-abc.com____________]    │
│  Estado:         🟢 Verificado (DNS configurado)           │
│                                                             │
│                          [Guardar Cambios]                  │
└─────────────────────────────────────────────────────────────┘
```

#### 2.2 Gestión de Módulos

```
┌─────────────────────────────────────────────────────────────┐
│  Tenant: Constructora ABC - Módulos                        │
├─────────────────────────────────────────────────────────────┤
│  [General] [Módulos] [Usuarios] [Facturación] [Seguridad]  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  📦 Plan Actual: Enterprise ($1,499/mes)                   │
│  Módulos incluidos: 18 de 18  ✅ Todos activos            │
│                                                             │
│  ┌────────────────────────────────────────────────────┐   │
│  │ FASE 1: ALCANCE INICIAL                            │   │
│  ├────────────────────────────────────────────────────┤   │
│  │ ✅ MAI-001 Fundamentos         Incluido  [●]       │   │
│  │ ✅ MAI-002 Proyectos            Incluido  [●]       │   │
│  │ ✅ MAI-003 Presupuestos         Incluido  [●]       │   │
│  │ ✅ MAI-004 Compras              Incluido  [●]       │   │
│  │ ✅ MAI-005 Control de Obra      Incluido  [●]       │   │
│  │ ✅ MAI-006 Reportes             Incluido  [●]       │   │
│  │ ✅ MAI-007 RRHH                 Incluido  [●]       │   │
│  │ ✅ MAI-008 Estimaciones         Incluido  [●]       │   │
│  │ ✅ MAI-009 Calidad              Incluido  [●]       │   │
│  │ ✅ MAI-010 CRM                  Incluido  [●]       │   │
│  │ ✅ MAI-011 INFONAVIT            Incluido  [●]       │   │
│  │ ✅ MAI-012 Contratos            Incluido  [●]       │   │
│  │ ✅ MAI-013 Administración       Incluido  [●]       │   │
│  │ ✅ MAI-018 Preconstrucción      Incluido  [●]       │   │
│  └────────────────────────────────────────────────────┘   │
│                                                             │
│  ┌────────────────────────────────────────────────────┐   │
│  │ FASE 2: ENTERPRISE                                  │   │
│  ├────────────────────────────────────────────────────┤   │
│  │ ✅ MAE-014 Finanzas            Incluido  [●]       │   │
│  │ ✅ MAE-015 Activos             Incluido  [●]       │   │
│  │ ✅ MAE-016 DMS                 Incluido  [●]       │   │
│  └────────────────────────────────────────────────────┘   │
│                                                             │
│  ┌────────────────────────────────────────────────────┐   │
│  │ FASE 3: AVANZADA                                    │   │
│  ├────────────────────────────────────────────────────┤   │
│  │ ✅ MAA-017 HSE + IA            Incluido  [●]       │   │
│  │    ⚙️ Configuración IA: [Configurar Modelo ML]     │   │
│  │    📊 Status: Modelo entrenado (78% accuracy)      │   │
│  │    🔄 Próximo re-entrenamiento: 2025-12-01         │   │
│  └────────────────────────────────────────────────────┘   │
│                                                             │
│  🔌 Extensiones del Marketplace (3 instaladas)             │
│  ┌────────────────────────────────────────────────────┐   │
│  │ ✅ SAP S/4HANA Connector       $99/mes   [●]       │   │
│  │ ✅ WhatsApp Business API        Gratis    [●]       │   │
│  │ ✅ Reporte INFONAVIT EVC       $49 único  [●]       │   │
│  └────────────────────────────────────────────────────┘   │
│                                                             │
│  [Explorar Marketplace]                                    │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

### 3. Gestión de Usuarios

```
┌─────────────────────────────────────────────────────────────┐
│  Tenant: Constructora ABC - Usuarios (18/25)              │
├─────────────────────────────────────────────────────────────┤
│  [General] [Módulos] [Usuarios] [Facturación] [Seguridad]  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  [+ Invitar Usuario]  [Importar CSV]  [Exportar]          │
│                                                             │
│  🔍 Buscar: [________________]  Filtro: [Rol ▼] [Estado ▼]│
│                                                             │
│  Usuario          Email              Rol       Último Acc. │
│  ───────────────  ──────────────     ───────   ───────────│
│  👤 Juan Pérez    admin@const.com    Admin     Hace 2 hrs │
│  👤 María López   maria@const.com    Engineer  Hace 1 día │
│  👤 Pedro Mtez    pedro@const.com    Resident  Hace 3 hrs │
│  👤 Ana García    ana@const.com      Finance   Hace 5 hrs │
│  👤 Carlos Ruiz   carlos@const.com   Warehouse Nunca      │
│  ...                                                        │
│                                                             │
│  Mostrando 1-5 de 18                                       │
│                                                             │
│  ──────────────────────────────────────────────────────    │
│  Límite de usuarios: 18/25  (72% utilizado)                │
│  ¿Necesitas más usuarios? [Agregar 10 usuarios (+$100/mes)]│
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

### 4. Facturación y Pagos

```
┌─────────────────────────────────────────────────────────────┐
│  Tenant: Constructora ABC - Facturación                   │
├─────────────────────────────────────────────────────────────┤
│  [General] [Módulos] [Usuarios] [Facturación] [Seguridad]  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  💳 Suscripción Actual                                     │
│  ────────────────────────────────────────────              │
│  Plan: Enterprise                                           │
│  Precio base: $1,499/mes                                    │
│  Inicio: 2024-06-01                                         │
│  Próxima factura: 2025-12-01                                │
│  Estado: ✅ Activo                                         │
│                                                             │
│  📊 Desglose de Costos                                     │
│  ────────────────────────────────────────────              │
│  Plan Enterprise (100 usuarios):      $1,499/mes           │
│  Extensión SAP Connector:                $99/mes           │
│  Usuarios adicionales (0):                $0/mes           │
│  Almacenamiento adicional (0 GB):         $0/mes           │
│  ─────────────────────────────────────────────             │
│  Subtotal:                             $1,598/mes           │
│  Descuento anual (15%):                 -$240/mes           │
│  ─────────────────────────────────────────────             │
│  Total mensual:                        $1,358/mes           │
│  Total anual:                         $16,296/año           │
│                                                             │
│  [Cambiar Plan]  [Actualizar Módulos]                      │
│                                                             │
│  💰 Método de Pago                                         │
│  ────────────────────────────────────────────              │
│  💳 Visa •••• 1234  Exp: 12/26  ✅ Válida                 │
│  [Actualizar Tarjeta]  [Agregar Método de Pago]           │
│                                                             │
│  📄 Historial de Facturas                                  │
│  ────────────────────────────────────────────              │
│  Fecha         Concepto           Monto      Estado  PDF   │
│  ────────────  ─────────────────  ─────────  ──────  ────  │
│  2025-11-01    Suscripción Nov    $1,358 USD ✅ Pagado 📥 │
│  2025-10-01    Suscripción Oct    $1,358 USD ✅ Pagado 📥 │
│  2025-09-01    Suscripción Sep    $1,358 USD ✅ Pagado 📥 │
│  2025-08-01    Suscripción Ago    $1,358 USD ✅ Pagado 📥 │
│  ...                                                        │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

## 📊 Analytics y Métricas

### Dashboard de Métricas de Negocio (Super Admin)

```
┌─────────────────────────────────────────────────────────────┐
│  Analytics - Métricas de Negocio                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  📈 KPIs Principales (Últimos 30 días)                     │
│  ┌─────────────────────────────────────────────────────┐  │
│  │  MRR          ARR         Churn    CAC     LTV      │  │
│  │  $156,780    $1,881,360    2.3%   $1,250  $18,000  │  │
│  │  +8.5% ↑     +8.5% ↑      -0.5% ↓ -5% ↓   +12% ↑   │  │
│  └─────────────────────────────────────────────────────┘  │
│                                                             │
│  📊 Crecimiento MRR (Últimos 12 meses)                     │
│  [Gráfica de barras apiladas - por plan]                   │
│   $180K ┤                                           ██████ │
│   $160K ┤                                     ████████████ │
│   $140K ┤                               ████████████████ │
│   $120K ┤                         ████████████████████   │
│   $100K ┤                   ████████████████████████     │
│    $80K ┤             ████████████████████████████       │
│    $60K ┤       ████████████████████████████             │
│    $40K ┤ ████████████████████████████                   │
│         └┬────┬────┬────┬────┬────┬────┬────┬────┬───    │
│          Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec  │
│                                                             │
│  Legend: ██ Básico  ██ Profesional  ██ Enterprise         │
│                                                             │
│  📉 Churn Rate (por cohorte)                               │
│  Mes 1: 5%   Mes 3: 3%   Mes 6: 2%   Mes 12: 1%          │
│                                                             │
│  🎯 Activación Rate (primeros 7 días)                      │
│  85% de nuevos tenants activan ≥3 módulos                 │
│  92% suben ≥1 proyecto                                     │
│  78% invitan ≥3 usuarios                                   │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

## 🔒 Seguridad y Compliance

### Configuración de Seguridad (Tenant Admin)

```
┌─────────────────────────────────────────────────────────────┐
│  Tenant: Constructora ABC - Seguridad                      │
├─────────────────────────────────────────────────────────────┤
│  [General] [Módulos] [Usuarios] [Facturación] [Seguridad]  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  🔐 Autenticación                                          │
│  ────────────────────────────────────────────              │
│  ☑️ Requerir 2FA para todos los usuarios                  │
│  ☑️ Forzar cambio de contraseña cada 90 días              │
│  ☑️ Política de contraseñas fuertes                       │
│      • Mínimo 12 caracteres                                │
│      • Incluir mayúsculas, minúsculas, números y símbolos │
│  ☐ Permitir login con Google Workspace                     │
│  ☐ Permitir login con Microsoft 365                        │
│                                                             │
│  🌐 Control de Acceso                                      │
│  ────────────────────────────────────────────              │
│  ☑️ Restringir acceso por IP                              │
│     IPs permitidas:                                         │
│     • 201.123.45.0/24 (Oficina central)                   │
│     • 189.234.56.0/24 (Oficina regional)                  │
│     [+ Agregar IP]                                          │
│                                                             │
│  ☑️ Limitar sesiones concurrentes                         │
│     Máximo de sesiones por usuario: [3___]                 │
│                                                             │
│  📝 Audit Log                                              │
│  ────────────────────────────────────────────              │
│  ☑️ Registrar todos los cambios en datos sensibles        │
│  ☑️ Registrar intentos fallidos de login                  │
│  Retención de logs: [90 días ▼]                            │
│                                                             │
│  [Ver Audit Log Completo]                                  │
│                                                             │
│  🔒 Encriptación                                           │
│  ────────────────────────────────────────────              │
│  ✅ Datos en reposo: AES-256                              │
│  ✅ Datos en tránsito: TLS 1.3                            │
│  ✅ Backups encriptados                                    │
│                                                             │
│  📊 Compliance                                             │
│  ────────────────────────────────────────────              │
│  ✅ GDPR (Europa)                                          │
│  ✅ LFPDPPP (México)                                       │
│  ⏳ SOC 2 Type II (en proceso)                            │
│                                                             │
│                          [Guardar Cambios]                  │
└─────────────────────────────────────────────────────────────┘
```

---

## 🛠️ Soporte y Troubleshooting

### Panel de Soporte (Support Role)

```
┌─────────────────────────────────────────────────────────────┐
│  Soporte - Constructora ABC                                │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  🔍 Información del Tenant                                 │
│  ────────────────────────────────────────────              │
│  ID: f47ac10b-58cc-4372-a567-0e02b2c3d479                   │
│  Subdomain: constructora-abc                                │
│  Plan: Enterprise                                           │
│  Creado: 2024-06-01                                         │
│  Último acceso: Hace 2 horas                                │
│  Usuarios activos: 18/25                                    │
│  Proyectos: 12                                              │
│                                                             │
│  📊 Salud del Sistema                                      │
│  ────────────────────────────────────────────              │
│  ✅ API Response Time: 145ms (p95)                         │
│  ✅ Database Query Time: 78ms (p95)                        │
│  ✅ Uptime (30 días): 99.97%                               │
│  ⚠️ Storage Usage: 187 GB / 200 GB (93%)                   │
│                                                             │
│  🐛 Errores Recientes (últimas 24h)                        │
│  ────────────────────────────────────────────              │
│  • 3 errores 500 (Internal Server Error)                   │
│  • 12 errores 404 (Not Found)                              │
│  • 0 errores críticos                                       │
│  [Ver Logs Completos]                                       │
│                                                             │
│  🎫 Tickets de Soporte                                     │
│  ────────────────────────────────────────────              │
│  #12345 - No puedo exportar reportes (Abierto)            │
│  #12344 - Lentitud en módulo de presupuestos (Resuelto)   │
│  #12340 - Error al subir planos (Cerrado)                 │
│  [Ver Todos los Tickets]                                    │
│                                                             │
│  🔧 Acciones de Soporte                                    │
│  ────────────────────────────────────────────              │
│  [Impersonar Usuario] [Ejecutar Query] [Ver Logs]         │
│  [Limpiar Cache] [Reiniciar Jobs] [Generar Reporte]       │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

## 🔄 Ciclo de Vida del Tenant

### Estados y Transiciones

```
┌─────────────────────────────────────────────────────────────┐
│  Estado del Tenant: Constructora ABC                       │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Estado actual: 🟢 Activo                                  │
│                                                             │
│  Transiciones permitidas:                                   │
│  • → Suspendido (por falta de pago)                        │
│  • → Cancelado (a solicitud del cliente)                   │
│                                                             │
│  Historial de estados:                                      │
│  ────────────────────────────────────────────              │
│  2025-11-17  🟢 Activo         (actual)                    │
│  2024-06-15  🟢 Activo         (conversión de trial)       │
│  2024-06-01  🟡 Trial          (14 días)                   │
│  2024-06-01  ⚪ Registering    (onboarding)                │
│                                                             │
│  Métricas de retention:                                     │
│  ────────────────────────────────────────────              │
│  Días activo: 534 días                                      │
│  LTV actual: $23,256 USD                                    │
│  Churn risk: 🟢 Bajo (NPS: 78)                            │
│                                                             │
│  [Suspender Tenant] [Cancelar Tenant] [Reactivar]         │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

---

## 📱 Versión Móvil del Portal

El Portal de Administración SaaS tiene una versión móvil responsive para:
- Consultar métricas clave (MRR, tenants activos)
- Ver alertas críticas
- Aprobar/rechazar solicitudes de activación de módulos
- Responder tickets de soporte urgentes
- Ver estado de facturación

---

## 🚀 Próximas Funcionalidades (Roadmap)

**Q1 2026:**
- ✅ Gestión de tenants multi-región (US, LATAM, EU)
- ✅ A/B testing de features por cohorte
- ✅ Automated churn prediction (ML)

**Q2 2026:**
- 📋 White-label para partners
- 📋 Reseller management
- 📋 API pública para integraciones

**Q3 2026:**
- 📋 Self-service marketplace (partners suben extensiones)
- 📋 Automated compliance reporting (SOC2, ISO 27001)

---

**Generado:** 2025-11-17
**Sistema:** Portal de Administración SaaS Multi-tenant
**Versión:** 1.0
**Modelo:** B2B SaaS