erp-construccion/docs/00-vision-general/PORTAL-ADMIN-SAAS.md

750 lines
50 KiB
Markdown

# 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