rckrdmrd
50a821a415
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Actualizaciones de configuracion Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
225 lines
6.9 KiB
Markdown
225 lines
6.9 KiB
Markdown
# 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
|