erp-construccion/docs/00-vision-general/CAMBIOS-SAAS-MVP.md

# Cambios para Transformar MVP a Modelo SaaS

**Documento:** MVP-APP.md
**Versión actual:** 1.1 (Desarrollo a medida)
**Versión objetivo:** 2.0 (SaaS Multi-tenant)
**Fecha:** 2025-11-17

---

## 📋 Resumen de Cambios

Este documento detalla los cambios específicos que deben aplicarse al MVP-APP.md para transformarlo de un sistema de desarrollo a medida a una plataforma SaaS multi-tenant.

---

## 1. Resumen Ejecutivo (Sección 0)

### REEMPLAZAR:

```markdown
## 0) Resumen ejecutivo

Sistema **ERP de construcción enterprise-ready** para constructoras de vivienda en serie...
```

### POR:

```markdown
## 0) Resumen ejecutivo

**Plataforma SaaS ERP de construcción enterprise-ready** para constructoras de vivienda en serie que desarrollan conjuntos habitacionales (fraccionamientos, privadas, edificios) y participan en licitaciones y programas con INFONAVIT.

### Modelo de Negocio: SaaS Multi-tenant B2B

El sistema opera como **plataforma SaaS** donde:

✅ **Múltiples empresas constructoras** comparten la misma infraestructura (multi-tenant)
✅ **Módulos activables** según plan de suscripción (Básico/Profesional/Enterprise)
✅ **Portal de administración** para gestionar configuraciones, usuarios y módulos
✅ **Onboarding automatizado** en 5 minutos vs semanas de implementación tradicional
✅ **Marketplace de extensiones** para customizaciones sin modificar el core
✅ **Pricing por uso** con facturación automática mensual/anual

**Diferenciador clave:** Similar a SAP Cloud o Salesforce, pero especializado en construcción.

El sistema integra **18 módulos funcionales** activables por cliente, que cubren el ciclo completo desde preconstrucción hasta postventa, con capacidades comparables a ERPs líderes (SAP S/4HANA Construction, Procore, Autodesk Construction Cloud) pero con arquitectura moderna SaaS, onboarding rápido y menor TCO.
```

---

## 2. Nueva Sección: Arquitectura SaaS (Después de Sección 0)

### AGREGAR NUEVA SECCIÓN:

```markdown
## 0.1) Arquitectura SaaS Multi-tenant

> Ver documentación completa en [ARQUITECTURA-SAAS.md](./ARQUITECTURA-SAAS.md)

### Modelo Multi-tenant

**Un solo código base, múltiples clientes aislados:**

```
PostgreSQL Database
├── tenant_constructora_abc (Schema)
│   ├── projects
│   ├── budgets
│   ├── purchases
│   └── ...
├── tenant_viviendas_xyz (Schema)
│   ├── projects
│   ├── budgets
│   └── ...
└── tenant_obras_norte (Schema)
    └── ...
```

**Beneficios:**
- **Aislamiento fuerte**: Datos físicamente separados por schema
- **Escalabilidad**: De 10 a 10,000 tenants sin cambios arquitectónicos
- **Seguridad**: Imposible acceso cross-tenant
- **Performance**: No hay degradación con más tenants

### Portal de Administración SaaS

Dashboard central para gestionar:
- **Tenants**: Alta, configuración, suspensión, cancelación
- **Módulos**: Activación/desactivación dinámica por tenant
- **Usuarios**: Gestión de usuarios y roles por empresa
- **Facturación**: Generación automática de facturas, seguimiento de pagos
- **Métricas**: MRR, churn, activación, uso por módulo

### Onboarding Automatizado (5 minutos)

1. **Registro** (2 min): Datos de empresa, admin, subdominio
2. **Selección de plan** (1 min): Básico / Profesional / Enterprise
3. **Configuración de módulos** (1 min): Activar módulos deseados
4. **Provisioning automático** (<1 min): Schema creado, migraciones ejecutadas
5. **Primer login** (Inmediato): Sistema listo para usar

### Planes y Pricing

| Plan | Precio/mes | Usuarios | Módulos | Soporte |
|------|------------|----------|---------|---------|
| **Básico** | $399 USD | 10 | 6 core | Email 48h |
| **Profesional** | $799 USD | 25 | 12 módulos | Chat 24h |
| **Enterprise** | $1,499 USD | 100 | Todos (18) | Dedicado 4h |

**Add-ons disponibles:**
- Módulos adicionales: $50-$300/mes según complejidad
- Usuarios extra: $10-$20/usuario/mes según plan
- Almacenamiento: $2/GB/mes adicional

### Marketplace de Extensiones

Ecosistema de extensiones desarrolladas por:
- **Equipo interno**: Integraciones oficiales (SAP, WhatsApp, etc.)
- **Partners certificados**: Módulos verticales especializados
- **Clientes**: Custom workflows y reportes propios

**Tipos de extensiones:**
- Integraciones (APIs externas)
- Reportes custom
- Módulos verticales (ej: Obra Civil Pesada)
- Workflows personalizados
- Dashboards temáticos

### Personalización sin Modificar Core

**Configuración (90% de casos):**
- Catálogos personalizados
- Workflows de aprobación
- Plantillas de documentos
- Campos custom (metadata JSON)
- Reglas de negocio (rule engine)

**Extensiones (10% de casos):**
- SDK de desarrollo disponible
- Hooks en puntos clave del sistema
- API completa para integraciones
- Deploy aislado por tenant
```

---

## 3. Módulos (Sección 2)

### AGREGAR AL INICIO DE SECCIÓN 2:

```markdown
## 2) Módulos y funciones (detalle inicial)

### Activación de Módulos por Plan

Los módulos se activan/desactivan dinámicamente según el plan de suscripción del cliente:

**Plan Básico (6 módulos core):**
- MAI-001 Fundamentos ✅
- MAI-002 Proyectos ✅
- MAI-003 Presupuestos ✅
- MAI-004 Compras ✅
- MAI-005 Control de Obra ✅
- MAI-006 Reportes ✅

**Plan Profesional (12 módulos):**
- Incluye los 6 del plan Básico
- + MAI-007 RRHH (add-on $100/mes)
- + MAI-008 Estimaciones ✅
- + MAI-009 Calidad (add-on $50/mes)
- + MAI-010 CRM ✅
- + MAI-011 INFONAVIT (add-on $75/mes)
- + MAI-012 Contratos (add-on $75/mes)

**Plan Enterprise (18 módulos):**
- Incluye los 12 del plan Profesional
- + MAI-013 Administración ✅
- + MAI-018 Preconstrucción ✅
- + MAE-014 Finanzas (add-on $200/mes)
- + MAE-015 Activos (add-on $150/mes)
- + MAE-016 DMS (add-on $100/mes)
- + MAA-017 HSE + IA (add-on $300/mes)

**Cambio de plan:** El cliente puede upgradearse en cualquier momento desde su portal. Los módulos se activan instantáneamente.

> Aquí se baja a un nivel más operativo lo definido en 1A.
```

---

## 4. Arquitectura Técnica (Nueva Sección después de Módulos)

### AGREGAR NUEVA SECCIÓN:

```markdown
## 4) Arquitectura Técnica SaaS

### 4.1 Stack Tecnológico

**Backend:**
- Node.js 20+ + Express + TypeScript
- Multi-tenant architecture (schema-level isolation)
- Feature flags para rollout gradual
- Background jobs con Bull/BullMQ

**Frontend:**
- React 18 + Vite + TypeScript
- Tenant-aware routing
- Dynamic module loading (lazy loading por módulo)
- Branding personalizable por tenant

**Base de Datos:**
- PostgreSQL 15+ con schemas por tenant
- Connection pooling optimizado
- Automated migrations per tenant
- Point-in-time recovery per schema

**Infraestructura:**
- AWS/Azure/GCP (agnóstico)
- Kubernetes para orchestration
- Redis para caching y sessions
- S3/Blob Storage para archivos
- CloudFront/CDN para assets estáticos

### 4.2 Escalabilidad

**Horizontal Scaling:**
- API servers: Stateless, escalan horizontalmente
- Database: Read replicas, sharding por tenant (futuro)
- Cache: Redis cluster
- Storage: Object storage escalable

**Vertical Scaling:**
- Database: Upgrade de instancia según carga
- Tenants grandes: Schema dedicado en instancia separada (opcional)

**Performance Targets:**
- API response time: p95 <200ms
- Page load time: <2s
- Database query time: p95 <100ms
- Uptime: 99.9% (8.76 horas downtime/año)

### 4.3 Seguridad Multi-tenant

**Aislamiento de Datos:**
1. Schema-level isolation (primera capa)
2. Row-level security (segunda capa)
3. API-level validation (tercera capa)
4. Audit logging de accesos

**Prevención de Leaks:**
- Tenant resolver middleware obligatorio
- Guards en todos los endpoints
- Validación de tenant_id en queries
- Monitoreo de accesos anómalos

**Cumplimiento:**
- GDPR (Europa)
- LFPDPPP (México)
- SOC 2 Type II (roadmap)
- ISO 27001 (roadmap)

### 4.4 Despliegue y CI/CD

**Environments:**
- Development (local)
- Staging (pre-producción)
- Production (multi-region)

**Pipeline:**
```
Git Push → GitHub Actions
  ↓
Unit Tests → Integration Tests → E2E Tests
  ↓
Build Docker Images
  ↓
Deploy to Staging → Smoke Tests
  ↓
Manual Approval (para Production)
  ↓
Blue-Green Deployment → Health Checks
  ↓
Production Live
```

**Migrations:**
- Ejecutadas automáticamente en cada tenant
- Rollback automático si falla
- Dry-run en staging primero
- Notification a tenants afectados

### 4.5 Monitoreo y Observabilidad

**Métricas:**
- Application metrics (DataDog/New Relic)
- Business metrics (MRR, churn, activación)
- Infrastructure metrics (CPU, RAM, disk)
- Custom metrics por módulo

**Logs:**
- Centralized logging (ELK/Splunk)
- Structured logs (JSON)
- Log levels por environment
- Retention: 90 días production, 30 días staging

**Alerting:**
- PagerDuty para incidents críticos
- Slack para warnings
- Email para info
- Escalation policies definidas

**Dashboards:**
- StatusPage.io público (uptime)
- Grafana interno (métricas técnicas)
- Admin portal (métricas de negocio)
```

---

## 5. Roadmap (Actualizar Sección Existente)

### REEMPLAZAR:

```markdown
### Roadmap y tiempos

* **MVP Core (Fase 1)**: 6 semanas - Sistema operativo completo.
* **MVP + Enterprise (Fases 1-2)**: 12 semanas - Competitivo vs. ERPs medianos.
* **Sistema Completo (Fases 1-3)**: 18 semanas - Paridad con ERPs enterprise.
* **Optimización (Fase 4 opcional)**: 22 semanas - Features avanzadas (IoT, AR, ML).
```

### POR:

```markdown
### Roadmap y tiempos

**Fase 1: MVP SaaS (Semanas 1-8)**
- Arquitectura multi-tenant implementada
- Portal de administración básico
- Onboarding automatizado
- 6 módulos core activables
- Pricing y billing automatizado
- **Entregable**: Primeros 10 clientes piloto

**Fase 2: Enterprise Features (Semanas 9-16)**
- 12 módulos adicionales (total 18)
- Módulos activables dinámicamente
- Marketplace MVP (5 extensiones)
- SDK para extensiones
- Custom domains
- **Entregable**: 50 clientes activos, $40K MRR

**Fase 3: Scale & Growth (Semanas 17-24)**
- IA predictiva (HSE)
- Analytics avanzado por tenant
- Integraciones nativas (SAP, WhatsApp, CONTPAQi)
- Mobile app completa (React Native)
- API pública para partners
- **Entregable**: 200 clientes, $150K MRR

**Fase 4: Expansión (Semanas 25-36)**
- Marketplace público (50+ extensiones)
- White-label para partners
- Internacionalización (US, Colombia, Chile)
- Cumplimiento (SOC2, ISO 27001)
- Capacidades multi-region
- **Entregable**: 500 clientes, $400K MRR

**vs. Desarrollo desde cero**: 30-35 semanas (ahorro ~40% gracias a reutilización GAMILIT).
**vs. Desarrollo a medida tradicional**: Imposible escalar, cada cliente requiere deployment separado.
```

---

## 6. Ventajas Competitivas (Actualizar Sección 0)

### AGREGAR AL FINAL DE SECCIÓN 0:

```markdown
### Ventajas competitivas del modelo SaaS

1. **Time-to-value**: Cliente productivo en 5 minutos vs semanas de implementación.
2. **Pricing flexible**: Paga solo por lo que usa, puede upgradear/downgrear mensualmente.
3. **Actualizaciones automáticas**: Nuevas features sin costo adicional ni downtime.
4. **Escalabilidad instantánea**: Agregar usuarios/módulos en segundos.
5. **TCO menor**: No hay costos de infraestructura, mantenimiento, actualizaciones.
6. **Innovación continua**: Releases semanales con nuevas features y mejoras.
7. **Ecosystem**: Marketplace con extensiones de partners y comunidad.
8. **Multi-device**: Acceso desde web, móvil, tablet sin instalaciones.
9. **Seguridad enterprise**: Backups automáticos, disaster recovery, uptime 99.9%.
10. **Soporte incluido**: Según plan, desde email 48h hasta dedicado 1h.

### Comparación: SaaS vs On-Premise vs Desarrollo a Medida

| Aspecto | SaaS (Este Sistema) | On-Premise | Desarrollo a Medida |
|---------|---------------------|------------|---------------------|
| **Time-to-market** | 5 minutos | 3-6 meses | 12-18 meses |
| **Costo inicial** | $0 (solo suscripción) | $50K-$200K | $200K-$500K |
| **Costo mensual** | $399-$1,499/mes | $5K-$10K/mes (infra + soporte) | $10K-$20K/mes |
| **Actualizaciones** | Automáticas, gratis | Manual, costosas | Manual, muy costosas |
| **Escalabilidad** | Instantánea | Limitada (hardware) | Muy limitada |
| **Personalización** | Extensiones + config | Modificar core | Total |
| **Mantenimiento** | Incluido | Cliente responsable | Cliente responsable |
| **Uptime** | 99.9% (SLA) | Variable | Variable |
| **Soporte** | Incluido 24/7 | No incluido | No incluido |
| **ROI** | 3-6 meses | 18-24 meses | 24-36 meses |
```

---

## 7. Casos de Uso (Agregar Nueva Sección)

### AGREGAR NUEVA SECCIÓN:

```markdown
## 8) Casos de Uso SaaS

### Caso 1: Constructora Mediana (25 empleados)

**Perfil:**
- 3 proyectos simultáneos (150 viviendas/año)
- Facturación: $80M MXN/año
- Personal: 25 oficina + 150 campo

**Plan:** Profesional ($799/mes)
- 25 usuarios incluidos
- 12 módulos activados
- Add-ons: RRHH ($100/mes), INFONAVIT ($75/mes)
- **Total: $974/mes ($11,688/año)**

**ROI:**
- Antes (Excel + WhatsApp): Pérdida 5% por descontrol = $4M/año
- Después (ERP): Pérdida reducida a 1% = $800K/año
- **Ahorro: $3.2M/año**
- **ROI: 27,000% (recuperación en 1.3 meses)**

---

### Caso 2: Constructora Grande (100 empleados)

**Perfil:**
- 10 proyectos simultáneos (500 viviendas/año)
- Facturación: $300M MXN/año
- Personal: 100 oficina + 800 campo

**Plan:** Enterprise ($1,499/mes)
- 100 usuarios incluidos
- 18 módulos (todos)
- Add-ons: HSE IA ($300/mes), Finanzas ($200/mes)
- **Total: $1,999/mes ($23,988/año)**

**ROI:**
- Antes (ERP legacy costoso): $150K/año licencias + $50K/año mantenimiento = $200K/año
- Después (Este SaaS): $24K/año
- **Ahorro: $176K/año**
- **Además**: Mayor productividad, menos errores, decisiones data-driven

---

### Caso 3: Startup Constructora (5 empleados)

**Perfil:**
- 1 proyecto piloto (30 viviendas)
- Facturación: $15M MXN/año
- Personal: 5 oficina + 30 campo

**Plan:** Básico ($399/mes) + Trial 14 días gratis
- 10 usuarios incluidos
- 6 módulos core
- Sin add-ons inicialmente
- **Total: $399/mes ($4,788/año)**

**Ventaja:**
- Herramientas enterprise desde día 1
- Puede crecer agregando módulos
- Sin inversión inicial en tecnología
- Competir con constructoras grandes

---

### Caso 4: Extensión para Obra Civil Pesada

**Perfil:**
- Constructora especializada en puentes y carreteras
- Requiere funcionalidad específica no incluida en core

**Solución:** Extensión del Marketplace
- Plan Enterprise ($1,499/mes)
- + Extensión "Obra Civil Pesada" ($299/mes)
- **Total: $1,798/mes**

**Funcionalidad de extensión:**
- Gestión de tramos de carretera
- Control de acarreos y volúmenes
- Reportes para SCT
- Integración con laboratorio

**Desarrollo:** Partner certificado lo desarrolló usando el SDK, no modificó el core.
```

---

## 8. Migración de Clientes Existentes (Nueva Sección)

### AGREGAR NUEVA SECCIÓN:

```markdown
## 9) Migración de Clientes Existentes

### Si ya tienen un sistema legacy

**Proceso de migración:**

1. **Análisis de datos** (1 semana)
   - Auditoría de datos actuales
   - Identificación de datos críticos
   - Mapeo de campos
   - Limpieza de datos

2. **Setup de tenant** (1 día)
   - Onboarding estándar
   - Configuración inicial
   - Usuarios y permisos

3. **Migración de datos** (1-2 semanas)
   - Import de proyectos históricos
   - Import de catálogos
   - Import de transacciones
   - Validación de integridad

4. **Capacitación** (1 semana)
   - Training del equipo administrativo
   - Training del equipo de campo
   - Documentación personalizada
   - Soporte 1-1

5. **Go-live** (1 día)
   - Cutover del sistema legacy
   - Monitoreo intensivo
   - Soporte en sitio (opcional)

6. **Estabilización** (2 semanas)
   - Soporte prioritario
   - Ajustes de configuración
   - Resolución de incidencias

**Total tiempo de migración: 4-6 semanas**

**Costo de migración:**
- Plan Básico/Profesional: Incluido (datos <10K registros)
- Plan Enterprise: Incluido (datos <50K registros)
- Datos masivos: $0.10 USD/registro adicional
- Soporte on-site: $1,500 USD/día

### Si no tienen sistema

**Inicio desde cero:**
- Onboarding: 5 minutos
- Configuración inicial: 2 horas (catálogos, usuarios)
- Primer proyecto: 1 día
- **Productivos: < 1 semana**
```

---

## 9. Actualizar Sección de Comparación con Competidores

### AGREGAR COLUMNA "MODELO" EN TABLA:

```markdown
### Comparación con ERPs de mercado

| Característica | MVP-APP | SAP S/4HANA | Procore | Autodesk |
|----------------|---------|-------------|---------|----------|
| **Modelo** | **SaaS Multi-tenant** | On-Premise / Cloud | SaaS | SaaS |
| **Onboarding** | **5 minutos** | 6-12 meses | 2-4 semanas | 2-4 semanas |
| **Módulos activables** | ✅ **Dinámico** | ❌ Todo o nada | ⚠️ Limitado | ⚠️ Limitado |
| **Marketplace** | ✅ **Sí** | ⚠️ Limitado | ❌ No | ⚠️ Limitado |
| **Pricing** | **$399-$1,499/mes** | $50K-$200K inicial + $5K/mes | $500-$2K/mes | $600-$1.5K/mes |
| **Personalización** | ✅ Extensiones SDK | ⚠️ Consultores | ❌ Limitado | ❌ Limitado |
| Finanzas integradas | ✅ Fase 2 | ✅ Core | ❌ Limitado | ❌ No |
| HSE + IA predictiva | ✅ **Diferenciador** | ❌ No IA | ⚠️ Sin IA | ❌ No |
| Time & Attendance GPS+Bio | ✅ Integrado | ⚠️ Módulo aparte | ⚠️ 3rd party | ❌ No |
| WhatsApp + IA agent | ✅ **Único** | ❌ No | ❌ No | ❌ No |
```

---

## 10. Documentos Relacionados

Al final del MVP, agregar referencias a los nuevos documentos:

```markdown
---

## Documentación Relacionada

- **[ARQUITECTURA-SAAS.md](./ARQUITECTURA-SAAS.md)**: Arquitectura multi-tenant detallada
- **[PORTAL-ADMIN-SAAS.md](./PORTAL-ADMIN-SAAS.md)**: Especificación del portal de administración (por crear)
- **[MARKETPLACE-EXTENSIONES.md](./MARKETPLACE-EXTENSIONES.md)**: Guía de desarrollo de extensiones (por crear)
- **[PRICING-ESTRATEGIA.md](./PRICING-ESTRATEGIA.md)**: Estrategia de pricing y planes (por crear)
- **[ONBOARDING-PLAYBOOK.md](./ONBOARDING-PLAYBOOK.md)**: Guía de onboarding de clientes (por crear)

---

**Versión:** 2.0 SaaS Multi-tenant
**Última actualización:** 2025-11-17
**Modelo de negocio:** B2B SaaS, Subscription-based
```

---

## ✅ Checklist de Aplicación

Para aplicar estos cambios al MVP-APP.md:

- [ ] 1. Actualizar Resumen Ejecutivo (Sección 0)
- [ ] 2. Agregar Sección 0.1 (Arquitectura SaaS)
- [ ] 3. Actualizar Sección 2 (Módulos activables)
- [ ] 4. Agregar Sección 4 (Arquitectura Técnica SaaS)
- [ ] 5. Actualizar Roadmap
- [ ] 6. Agregar Ventajas Competitivas SaaS
- [ ] 7. Agregar Casos de Uso SaaS
- [ ] 8. Agregar Migración de Clientes
- [ ] 9. Actualizar Comparación con Competidores
- [ ] 10. Agregar Referencias a Documentación

---

## 🔄 Próximos Pasos

Después de actualizar el MVP-APP.md:

1. **Actualizar documentación en cascada:**
   - README.md de cada fase
   - _MAP.md de cada módulo
   - Agregar secciones de "Configuración SaaS" en cada módulo

2. **Crear documentos adicionales:**
   - PORTAL-ADMIN-SAAS.md (especificación detallada)
   - MARKETPLACE-EXTENSIONES.md (guía de desarrollo)
   - PRICING-ESTRATEGIA.md (análisis de pricing)
   - ONBOARDING-PLAYBOOK.md (guía operativa)

3. **Actualizar arquitectura técnica:**
   - Diagramas de arquitectura multi-tenant
   - Flujos de onboarding
   - Security model
   - Deployment strategy

---

**Generado:** 2025-11-17
**Propósito:** Guía de transformación a modelo SaaS