# FASE 1: Plan de Analisis de Integracion Documentacion-Codigo

**Fecha:** 2026-01-10
**Objetivo:** Planificar el analisis detallado para validar que la documentacion refleja correctamente el desarrollo
**Estado:** EN PROGRESO

---

## 1. Alcance del Analisis

### 1.1 Documentacion a Validar

| Categoria | Archivos | Ubicacion |
|-----------|----------|-----------|
| Modulos SAAS | 14 archivos | docs/01-modulos/SAAS-XXX.md |
| Integraciones | 7 archivos | docs/02-integraciones/INT-XXX.md |
| Inventarios | 4 archivos | orchestration/inventarios/*.yml |
| Mapa Contexto | 1 archivo | orchestration/CONTEXT-MAP.yml |
| Mapa Docs | 1 archivo | docs/_MAP.md |
| Status | 1 archivo | orchestration/PROJECT-STATUS.md |

**Total:** 28 archivos de documentacion

### 1.2 Codigo a Comparar

| Capa | Elementos | Ubicacion |
|------|-----------|-----------|
| Database/DDL | 13 schemas, 28 enums, ~30 tablas | apps/database/ddl/ |
| Backend | 17 modulos NestJS | apps/backend/src/modules/ |
| Frontend | 6 portales, 20+ paginas | apps/frontend/src/ |

---

## 2. Discrepancias Preliminares Detectadas

### 2.1 Conteo de Schemas

| Fuente | Cuenta |
|--------|--------|
| Documentacion (_MAP.md) | 12 schemas |
| Codigo DDL (01-schemas.sql) | 13 schemas |

**Discrepancia:** +1 schema en codigo no documentado

### 2.2 Conteo de Modulos Backend

| Fuente | Cuenta |
|--------|--------|
| Documentacion (SAAS-001 a SAAS-014) | 14 modulos |
| Codigo Backend (modules/) | 17 modulos |

**Discrepancia:** +3 modulos en codigo no documentados como SAAS-XXX

**Modulos backend sin SAAS-XXX:**
- `health/` - No tiene SAAS-XXX
- `onboarding/` - No tiene SAAS-XXX
- `rbac/` - No tiene SAAS-XXX (referenciado en SAAS-003-users)

### 2.3 Conteo de Tablas

| Fuente | Cuenta |
|--------|--------|
| Documentacion (PROJECT-STATUS.md) | 39 tablas |
| Documentacion (MASTER_INVENTORY.yml) | 39 tablas |
| Codigo DDL | Por validar detalladamente |

---

## 3. Matriz de Validacion por Modulo

### 3.1 Modulos Documentados vs Codigo

| SAAS-ID | Nombre Doc | Modulo Backend | Schema DDL | Frontend | Estado |
|---------|------------|----------------|------------|----------|--------|
| SAAS-001 | auth | auth/ | auth | auth portal | PENDIENTE |
| SAAS-002 | tenants | tenants/ | tenants | superadmin | PENDIENTE |
| SAAS-003 | users | users/ + rbac/ | users | dashboard | PENDIENTE |
| SAAS-004 | billing | billing/ | billing | dashboard | PENDIENTE |
| SAAS-005 | plans | billing/plans | plans | onboarding | PENDIENTE |
| SAAS-006 | ai-integration | ai/ | ai | dashboard | PENDIENTE |
| SAAS-007 | notifications | notifications/ | notifications | dashboard | PENDIENTE |
| SAAS-008 | audit-logs | audit/ | audit | dashboard | PENDIENTE |
| SAAS-009 | feature-flags | feature-flags/ | feature_flags | dashboard | PENDIENTE |
| SAAS-010 | webhooks | webhooks/ | webhooks | dashboard | PENDIENTE |
| SAAS-011 | storage | storage/ | storage | dashboard | PENDIENTE |
| SAAS-012 | crud-base | N/A (patrones) | N/A | N/A | PENDIENTE |
| SAAS-013 | email | email/ | N/A | N/A | PENDIENTE |
| SAAS-014 | whatsapp | whatsapp/ | whatsapp | admin | PENDIENTE |

### 3.2 Modulos Backend Sin Documentacion SAAS

| Modulo Backend | Tiene Documentacion | Deberia Tener SAAS-XXX? |
|----------------|---------------------|-------------------------|
| health/ | NO | NO (modulo tecnico) |
| onboarding/ | Mencionado en Sprint 2 | EVALUAR |
| rbac/ | Incluido en SAAS-003 | NO (sub-modulo) |
| superadmin/ | Mencionado en portales | EVALUAR |

---

## 4. Checklist de Validacion por Archivo

### 4.1 Para cada SAAS-XXX.md validar:

- [ ] Metadata correcta (codigo, estado, fase)
- [ ] Tablas DDL listadas existen en codigo
- [ ] Enums listados existen en codigo
- [ ] Endpoints documentados existen en controllers
- [ ] DTOs documentados existen en codigo
- [ ] Servicios documentados existen en codigo
- [ ] Entidades TypeORM documentadas existen
- [ ] Hooks frontend listados existen
- [ ] Componentes frontend listados existen
- [ ] Dependencias entre modulos correctas

### 4.2 Para cada INT-XXX.md validar:

- [ ] Referencia a modulo SAAS-XXX correcta
- [ ] Configuracion ENV documentada correcta
- [ ] Dependencias NPM correctas

### 4.3 Para inventarios validar:

- [ ] Conteos correctos (tablas, modulos, etc.)
- [ ] Estados correctos (completado vs pendiente)
- [ ] Rutas de archivos validas
- [ ] Dependencias entre modulos correctas

---

## 5. Plan de Ejecucion Fase 2

### 5.1 Tareas de Analisis Detallado

| ID | Tarea | Prioridad | Complejidad |
|----|-------|-----------|-------------|
| A2.1 | Validar SAAS-001 a SAAS-005 (Core) | Alta | Media |
| A2.2 | Validar SAAS-006 a SAAS-010 (Avanzados) | Alta | Alta |
| A2.3 | Validar SAAS-011 a SAAS-014 (Extras) | Alta | Media |
| A2.4 | Validar INT-001 a INT-007 | Media | Baja |
| A2.5 | Validar inventarios YAML | Alta | Media |
| A2.6 | Validar conteos y metricas | Alta | Baja |
| A2.7 | Validar referencias cruzadas | Alta | Alta |

### 5.2 Dependencias

```
A2.1 --> A2.2 --> A2.3 --> A2.7
           |
           v
         A2.4
           |
           v
A2.5 --> A2.6
```

### 5.3 Artefactos a Generar en Fase 2

1. **FASE-2-ANALISIS-SAAS-CORE.md** - Validacion SAAS-001 a SAAS-005
2. **FASE-2-ANALISIS-SAAS-AVANZADOS.md** - Validacion SAAS-006 a SAAS-010
3. **FASE-2-ANALISIS-SAAS-EXTRAS.md** - Validacion SAAS-011 a SAAS-014
4. **FASE-2-ANALISIS-INTEGRACIONES.md** - Validacion INT-XXX
5. **FASE-2-ANALISIS-INVENTARIOS.md** - Validacion YAMLs
6. **FASE-2-RESUMEN-DISCREPANCIAS.md** - Consolidado de hallazgos

---

## 6. Criterios de Validacion

### 6.1 Nivel de Severidad

| Severidad | Descripcion | Accion |
|-----------|-------------|--------|
| CRITICO | Modulo/tabla no existe | Crear o eliminar doc |
| ALTO | Endpoints/servicios incorrectos | Actualizar doc |
| MEDIO | Conteos incorrectos | Corregir numeros |
| BAJO | Typos, formato | Corregir menor |

### 6.2 Formato de Hallazgo

```yaml
id: HAL-XXX
severidad: CRITICO|ALTO|MEDIO|BAJO
archivo_doc: ruta/archivo.md
linea: 123
elemento: nombre_elemento
esperado: valor_en_doc
encontrado: valor_en_codigo
accion: descripcion_correccion
```

---

## 7. Recursos Necesarios

### 7.1 Archivos de Referencia Codigo

| Categoria | Archivo Principal |
|-----------|-------------------|
| Schemas DDL | apps/database/ddl/01-schemas.sql |
| Enums DDL | apps/database/ddl/02-enums.sql |
| Backend Index | apps/backend/src/modules/*/index.ts |
| Frontend Hooks | apps/frontend/src/hooks/index.ts |
| Frontend Routes | apps/frontend/src/router/index.tsx |

### 7.2 Archivos de Referencia Doc

| Categoria | Archivo Principal |
|-----------|-------------------|
| Mapa Docs | docs/_MAP.md |
| Inventario Master | orchestration/inventarios/MASTER_INVENTORY.yml |
| Context Map | orchestration/CONTEXT-MAP.yml |
| Project Status | orchestration/PROJECT-STATUS.md |

---

## 8. Siguiente Paso

Proceder a **FASE 2: Analisis Detallado** ejecutando las tareas A2.1 a A2.7 en orden de dependencia.

---

**Creado por:** Claude Code
**Fecha:** 2026-01-10