workspace-v1/01-fase-control-plane/VALIDACION/CHECKLIST.md

FASE 1 - CHECKLIST DE VALIDACION

Fase: 1 - Control Plane Estado: Pendiente Validador: Tech-Leader

---

CHECKLIST DE ESTRUCTURA

1.1 Carpetas Principales

[ ] control-plane/ existe
[ ] control-plane/orchestration/ existe
[ ] control-plane/registries/ existe
[ ] control-plane/manifests/ existe
[ ] control-plane/ci/ existe
[ ] control-plane/devtools/ existe
[ ] control-plane/docs/ existe

1.2 Subcarpetas Orchestration

[ ] orchestration/agents/perfiles/ existe
[ ] orchestration/agents/legacy/ existe
[ ] orchestration/directivas/simco/ existe
[ ] orchestration/directivas/principios/ existe
[ ] orchestration/templates/ existe
[ ] orchestration/checklists/ existe
[ ] orchestration/patrones/ existe
[ ] orchestration/referencias/ existe

1.3 Subcarpetas CI

[ ] ci/jenkins/Jenkinsfile.templates/ existe
[ ] ci/jenkins/shared-library/ existe
[ ] ci/github-actions/workflows/ existe

1.4 Subcarpetas Devtools

[ ] devtools/scripts/validation/ existe
[ ] devtools/scripts/bootstrap/ existe
[ ] devtools/docker/ existe
[ ] devtools/configs/ existe

---

CHECKLIST DE ARCHIVOS

2.1 READMEs

[ ] control-plane/README.md existe y tiene contenido
[ ] registries/README.md existe
[ ] manifests/README.md existe
[ ] devtools/README.md existe

2.2 Registries

[ ] registries/ports.registry.yml existe
[ ] registries/ports.registry.yml es YAML valido
[ ] registries/ports.registry.yml tiene estructura correcta (rules, allocations)

[ ] registries/domains.registry.yml existe
[ ] registries/domains.registry.yml es YAML valido

[ ] registries/databases.registry.yml existe
[ ] registries/databases.registry.yml es YAML valido

[ ] registries/services.registry.yml existe
[ ] registries/services.registry.yml es YAML valido

2.3 Manifests

[ ] manifests/repos.manifest.yml existe
[ ] manifests/repos.manifest.yml es YAML valido
[ ] manifests/repos.manifest.yml lista todos los repos

[ ] manifests/environments.manifest.yml existe
[ ] manifests/environments.manifest.yml es YAML valido
[ ] manifests/environments.manifest.yml define local, dev, staging, prod

2.4 Scripts de Validacion

[ ] devtools/scripts/validation/validate-ports.sh existe
[ ] devtools/scripts/validation/validate-ports.sh es ejecutable
[ ] devtools/scripts/validation/validate-ports.sh ejecuta sin errores

[ ] devtools/scripts/validation/validate-domains.sh existe
[ ] devtools/scripts/validation/validate-domains.sh es ejecutable

[ ] devtools/scripts/validation/validate-databases.sh existe
[ ] devtools/scripts/validation/validate-databases.sh es ejecutable

[ ] devtools/scripts/validation/validate-all.sh existe
[ ] devtools/scripts/validation/validate-all.sh ejecuta todos los otros

---

CHECKLIST DE CONTENIDO

3.1 ports.registry.yml

[ ] Tiene seccion 'rules' con reglas de puertos publicos
[ ] Tiene seccion 'infrastructure' con traefik, postgres, redis
[ ] Tiene seccion 'projects' con todos los proyectos del workspace
[ ] Cada proyecto tiene sus servicios con puertos asignados
[ ] No hay puertos duplicados entre proyectos
[ ] Puertos siguen las convenciones de rangos definidas

3.2 domains.registry.yml

[ ] Define dominios base (produccion, development, local)
[ ] Cada proyecto tiene dominios por ambiente
[ ] Dominios siguen patron consistente

3.3 databases.registry.yml

[ ] Define instancia PostgreSQL
[ ] Cada proyecto tiene su BD definida
[ ] Cada BD tiene roles (owner, runtime, migrator)
[ ] Tiene politicas de seguridad documentadas

3.4 repos.manifest.yml

[ ] Lista control-plane
[ ] Lista todos los productos (gamilit, erp-suite, trading, betting)
[ ] Lista shared repos (shared-libs, shared-infra, knowledge-base)
[ ] Cada repo tiene path, type y stack definidos

---

VALIDACION AUTOMATIZADA

Comando de Validacion

#!/bin/bash
# validate-phase1.sh

CONTROL_PLANE="/home/adrian/Documentos/workspace-v1/control-plane"

echo "=== Validando Fase 1: Control Plane ==="

# Verificar estructura
echo "Verificando estructura..."
REQUIRED_DIRS=(
    "orchestration"
    "registries"
    "manifests"
    "ci"
    "devtools"
    "docs"
)

for dir in "${REQUIRED_DIRS[@]}"; do
    if [ -d "$CONTROL_PLANE/$dir" ]; then
        echo "  [OK] $dir/"
    else
        echo "  [FAIL] $dir/ no existe"
        exit 1
    fi
done

# Verificar YAMLs
echo "Verificando archivos YAML..."
YAML_FILES=(
    "registries/ports.registry.yml"
    "registries/domains.registry.yml"
    "registries/databases.registry.yml"
    "manifests/repos.manifest.yml"
    "manifests/environments.manifest.yml"
)

for file in "${YAML_FILES[@]}"; do
    if [ -f "$CONTROL_PLANE/$file" ]; then
        if python3 -c "import yaml; yaml.safe_load(open('$CONTROL_PLANE/$file'))" 2>/dev/null; then
            echo "  [OK] $file"
        else
            echo "  [FAIL] $file - YAML invalido"
            exit 1
        fi
    else
        echo "  [FAIL] $file no existe"
        exit 1
    fi
done

# Verificar scripts
echo "Verificando scripts..."
SCRIPTS=(
    "devtools/scripts/validation/validate-ports.sh"
)

for script in "${SCRIPTS[@]}"; do
    if [ -x "$CONTROL_PLANE/$script" ]; then
        echo "  [OK] $script"
    else
        echo "  [FAIL] $script no existe o no es ejecutable"
        exit 1
    fi
done

echo ""
echo "=== Fase 1 validada exitosamente ==="

---

CRITERIOS DE APROBACION

Para aprobar esta fase:

1. 100% de estructura creada - Todas las carpetas existen
2. 100% de archivos creados - Todos los archivos listados existen
3. 100% YAML valido - Todos los archivos YAML parsean correctamente
4. Scripts funcionales - Los scripts de validacion ejecutan sin errores
5. Documentacion completa - READMEs en carpetas principales

---

SIGUIENTE FASE

Una vez aprobada la Fase 1, proceder a:

Fase 2: Core Orchestration

• Migracion de SIMCO
• Actualizacion de perfiles de agentes
• Creacion del Service Descriptor Standard

---

Validador: Tech-Leader Fecha de Validacion: _________ Estado: [ ] Aprobado [ ] Rechazado Notas: _________