rckrdmrd
928eb795e6
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Cambios en backend y frontend Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
319 lines
13 KiB
Markdown
319 lines
13 KiB
Markdown
# VALIDACION DEL PLAN DE ESTANDARIZACION
|
|
**Fecha:** 2026-01-10
|
|
**Fase:** FASE 4 - Validacion
|
|
**Estado:** COMPLETADO
|
|
**Referencia:** PLAN-ESTANDARIZACION-DOCUMENTAL-2026-01-10.md
|
|
|
|
---
|
|
|
|
## 1. MATRIZ DE VALIDACION PLAN vs ANALISIS
|
|
|
|
### 1.1 Cobertura de Brechas Identificadas
|
|
|
|
| Brecha (Analisis) | Prioridad | Tarea en Plan | Cubierta |
|
|
|-------------------|-----------|---------------|----------|
|
|
| Falta docs/README.md | P0 | A1 | ✓ SI |
|
|
| Falta orchestration/README.md | P0 | A2 | ✓ SI |
|
|
| Integraciones sin documentar | P0 | B1-B6 | ✓ SI |
|
|
| Sin directorio 97-adr/ | P1 | D1 | ✓ SI |
|
|
| Cobertura tests desconocida | P1 | F1-F4 | ✓ SI |
|
|
| Sin User Stories formales | P1 | - | ✗ NO (deprioritizado) |
|
|
| Frontmatter inconsistente | P1 | E1-E3 | ✓ SI |
|
|
| Sin migraciones incrementales | P2 | - | ✗ NO (no aplica, usa DDL) |
|
|
| Changelog no formal | P2 | C7 | ✓ SI |
|
|
| Specs sin prefijo ET- | P2 | - | ✗ NO (opcional) |
|
|
| Inconsistencia en conteos | P2 | C1-C6 | ✓ SI |
|
|
|
|
**Cobertura:** 8 de 11 brechas cubiertas (73%)
|
|
**Brechas no cubiertas:** 3 (justificadas como no aplicables o deprioritizadas)
|
|
|
|
### 1.2 Validacion de Directivas Aplicadas
|
|
|
|
| Directiva | Tareas que la Aplican | Validacion |
|
|
|-----------|----------------------|------------|
|
|
| @DOC_PROYECTO | A1, A2, B6, D5 | ✓ COMPLETA |
|
|
| @NOMENCLATURA | B2-B5, D2-D4 | ✓ COMPLETA |
|
|
| @ESTRUCTURA_DOCS | E1-E3 | ✓ COMPLETA |
|
|
| @INVENTARIOS | C1-C7 | ✓ COMPLETA |
|
|
| @TESTING | F1-F4 | ✓ COMPLETA |
|
|
| @MIGRACIONES | - | N/A (DDL directo) |
|
|
| @INTEGRACIONES | B2-B5 | ✓ COMPLETA |
|
|
|
|
### 1.3 Validacion de Checklists
|
|
|
|
| Checklist | Tareas Relacionadas | Items Afectados |
|
|
|-----------|---------------------|-----------------|
|
|
| @CHK_DOCUMENTACION | A1, A2, B1, D1 | +10 items |
|
|
| @CHK_INVENTARIOS | C1-C7 | +7 items |
|
|
| @CHK_NOMENCLATURA | B2-B5, D2-D4 | +7 items |
|
|
|
|
---
|
|
|
|
## 2. ANALISIS DE DEPENDENCIAS DE ARCHIVOS
|
|
|
|
### 2.1 Archivos a Modificar y sus Dependencias
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ GRAFO DE DEPENDENCIAS DE ARCHIVOS │
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ ARCHIVOS NUEVOS (sin dependencias entrantes) │
|
|
│ ────────────────────────────────────────────── │
|
|
│ │
|
|
│ ┌──────────────────────┐ ┌──────────────────────┐ │
|
|
│ │ docs/README.md │ │ orchestration/ │ │
|
|
│ │ (A1) │ │ README.md (A2) │ │
|
|
│ └──────────────────────┘ └──────────────────────┘ │
|
|
│ │
|
|
│ ┌──────────────────────┐ ┌──────────────────────┐ │
|
|
│ │ docs/02-integraciones│ │ docs/97-adr/ │ │
|
|
│ │ /INT-*.md (B2-B5) │ │ ADR-*.md (D2-D4) │ │
|
|
│ └──────────────────────┘ └──────────────────────┘ │
|
|
│ │ │ │
|
|
│ v v │
|
|
│ ┌──────────────────────┐ ┌──────────────────────┐ │
|
|
│ │ docs/02-integraciones│ │ docs/97-adr/ │ │
|
|
│ │ /_MAP.md (B6) │ │ _MAP.md (D5) │ │
|
|
│ └──────────────────────┘ └──────────────────────┘ │
|
|
│ │
|
|
│ ARCHIVOS A MODIFICAR (con dependencias) │
|
|
│ ──────────────────────────────────────── │
|
|
│ │
|
|
│ DATABASE_INVENTORY.yml ◄── C1, C2 │
|
|
│ │ │
|
|
│ v │
|
|
│ BACKEND_INVENTORY.yml ◄── C3 │
|
|
│ │ │
|
|
│ v │
|
|
│ ┌────────┴────────┬─────────────────┐ │
|
|
│ │ │ │ │
|
|
│ v v v │
|
|
│ HERENCIA- CONTEXTO- docs/ │
|
|
│ SIMCO.md PROYECTO.md _MAP.md │
|
|
│ (C4) (C5) (C6) │
|
|
│ │
|
|
│ MASTER_INVENTORY.yml ◄── C7 (changelog) │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### 2.2 Orden Seguro de Ejecucion
|
|
|
|
Para evitar inconsistencias, el orden de ejecucion debe ser:
|
|
|
|
1. **Primero:** Verificar datos reales (C1, C2, C3)
|
|
2. **Segundo:** Actualizar inventarios base (DATABASE, BACKEND)
|
|
3. **Tercero:** Propagar a archivos dependientes (C4, C5, C6)
|
|
4. **Cuarto:** Crear archivos nuevos (A1, A2, B1-B6, D1-D5)
|
|
5. **Quinto:** Agregar changelog (C7)
|
|
|
|
### 2.3 Archivos que NO deben modificarse simultaneamente
|
|
|
|
| Grupo | Archivos | Razon |
|
|
|-------|----------|-------|
|
|
| Grupo 1 | DATABASE_INVENTORY + MASTER_INVENTORY | MASTER depende de DATABASE |
|
|
| Grupo 2 | HERENCIA-SIMCO + CONTEXTO-PROYECTO + _MAP | Deben tener datos consistentes |
|
|
|
|
---
|
|
|
|
## 3. VALIDACION DE CONTENIDO PROPUESTO
|
|
|
|
### 3.1 docs/README.md
|
|
|
|
| Aspecto | Validacion |
|
|
|---------|------------|
|
|
| Sigue @DOC_PROYECTO | ✓ SI |
|
|
| Tiene estructura estandar | ✓ SI |
|
|
| Referencias funcionan | ✓ SI (a _MAP.md, vision) |
|
|
| Metricas incluidas | ✓ SI |
|
|
|
|
### 3.2 orchestration/README.md
|
|
|
|
| Aspecto | Validacion |
|
|
|---------|------------|
|
|
| Explica proposito | ✓ SI |
|
|
| Lista estructura | ✓ SI |
|
|
| Guia para agentes | ✓ SI |
|
|
| SSOT referenciado | ✓ SI |
|
|
|
|
### 3.3 Integraciones (INT-*)
|
|
|
|
| Aspecto | Validacion |
|
|
|---------|------------|
|
|
| Usa @TPL_INTEGRACION | ✓ SI |
|
|
| Nomenclatura INT-NNN | ✓ SI |
|
|
| Metadata completa | ✓ SI |
|
|
| Credenciales documentadas | ✓ SI |
|
|
|
|
### 3.4 ADRs
|
|
|
|
| Aspecto | Validacion |
|
|
|---------|------------|
|
|
| Nomenclatura ADR-NNNN | ✓ SI |
|
|
| Estructura estandar | ✓ SI |
|
|
| Decisiones relevantes | ✓ SI |
|
|
|
|
---
|
|
|
|
## 4. RIESGOS IDENTIFICADOS
|
|
|
|
### 4.1 Riesgos Tecnicos
|
|
|
|
| Riesgo | Probabilidad | Impacto | Mitigacion |
|
|
|--------|--------------|---------|------------|
|
|
| Datos de inventarios desactualizados | MEDIA | ALTO | Verificar contra codigo fuente |
|
|
| Links rotos al crear archivos | BAJA | BAJO | Verificar rutas antes de crear |
|
|
| Conflictos de frontmatter | BAJA | BAJO | Usar formato estandar YAML |
|
|
|
|
### 4.2 Riesgos de Proceso
|
|
|
|
| Riesgo | Probabilidad | Impacto | Mitigacion |
|
|
|--------|--------------|---------|------------|
|
|
| Ejecucion parcial | BAJA | MEDIO | Ejecutar por bloques completos |
|
|
| Inconsistencia post-modificacion | MEDIA | ALTO | Validar con checklists al final |
|
|
|
|
---
|
|
|
|
## 5. AJUSTES RECOMENDADOS AL PLAN
|
|
|
|
### 5.1 Ajustes Menores
|
|
|
|
| Ajuste | Razon |
|
|
|--------|-------|
|
|
| Ejecutar C1-C3 antes de A1-A2 | Para tener datos correctos en READMEs |
|
|
| Agregar tarea de verificacion de links | Prevenir referencias rotas |
|
|
| Incluir backup antes de C4-C6 | Permitir rollback si hay errores |
|
|
|
|
### 5.2 Orden Refinado
|
|
|
|
```
|
|
NUEVO ORDEN DE EJECUCION:
|
|
|
|
BLOQUE C.1 (Verificacion)
|
|
├── C1: Verificar schemas BD ◄── PRIMERO
|
|
├── C2: Verificar tablas BD
|
|
└── C3: Verificar modulos backend
|
|
|
|
BLOQUE A (Estructura)
|
|
├── A1: docs/README.md ◄── Con datos verificados
|
|
└── A2: orchestration/README.md
|
|
|
|
BLOQUE C.2 (Sincronizacion)
|
|
├── C4: HERENCIA-SIMCO.md
|
|
├── C5: CONTEXTO-PROYECTO.md
|
|
├── C6: docs/_MAP.md
|
|
└── C7: Changelog en MASTER
|
|
|
|
BLOQUE B (Integraciones)
|
|
├── B1: Crear directorio
|
|
├── B2-B5: INT-001 a INT-004
|
|
└── B6: _MAP.md integraciones
|
|
|
|
BLOQUE D (ADRs)
|
|
├── D1: Crear directorio
|
|
├── D2-D4: ADR-0001 a ADR-0003
|
|
└── D5: _MAP.md ADRs
|
|
|
|
BLOQUE E (Frontmatter) [OPCIONAL]
|
|
└── E1-E3: Agregar frontmatter
|
|
|
|
BLOQUE F (Testing) [OPCIONAL]
|
|
└── F1-F4: Ejecutar y documentar
|
|
```
|
|
|
|
---
|
|
|
|
## 6. VALIDACION DE COMPLETITUD
|
|
|
|
### 6.1 Todas las Brechas P0 Cubiertas
|
|
|
|
| Brecha P0 | Tarea | Estado |
|
|
|-----------|-------|--------|
|
|
| docs/README.md | A1 | ✓ CUBIERTA |
|
|
| orchestration/README.md | A2 | ✓ CUBIERTA |
|
|
| Integraciones | B1-B6 | ✓ CUBIERTA |
|
|
|
|
### 6.2 Todas las Brechas P1 Cubiertas
|
|
|
|
| Brecha P1 | Tarea | Estado |
|
|
|-----------|-------|--------|
|
|
| 97-adr/ | D1-D5 | ✓ CUBIERTA |
|
|
| Tests | F1-F4 | ✓ CUBIERTA |
|
|
| Frontmatter | E1-E3 | ✓ CUBIERTA |
|
|
| User Stories | - | △ DEPRIORITIZADO (justificado) |
|
|
|
|
### 6.3 Brechas P2 Cubiertas
|
|
|
|
| Brecha P2 | Tarea | Estado |
|
|
|-----------|-------|--------|
|
|
| Changelog | C7 | ✓ CUBIERTA |
|
|
| Sincronizacion | C1-C6 | ✓ CUBIERTA |
|
|
| Migraciones | - | ✗ N/A (usa DDL directo) |
|
|
| Prefijos ET- | - | ✗ DEPRIORITIZADO (opcional) |
|
|
|
|
---
|
|
|
|
## 7. MATRIZ DE TRAZABILIDAD
|
|
|
|
### 7.1 Analisis → Plan → Validacion
|
|
|
|
| ID Brecha | Descripcion | ID Tarea | Validada |
|
|
|-----------|-------------|----------|----------|
|
|
| BR-01 | Falta docs/README.md | A1 | ✓ |
|
|
| BR-02 | Falta orchestration/README.md | A2 | ✓ |
|
|
| BR-03 | Integraciones sin documentar | B1-B6 | ✓ |
|
|
| BR-04 | Sin directorio 97-adr/ | D1-D5 | ✓ |
|
|
| BR-05 | Cobertura tests desconocida | F1-F4 | ✓ |
|
|
| BR-06 | Sin User Stories | - | N/A |
|
|
| BR-07 | Frontmatter inconsistente | E1-E3 | ✓ |
|
|
| BR-08 | Sin migraciones incrementales | - | N/A |
|
|
| BR-09 | Sin changelog formal | C7 | ✓ |
|
|
| BR-10 | Specs sin ET- | - | N/A |
|
|
| BR-11 | Inconsistencia conteos | C1-C6 | ✓ |
|
|
|
|
---
|
|
|
|
## 8. RESULTADO DE LA VALIDACION
|
|
|
|
### 8.1 Veredicto
|
|
|
|
```
|
|
╔════════════════════════════════════════════════════════════╗
|
|
║ VALIDACION DEL PLAN: APROBADO ║
|
|
╠════════════════════════════════════════════════════════════╣
|
|
║ ║
|
|
║ Cobertura de brechas: 8/11 (73%) ║
|
|
║ Brechas P0 cubiertas: 3/3 (100%) ║
|
|
║ Brechas P1 cubiertas: 3/4 (75%) ║
|
|
║ Directivas aplicadas: 6/7 (86%) ║
|
|
║ Dependencias verificadas: SI ║
|
|
║ Orden de ejecucion: OPTIMIZADO ║
|
|
║ Riesgos identificados: 4 (mitigados) ║
|
|
║ ║
|
|
║ RESULTADO: LISTO PARA EJECUCION ║
|
|
║ ║
|
|
╚════════════════════════════════════════════════════════════╝
|
|
```
|
|
|
|
### 8.2 Recomendacion
|
|
|
|
**Proceder con FASE 5 (Refinamiento)** incorporando los ajustes recomendados, luego **FASE 6 (Ejecucion)**.
|
|
|
|
---
|
|
|
|
## 9. REGISTRO DE VALIDACION
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **Validado por** | Orquestador SIMCO |
|
|
| **Fecha** | 2026-01-10 |
|
|
| **Version del plan** | 1.0.0 |
|
|
| **Resultado** | APROBADO |
|
|
| **Proxima fase** | FASE 5 - Refinamiento |
|
|
|
|
---
|
|
|
|
**Ultima actualizacion:** 2026-01-10
|
|
**Version:** 1.0.0
|