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

```markdown
[ ] 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

```markdown
[ ] 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

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

### 1.4 Subcarpetas Devtools

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

---

## CHECKLIST DE ARCHIVOS

### 2.1 READMEs

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

### 2.2 Registries

```markdown
[ ] 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

```markdown
[ ] 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

```markdown
[ ] 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

```markdown
[ ] 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

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

### 3.3 databases.registry.yml

```markdown
[ ] 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

```markdown
[ ] 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

```bash
#!/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:** _________