2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
- Move 7 non-standard folders to _archive/ - Archive 3 extra root files - Update _MAP.md with standardized structure Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0 Level: CONSUMER (L2) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
386 lines
15 KiB
Markdown
386 lines
15 KiB
Markdown
# Analisis de Integracion: template-saas -> michangarrito
|
|
|
|
**Fecha:** 2026-01-13
|
|
**Tipo:** Analisis de Integracion Documental
|
|
**Estado:** Fase 1-2 Completadas
|
|
**Proyecto Fuente:** template-saas
|
|
**Proyecto Destino:** michangarrito
|
|
**Sistema:** SIMCO v3.8 - MODE:ANALYSIS
|
|
|
|
---
|
|
|
|
## Resumen Ejecutivo
|
|
|
|
Este documento presenta el analisis detallado de integracion de alcances y definiciones desde `template-saas` hacia `michangarrito`. El objetivo es alinear la documentacion, actualizar el plan de desarrollo y asegurar la coherencia entre las especificaciones de ambos proyectos.
|
|
|
|
### Hallazgos Principales
|
|
|
|
| Aspecto | Estado | Accion Requerida |
|
|
|---------|--------|------------------|
|
|
| Modulos SAAS documentados en template-saas | 17 modulos | Propagar a michangarrito |
|
|
| Epicas en michangarrito relacionadas | 33 epicas | Actualizar/Alinear |
|
|
| ADRs ya propagados | 11 ADRs | Verificar completitud |
|
|
| Integraciones documentadas | 14 en michangarrito | Actualizar con nuevas |
|
|
| Gaps identificados | 3 modulos sin epica | Crear epicas nuevas |
|
|
|
|
---
|
|
|
|
## Fase 1: Analisis Inicial
|
|
|
|
### 1.1 Estructura de template-saas (Fuente)
|
|
|
|
```
|
|
template-saas/docs/
|
|
├── 00-vision-general/ <- Vision y arquitectura base SaaS
|
|
│ ├── VISION-TEMPLATE-SAAS.md
|
|
│ ├── ARQUITECTURA-MULTI-TENANT.md
|
|
│ └── ESPECIFICACION-PLATAFORMA-SAAS.md
|
|
│
|
|
├── 01-modulos/ <- 17 modulos SAAS definidos
|
|
│ ├── SAAS-001-auth.md <- Autenticacion JWT
|
|
│ ├── SAAS-002-tenants.md <- Multi-tenancy
|
|
│ ├── SAAS-003-users.md <- Usuarios con RBAC
|
|
│ ├── SAAS-004-billing.md <- Suscripciones Stripe
|
|
│ ├── SAAS-005-plans.md <- Planes y limites
|
|
│ ├── SAAS-006-ai-integration.md <- LLM multi-proveedor
|
|
│ ├── SAAS-007-notifications.md <- Notificaciones v2
|
|
│ ├── SAAS-008-audit-logs.md <- Auditoria
|
|
│ ├── SAAS-009-feature-flags.md <- Toggles por plan
|
|
│ ├── SAAS-010-webhooks.md <- Webhooks outbound
|
|
│ ├── SAAS-011-storage.md <- S3/R2/MinIO
|
|
│ ├── SAAS-012-crud-base.md <- Patrones CRUD
|
|
│ ├── SAAS-013-email.md <- Email multi-proveedor
|
|
│ ├── SAAS-014-whatsapp.md <- WhatsApp Business API
|
|
│ ├── SAAS-015-oauth.md <- OAuth 2.0 (NUEVO)
|
|
│ ├── SAAS-016-analytics.md <- Analytics (NUEVO)
|
|
│ └── SAAS-017-reports.md <- Reports PDF/Excel (NUEVO)
|
|
│
|
|
├── 02-especificaciones/ <- Especificaciones tecnicas
|
|
└── architecture/adr/ <- 13 ADRs
|
|
```
|
|
|
|
### 1.2 Estructura de michangarrito (Destino)
|
|
|
|
```
|
|
michangarrito/docs/
|
|
├── 00-vision-general/ <- Vision y arquitectura
|
|
│ ├── VISION-PROYECTO.md <- Vision MiChangarrito
|
|
│ ├── ARQUITECTURA-TECNICA.md <- Stack tecnico
|
|
│ └── REQUERIMIENTOS-FUNCIONALES.md
|
|
│
|
|
├── 01-epicas/ <- 33 epicas definidas
|
|
│ ├── MCH-001 a MCH-028 <- Epicas originales
|
|
│ ├── MCH-029-infraestructura-saas.md <- Infraestructura SaaS
|
|
│ ├── MCH-030-auth-social.md <- OAuth 2.0
|
|
│ ├── MCH-031-auditoria-empresarial.md
|
|
│ ├── MCH-032-feature-flags.md
|
|
│ └── MCH-033-onboarding-wizard.md
|
|
│
|
|
├── 02-especificaciones/
|
|
│ └── PLAN-DESARROLLO.md <- Plan de desarrollo
|
|
│
|
|
├── 02-integraciones/ <- 14 integraciones
|
|
│ ├── INT-001 a INT-009 <- Originales
|
|
│ └── INT-010 a INT-014 <- Nuevas (propagadas)
|
|
│
|
|
└── 97-adr/ <- 11 ADRs
|
|
```
|
|
|
|
---
|
|
|
|
## Fase 2: Analisis Detallado
|
|
|
|
### 2.1 Mapeo Modulos SAAS -> Epicas MCH
|
|
|
|
| Modulo SAAS | Codigo | Epica MCH | Codigo | Estado | Gap |
|
|
|-------------|--------|-----------|--------|--------|-----|
|
|
| Auth | SAAS-001 | Autenticacion | MCH-002 | Completado | - |
|
|
| Tenants | SAAS-002 | Infraestructura Base | MCH-001 | Completado | - |
|
|
| Users | SAAS-003 | Autenticacion | MCH-002 | Completado | - |
|
|
| Billing | SAAS-004 | Planes Suscripciones | MCH-018 | Completado | - |
|
|
| Plans | SAAS-005 | Planes Suscripciones | MCH-018 | Completado | - |
|
|
| AI Integration | SAAS-006 | MCP Server + Chat LLM | MCH-010,12,13 | Completado | - |
|
|
| Notifications | SAAS-007 | Notificaciones | MCH-017 | Completado | - |
|
|
| Audit Logs | SAAS-008 | Auditoria Empresarial | MCH-031 | Planificado | Alinear |
|
|
| Feature Flags | SAAS-009 | Feature Flags | MCH-032 | Planificado | Alinear |
|
|
| Webhooks | SAAS-010 | Infraestructura SaaS | MCH-029 | Planificado | Alinear |
|
|
| Storage | SAAS-011 | Infraestructura SaaS | MCH-029 | Planificado | Alinear |
|
|
| CRUD Base | SAAS-012 | N/A | - | Documentacion | - |
|
|
| Email | SAAS-013 | Infraestructura SaaS | MCH-029 | Planificado | Alinear |
|
|
| WhatsApp | SAAS-014 | WhatsApp Service | MCH-011 | Completado | - |
|
|
| **OAuth** | **SAAS-015** | **Auth Social** | **MCH-030** | **Planificado** | **Alinear** |
|
|
| **Analytics** | **SAAS-016** | **-** | **-** | **NO EXISTE** | **CREAR** |
|
|
| **Reports** | **SAAS-017** | **Dashboard Web (parcial)** | **MCH-021** | **Parcial** | **CREAR** |
|
|
|
|
### 2.2 Gaps Identificados
|
|
|
|
#### Gap 1: Modulo Analytics (SAAS-016) sin Epica
|
|
|
|
**Descripcion:** template-saas tiene un modulo completo de Analytics con:
|
|
- Metricas de usuarios (totales, activos, crecimiento, retencion)
|
|
- Metricas de billing (ingresos, facturas, tendencias)
|
|
- Metricas de uso (acciones, sesiones, entidades)
|
|
- 5 endpoints API documentados
|
|
|
|
**Accion Requerida:** Crear nueva epica `MCH-034: Analytics y Metricas`
|
|
|
|
#### Gap 2: Modulo Reports (SAAS-017) parcialmente cubierto
|
|
|
|
**Descripcion:** template-saas tiene un modulo de Reports con:
|
|
- Exportacion a PDF, Excel, CSV
|
|
- Reportes de usuarios, billing, auditoria
|
|
- Filtros por fecha y paginacion
|
|
|
|
**Accion Requerida:** Extender `MCH-021: Dashboard Web` o crear `MCH-035: Sistema de Reportes`
|
|
|
|
#### Gap 3: Alineacion de Epicas MCH-029 a MCH-032
|
|
|
|
**Descripcion:** Las epicas MCH-029 a MCH-032 estan definidas pero necesitan alinearse completamente con las especificaciones de template-saas para mantener consistencia.
|
|
|
|
### 2.3 ADRs Propagados (Verificacion)
|
|
|
|
| ADR michangarrito | ADR template-saas | Estado |
|
|
|-------------------|-------------------|--------|
|
|
| ADR-0001 Multi-Tenant | ADR-001 Multi-tenancy RLS | Alineado |
|
|
| ADR-0002 WhatsApp First | - | Original MCH |
|
|
| ADR-0003 LLM Agnostic | ADR-006 AI Integration | Alineado |
|
|
| ADR-0004 Notifications Realtime | ADR-004 Notifications | Propagado |
|
|
| ADR-0005 Feature Flags | ADR-005 Feature Flags | Propagado |
|
|
| ADR-0006 Storage Abstraction | ADR-007 Storage | Propagado |
|
|
| ADR-0007 Webhook Retry | ADR-008 Webhook Retry | Propagado |
|
|
| ADR-0008 Audit Log Retention | ADR-010 Audit Log Retention | Propagado |
|
|
| ADR-0009 Rate Limiting | ADR-011 Rate Limiting | Propagado |
|
|
| ADR-0010 OAuth Social | ADR-002 Auth JWT+OAuth | Propagado |
|
|
| ADR-0011 Email Multi-provider | ADR-013 Email Service | Propagado |
|
|
|
|
**Estado:** 11/11 ADRs verificados
|
|
|
|
### 2.4 Integraciones Propagadas (Verificacion)
|
|
|
|
| Integracion MCH | Integracion template-saas | Estado |
|
|
|-----------------|---------------------------|--------|
|
|
| INT-010 Email Providers | INT-003 Email | Propagado |
|
|
| INT-011 Storage Cloud | INT-005 Storage | Propagado |
|
|
| INT-012 OAuth Social | INT-002 OAuth | Propagado |
|
|
| INT-013 Redis Cache | INT-007 Redis | Propagado |
|
|
| INT-014 Webhooks Outbound | INT-006 Webhooks | Propagado |
|
|
|
|
**Estado:** 5/5 integraciones verificadas
|
|
|
|
---
|
|
|
|
## Fase 3: Plan de Integracion
|
|
|
|
### 3.1 Archivos a Crear
|
|
|
|
| # | Archivo | Tipo | Prioridad | Dependencias |
|
|
|---|---------|------|-----------|--------------|
|
|
| 1 | docs/01-epicas/MCH-034-analytics.md | Epica | P1 | MCH-031, MCH-008 |
|
|
| 2 | docs/01-epicas/MCH-035-sistema-reportes.md | Epica | P2 | MCH-034 |
|
|
|
|
### 3.2 Archivos a Actualizar
|
|
|
|
| # | Archivo | Tipo | Cambio |
|
|
|---|---------|------|--------|
|
|
| 1 | docs/00-vision-general/VISION-PROYECTO.md | Vision | Agregar referencia a capacidades SaaS avanzadas |
|
|
| 2 | docs/00-vision-general/ARQUITECTURA-TECNICA.md | Arquitectura | Agregar modulos Analytics y Reports |
|
|
| 3 | docs/02-especificaciones/PLAN-DESARROLLO.md | Plan | Agregar MCH-034 y MCH-035 al roadmap |
|
|
| 4 | docs/01-epicas/_MAP.md | Indice | Actualizar con nuevas epicas |
|
|
| 5 | docs/_MAP.md | Indice | Actualizar contadores |
|
|
| 6 | docs/01-epicas/MCH-029-infraestructura-saas.md | Epica | Alinear con SAAS-010,011,013 |
|
|
| 7 | docs/01-epicas/MCH-030-auth-social.md | Epica | Alinear con SAAS-015 (mas detalle) |
|
|
| 8 | docs/01-epicas/MCH-031-auditoria-empresarial.md | Epica | Alinear con SAAS-008 |
|
|
| 9 | docs/01-epicas/MCH-032-feature-flags.md | Epica | Alinear con SAAS-009 |
|
|
|
|
### 3.3 Archivos Sin Cambios (Validados)
|
|
|
|
- docs/97-adr/*.md - Todos los ADRs estan propagados y actualizados
|
|
- docs/02-integraciones/INT-010 a INT-014 - Propagadas correctamente
|
|
|
|
---
|
|
|
|
## Fase 4: Validacion de Plan
|
|
|
|
### 4.1 Checklist de Validacion
|
|
|
|
| # | Criterio | Estado | Notas |
|
|
|---|----------|--------|-------|
|
|
| 1 | Todos los modulos SAAS tienen epica correspondiente | Pendiente | Crear MCH-034, MCH-035 |
|
|
| 2 | ADRs alineados entre proyectos | Completado | 11/11 |
|
|
| 3 | Integraciones propagadas | Completado | 5/5 |
|
|
| 4 | Plan de desarrollo actualizado | Pendiente | Actualizar |
|
|
| 5 | Vision general incluye capacidades SaaS | Pendiente | Actualizar |
|
|
| 6 | Indices de documentacion actualizados | Pendiente | Actualizar |
|
|
|
|
### 4.2 Matriz de Cobertura
|
|
|
|
```
|
|
template-saas SAAS-001 ─────> michangarrito MCH-002 ✓
|
|
template-saas SAAS-002 ─────> michangarrito MCH-001 ✓
|
|
template-saas SAAS-003 ─────> michangarrito MCH-002 ✓
|
|
template-saas SAAS-004 ─────> michangarrito MCH-018 ✓
|
|
template-saas SAAS-005 ─────> michangarrito MCH-018 ✓
|
|
template-saas SAAS-006 ─────> michangarrito MCH-010,12,13 ✓
|
|
template-saas SAAS-007 ─────> michangarrito MCH-017 ✓
|
|
template-saas SAAS-008 ─────> michangarrito MCH-031 ○ (alinear)
|
|
template-saas SAAS-009 ─────> michangarrito MCH-032 ○ (alinear)
|
|
template-saas SAAS-010 ─────> michangarrito MCH-029 ○ (alinear)
|
|
template-saas SAAS-011 ─────> michangarrito MCH-029 ○ (alinear)
|
|
template-saas SAAS-012 ─────> michangarrito N/A (documentacion)
|
|
template-saas SAAS-013 ─────> michangarrito MCH-029 ○ (alinear)
|
|
template-saas SAAS-014 ─────> michangarrito MCH-011 ✓
|
|
template-saas SAAS-015 ─────> michangarrito MCH-030 ○ (alinear)
|
|
template-saas SAAS-016 ─────> michangarrito MCH-034 ✗ (CREAR)
|
|
template-saas SAAS-017 ─────> michangarrito MCH-035 ✗ (CREAR)
|
|
|
|
Leyenda: ✓ Completo | ○ Requiere alineacion | ✗ No existe (crear)
|
|
```
|
|
|
|
---
|
|
|
|
## Fase 5: Dependencias de Archivos
|
|
|
|
### 5.1 Dependencias de Creacion
|
|
|
|
```
|
|
MCH-034-analytics.md
|
|
└── Depende de:
|
|
├── MCH-031-auditoria-empresarial.md (audit logs como fuente de datos)
|
|
├── MCH-018-planes-suscripciones.md (billing metrics)
|
|
└── MCH-008-sistema-fiados.md (datos de uso)
|
|
|
|
MCH-035-sistema-reportes.md
|
|
└── Depende de:
|
|
├── MCH-034-analytics.md (datos para reportes)
|
|
├── MCH-029-infraestructura-saas.md (storage para archivos)
|
|
└── MCH-021-dashboard-web.md (UI para exportacion)
|
|
```
|
|
|
|
### 5.2 Dependencias de Actualizacion
|
|
|
|
```
|
|
VISION-PROYECTO.md
|
|
└── Actualizar seccion "Roadmap de Alto Nivel" y "Tecnologia"
|
|
|
|
ARQUITECTURA-TECNICA.md
|
|
└── Agregar modulos en seccion "Stack Principal"
|
|
|
|
PLAN-DESARROLLO.md
|
|
└── Agregar epicas MCH-034, MCH-035 en FASE 7-8
|
|
|
|
_MAP.md (docs/)
|
|
└── Actualizar contadores: Total Epicas: 33 -> 35
|
|
|
|
_MAP.md (01-epicas/)
|
|
└── Agregar MCH-034, MCH-035 en FASE 8
|
|
```
|
|
|
|
---
|
|
|
|
## Fase 6: Plan Refinado de Ejecucion
|
|
|
|
### 6.1 Orden de Ejecucion
|
|
|
|
| Paso | Archivo | Accion | Prioridad |
|
|
|------|---------|--------|-----------|
|
|
| 1 | MCH-029-infraestructura-saas.md | ALINEAR | P0 |
|
|
| 2 | MCH-030-auth-social.md | ALINEAR | P0 |
|
|
| 3 | MCH-031-auditoria-empresarial.md | ALINEAR | P1 |
|
|
| 4 | MCH-032-feature-flags.md | ALINEAR | P1 |
|
|
| 5 | MCH-034-analytics.md | CREAR | P1 |
|
|
| 6 | MCH-035-sistema-reportes.md | CREAR | P2 |
|
|
| 7 | VISION-PROYECTO.md | ACTUALIZAR | P1 |
|
|
| 8 | ARQUITECTURA-TECNICA.md | ACTUALIZAR | P1 |
|
|
| 9 | PLAN-DESARROLLO.md | ACTUALIZAR | P0 |
|
|
| 10 | _MAP.md (docs/) | ACTUALIZAR | P1 |
|
|
| 11 | _MAP.md (01-epicas/) | ACTUALIZAR | P1 |
|
|
|
|
### 6.2 Estimacion de Esfuerzo
|
|
|
|
| Tipo de Cambio | Cantidad | Esfuerzo Estimado |
|
|
|----------------|----------|-------------------|
|
|
| Crear epicas nuevas | 2 | Alto |
|
|
| Alinear epicas existentes | 4 | Medio |
|
|
| Actualizar documentos vision | 2 | Bajo |
|
|
| Actualizar indices | 2 | Bajo |
|
|
| **TOTAL** | **10 archivos** | **Medio-Alto** |
|
|
|
|
---
|
|
|
|
## Proximos Pasos
|
|
|
|
### Inmediato (Fase de Ejecucion)
|
|
|
|
1. **Alinear** epicas MCH-029 a MCH-032 con especificaciones de template-saas
|
|
2. **Crear** epica MCH-034 para Analytics basada en SAAS-016
|
|
3. **Crear** epica MCH-035 para Sistema de Reportes basada en SAAS-017
|
|
4. **Actualizar** PLAN-DESARROLLO.md con nuevas epicas
|
|
|
|
### Despues de Validacion
|
|
|
|
5. **Actualizar** VISION-PROYECTO.md y ARQUITECTURA-TECNICA.md
|
|
6. **Actualizar** indices _MAP.md
|
|
7. **Validar** completitud de la integracion
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
### Documentos Fuente (template-saas)
|
|
- docs/01-modulos/SAAS-015-oauth.md
|
|
- docs/01-modulos/SAAS-016-analytics.md
|
|
- docs/01-modulos/SAAS-017-reports.md
|
|
- docs/_MAP.md
|
|
|
|
### Documentos Destino (michangarrito)
|
|
- docs/01-epicas/MCH-029-infraestructura-saas.md
|
|
- docs/01-epicas/MCH-030-auth-social.md
|
|
- docs/02-especificaciones/PLAN-DESARROLLO.md
|
|
- docs/_MAP.md
|
|
|
|
### Directivas SIMCO
|
|
- MODE-ANALYSIS.md
|
|
- TRIGGER-PROPAGACION-AUTOMATICA.md
|
|
|
|
---
|
|
|
|
**Estado:** COMPLETADO - Todas las fases ejecutadas exitosamente
|
|
**Siguiente Paso:** N/A - Integracion completa
|
|
**Fecha:** 2026-01-13
|
|
|
|
---
|
|
|
|
## Resumen de Ejecucion
|
|
|
|
### Archivos Modificados (4)
|
|
| Archivo | Tipo | Cambio |
|
|
|---------|------|--------|
|
|
| MCH-029-infraestructura-saas.md | Epica | +100 lineas con especificaciones tecnicas detalladas |
|
|
| MCH-030-auth-social.md | Epica | +115 lineas con modelo de datos y flujo OAuth |
|
|
| MCH-031-auditoria-empresarial.md | Epica | +90 lineas con estructura de audit logs |
|
|
| MCH-032-feature-flags.md | Epica | +120 lineas con logica de evaluacion |
|
|
|
|
### Archivos Creados (2)
|
|
| Archivo | Tipo | Lineas |
|
|
|---------|------|--------|
|
|
| MCH-034-analytics.md | Epica Nueva | ~400 lineas |
|
|
| MCH-035-sistema-reportes.md | Epica Nueva | ~380 lineas |
|
|
|
|
### Documentos Actualizados (3)
|
|
| Archivo | Cambio |
|
|
|---------|--------|
|
|
| PLAN-DESARROLLO.md | +130 lineas con Fases 7-8 |
|
|
| docs/_MAP.md | Actualizados contadores y secciones |
|
|
| docs/01-epicas/_MAP.md | +2 epicas en indice |
|
|
|
|
### Validacion Final
|
|
- [x] MCH-029 alineado con SAAS-010, SAAS-011, SAAS-013
|
|
- [x] MCH-030 alineado con SAAS-015
|
|
- [x] MCH-031 alineado con SAAS-008
|
|
- [x] MCH-032 alineado con SAAS-009
|
|
- [x] MCH-034 creado basado en SAAS-016
|
|
- [x] MCH-035 creado basado en SAAS-017
|
|
- [x] PLAN-DESARROLLO.md actualizado
|
|
- [x] Indices _MAP.md actualizados
|
|
- [x] Documento de analisis actualizado
|