workspace-v1/orchestration/checklists/CHECKLIST-INVENTARIOS.md

CHECKLIST: Inventarios YAML

Version: 1.0.0 Proposito: Validar que los inventarios YAML cumplen con el estandar Referencia: SIMCO-INVENTARIOS.md Creado: 2026-01-10

---

Instrucciones de Uso

1. Ejecutar despues de cada actualizacion de inventario
2. Validar antes de cada merge a main/develop
3. Ejecutar herramienta yamllint para validacion sintactica

---

1. MASTER_INVENTORY.yml

1.1 Existencia y Ubicacion

• Archivo existe en /orchestration/inventarios/
• Nombre es exactamente MASTER_INVENTORY.yml

1.2 Seccion Metadata

• Existe campo metadata.proyecto
• Existe campo metadata.tipo (Standalone|Suite|Suite-Core|Vertical)
• Existe campo metadata.version (formato SEMVER)
• Existe campo metadata.updated (formato YYYY-MM-DD)
• Fecha updated es reciente (< 30 dias)

1.3 Seccion Resumen

• Existe campo resumen.progreso_mvp
• Existe campo resumen.story_points_completados
• Existe campo resumen.story_points_totales
• Porcentaje de progreso es consistente con SP

1.4 Seccion Fases

• Existe listado fases
• Cada fase tiene nombre, codigo, estado, progreso
• Estados usan valores validos (completado|en_progreso|pendiente)
• Progreso es porcentaje (0-100)

1.5 Seccion Aplicaciones

• Existe listado aplicaciones.backend (si aplica)
• Existe listado aplicaciones.frontend (si aplica)
• Cada servicio tiene nombre, ruta, puerto, estado
• Puertos no tienen conflictos

---

2. DATABASE_INVENTORY.yml

2.1 Existencia

• Archivo existe si el proyecto tiene base de datos
• Ubicado en /orchestration/inventarios/

2.2 Metadata

• Campo metadata.proyecto presente
• Campo metadata.tipo es "DATABASE"
• Campo metadata.motor especificado (PostgreSQL|MySQL)
• Campo metadata.version presente

2.3 Schemas

• Listado schemas existe
• Cada schema tiene nombre y descripcion
• Cada schema lista sus tablas
• Tablas incluyen conteo de columnas
• Estados de tablas son validos

2.4 Funciones y Triggers

• Seccion funciones existe (si hay funciones)
• Cada funcion tiene nombre y tipo
• Seccion triggers existe (si hay triggers)
• Triggers referencian tabla asociada

2.5 Migraciones

• Campo migraciones.ultima tiene timestamp
• Campo migraciones.pendientes es numero
• Historial de migraciones presente

---

3. BACKEND_INVENTORY.yml

3.1 Existencia

• Archivo existe si el proyecto tiene backend
• Ubicado en /orchestration/inventarios/

3.2 Metadata

• Campo metadata.proyecto presente
• Campo metadata.tipo es "BACKEND"
• Campo metadata.framework especificado
• Campo metadata.lenguaje especificado

3.3 Modulos

• Listado modulos existe
• Cada modulo tiene nombre y ruta
• Cada modulo tiene conteo de controllers/services
• Estados son validos (implementado|parcial|pendiente)

3.4 Endpoints

• Endpoints documentados por modulo
• Incluyen metodo HTTP y ruta
• Indican si requieren auth

3.5 Tests

• Seccion tests existe
• Cobertura de unit tests reportada
• Cobertura de integration tests reportada

---

4. FRONTEND_INVENTORY.yml

4.1 Existencia

• Archivo existe si el proyecto tiene frontend
• Ubicado en /orchestration/inventarios/

4.2 Metadata

• Campo metadata.proyecto presente
• Campo metadata.tipo es "FRONTEND"
• Campo metadata.framework especificado
• Campo metadata.lenguaje especificado

4.3 Aplicaciones

• Listado de aplicaciones frontend existe
• Cada app tiene nombre, ruta, puerto
• Paginas listadas por aplicacion

4.4 Paginas

• Cada pagina tiene nombre y ruta
• Estados son validos
• Roles de acceso documentados (si aplica)

4.5 Componentes

• Seccion de componentes shared existe
• Componentes de features organizados por feature

---

5. Validacion General

5.1 Sintaxis YAML

• Todos los archivos pasan validacion yamllint
• Indentacion es consistente (2 espacios)
• No hay tabs mezclados con espacios
• Strings con caracteres especiales estan entre comillas

5.2 Consistencia Entre Inventarios

• Modulos en BACKEND coinciden con estructura real
• Schemas en DATABASE coinciden con base de datos
• Paginas en FRONTEND coinciden con rutas reales
• Progreso en MASTER es consistente con otros inventarios

5.3 Numeros y Conteos

• Conteos de tablas/columnas son correctos
• Conteos de endpoints son correctos
• Porcentajes suman correctamente

---

Comandos de Validacion

# Validar sintaxis YAML
yamllint orchestration/inventarios/*.yml

# Verificar estructura
cat orchestration/inventarios/MASTER_INVENTORY.yml | yq '.metadata'

# Contar schemas
cat orchestration/inventarios/DATABASE_INVENTORY.yml | yq '.schemas | length'

# Verificar consistencia de puertos
grep -h "puerto:" orchestration/inventarios/*.yml | sort | uniq -d

---

Resultado de Validacion

Resumen

Inventario	Items	Cumplidos	Porcentaje
MASTER	17		%
DATABASE	14		%
BACKEND	12		%
FRONTEND	10		%
General	10		%
TOTAL	63		%

Errores Encontrados

{Listar errores especificos aqui}

Fecha de Validacion

• Validado por: {nombre/rol}
• Fecha: {YYYY-MM-DD}

---

Referencia: SIMCO-INVENTARIOS.md