3a8a459d91
## Directivas SIMCO v3.7.0 - Estandarizacion de Documentacion (7) - SIMCO-DOCUMENTACION-PROYECTO.md - SIMCO-NOMENCLATURA.md - SIMCO-ESTRUCTURA-DOCS.md - SIMCO-INVENTARIOS.md - SIMCO-TESTING.md - SIMCO-MIGRACIONES-BD.md - SIMCO-INTEGRACIONES-EXTERNAS.md ## Directivas SIMCO v3.8.0 - Mantenimiento de Documentacion (2) - SIMCO-MANTENIMIENTO-DOCUMENTACION.md - SIMCO-SINCRONIZACION-BD.md ## Templates (4) - TEMPLATE-INVENTARIO-PROYECTO.md - TEMPLATE-INTEGRACION-EXTERNA.md - TEMPLATE-MODULO-ESTANDAR.md - TEMPLATE-DEPRECACION.md ## Checklists (6) - CHECKLIST-DOCUMENTACION-PROYECTO.md - CHECKLIST-INVENTARIOS.md - CHECKLIST-NOMENCLATURA.md - CHECKLIST-MANTENIMIENTO-DOCS.md - CHECKLIST-SINCRONIZACION-BD.md - _MAP.md ## Perfil de Agente (1) - PERFIL-DOCUMENTATION-MAINTAINER.md ## Indices - INDICE-DIRECTIVAS-WORKSPACE.yml actualizado a v3.8.0 ## Submodulos actualizados (14) - gamilit, erp-core, michangarrito, template-saas - erp-suite, erp-construccion, erp-clinicas - erp-mecanicas-diesel, erp-retail, erp-vidrio-templado - trading-platform, betting-analytics - inmobiliaria-analytics, platform_marketing_content Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
230 lines
5.5 KiB
Markdown
230 lines
5.5 KiB
Markdown
# 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
|