# 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

```bash
# 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