19 KiB
19 KiB
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:
## 0) Resumen ejecutivo
Sistema **ERP de construcción enterprise-ready** para constructoras de vivienda en serie...
POR:
## 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:
## 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:
## 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:
## 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:
### 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:
### 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:
### 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:
## 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:
## 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:
### 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:
---
## 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:
-
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
-
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)
-
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