workspace-v1/04-fase-proyectos/gamilit/VALIDACION/CHECKLIST.md

GAMILIT - CHECKLIST DE VALIDACION

Proyecto: Gamilit Platform Fase: 4.1 - Migracion de Gamilit Estado: Pendiente

---

ESTRUCTURA

[ ] gamilit-platform/ existe
[ ] apps/backend/ existe
[ ] apps/frontend/ existe
[ ] apps/database/ existe
[ ] docker/ existe
[ ] orchestration/ existe
[ ] docs/ existe
[ ] .github/workflows/ existe

---

SERVICE DESCRIPTORS

apps/backend/service.descriptor.yml

[ ] Archivo existe
[ ] Es YAML valido
[ ] service.name = "gamilit-api"
[ ] service.type = "backend"
[ ] service.runtime = "node"
[ ] service.owner_agent = "NEXUS-BACKEND"
[ ] ports.internal = 3000
[ ] ports.registry_ref = "projects.gamilit.api"
[ ] database.registry_ref = "gamilit"
[ ] ci.docker = true

apps/frontend/service.descriptor.yml

[ ] Archivo existe
[ ] Es YAML valido
[ ] service.name = "gamilit-web"
[ ] service.type = "frontend"
[ ] service.runtime = "static"
[ ] service.owner_agent = "NEXUS-FRONTEND"
[ ] ports.internal = 3001
[ ] ports.registry_ref = "projects.gamilit.web"
[ ] dependencies.services incluye "gamilit-api"

---

CODIGO MIGRADO

Backend

[ ] package.json existe
[ ] package.json tiene scripts: build, dev, test, lint
[ ] tsconfig.json existe
[ ] src/ existe con codigo
[ ] Dockerfile existe
[ ] npm install ejecuta sin errores
[ ] npm run build ejecuta sin errores
[ ] npm run lint ejecuta sin errores (o warnings aceptables)

Frontend

[ ] package.json existe
[ ] package.json tiene scripts: build, dev, test, lint
[ ] src/ existe con codigo
[ ] Dockerfile existe
[ ] npm install ejecuta sin errores
[ ] npm run build ejecuta sin errores

Database

[ ] ddl/ existe con scripts DDL
[ ] seeds/ existe (puede estar vacio)
[ ] migrations/ existe (puede estar vacio)

---

DOCKER

docker/docker-compose.yml

[ ] Archivo existe
[ ] Es YAML valido (docker-compose config)
[ ] Service gamilit-api definido
    [ ] Usa expose (NO ports)
    [ ] Puerto 3000 expuesto
    [ ] Labels de Traefik configurados
    [ ] Host = api.gamilit.localhost
    [ ] Healthcheck definido
    [ ] Networks: gamilit_${ENV:-local}, infra_shared
[ ] Service gamilit-web definido
    [ ] Usa expose (NO ports)
    [ ] Puerto 3001 expuesto
    [ ] Labels de Traefik configurados
    [ ] Host = gamilit.localhost
    [ ] depends_on: gamilit-api
    [ ] Networks: gamilit_${ENV:-local}, infra_shared
[ ] Networks son external: true

docker/.env.example

[ ] Archivo existe
[ ] Variables documentadas:
    [ ] NODE_ENV
    [ ] DATABASE_URL
    [ ] JWT_SECRET
    [ ] REACT_APP_API_URL
[ ] No contiene valores reales/secretos

---

ORCHESTRATION

[ ] orchestration/inventarios/ migrado
[ ] orchestration/trazas/ migrado (si existe)
[ ] orchestration/00-guidelines/ migrado (si existe)
[ ] Paths actualizados en archivos migrados

---

ROOT FILES

[ ] package.json existe
    [ ] Define workspaces: ["apps/backend", "apps/frontend"]
    [ ] Scripts de root definidos
[ ] README.md existe
    [ ] Describe el proyecto
    [ ] Instrucciones de setup
    [ ] Instrucciones de desarrollo
[ ] .gitignore existe
    [ ] Ignora node_modules
    [ ] Ignora .env (pero no .env.example)
    [ ] Ignora dist/build

---

VALIDACION FUNCIONAL

Build

# Backend
cd apps/backend
npm install
npm run build
# [ ] Resultado: SUCCESS

# Frontend
cd apps/frontend
npm install
npm run build
# [ ] Resultado: SUCCESS

Docker

# Verificar config
cd docker
docker-compose config
# [ ] Resultado: Sin errores

# Levantar servicios (requiere Traefik y redes)
docker-compose up -d
# [ ] Resultado: Servicios levantan

# Verificar health
curl -f http://api.gamilit.localhost/health
# [ ] Resultado: HTTP 200

curl -f http://gamilit.localhost
# [ ] Resultado: HTTP 200

Integracion con Control Plane

# Validar service descriptors contra registries
./control-plane/devtools/scripts/validation/validate-service-descriptors.sh gamilit-platform/
# [ ] Resultado: Sin errores

# Validar puertos
./control-plane/devtools/scripts/validation/validate-ports.sh
# [ ] Resultado: Sin conflictos

---

VALIDACION AUTOMATIZADA

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

PROJECT_DIR="/home/adrian/Documentos/workspace-v1/repos/gamilit-platform"

echo "=== Validando Migracion de Gamilit ==="

# 1. Verificar estructura
echo "Verificando estructura..."
REQUIRED_DIRS=(
    "apps/backend"
    "apps/frontend"
    "apps/database"
    "docker"
    "orchestration"
)

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

# 2. Verificar service descriptors
echo ""
echo "Verificando service descriptors..."
for svc in "apps/backend" "apps/frontend"; do
    descriptor="$PROJECT_DIR/$svc/service.descriptor.yml"
    if [ -f "$descriptor" ]; then
        if python3 -c "import yaml; yaml.safe_load(open('$descriptor'))" 2>/dev/null; then
            echo "  [OK] $svc/service.descriptor.yml (YAML valido)"
        else
            echo "  [FAIL] $svc/service.descriptor.yml (YAML invalido)"
        fi
    else
        echo "  [FAIL] $svc/service.descriptor.yml no existe"
    fi
done

# 3. Verificar docker-compose
echo ""
echo "Verificando docker-compose..."
if [ -f "$PROJECT_DIR/docker/docker-compose.yml" ]; then
    cd "$PROJECT_DIR/docker"
    if docker-compose config > /dev/null 2>&1; then
        echo "  [OK] docker-compose.yml valido"
    else
        echo "  [FAIL] docker-compose.yml invalido"
    fi
else
    echo "  [FAIL] docker-compose.yml no existe"
fi

# 4. Verificar que NO hay puertos expuestos directamente
echo ""
echo "Verificando puertos..."
if grep -q "ports:" "$PROJECT_DIR/docker/docker-compose.yml" 2>/dev/null; then
    echo "  [WARN] docker-compose.yml usa 'ports:' - verificar que sea necesario"
else
    echo "  [OK] docker-compose.yml no expone puertos directamente"
fi

# 5. Verificar redes externas
echo ""
echo "Verificando redes..."
if grep -q "external: true" "$PROJECT_DIR/docker/docker-compose.yml" 2>/dev/null; then
    echo "  [OK] Redes configuradas como external"
else
    echo "  [FAIL] Redes no son external"
fi

echo ""
echo "=== Validacion completada ==="

---

CRITERIOS DE APROBACION

Para aprobar la migracion de Gamilit:

1. 100% estructura creada
2. Service descriptors validos y completos
3. Build exitoso (backend y frontend)
4. Docker compose funcional
   • No expone puertos directamente
   • Usa redes externas
   • Labels de Traefik correctos
5. Servicios accesibles via Traefik
6. Codigo funcional (healthcheck responde)

---

SIGUIENTE PROYECTO

Una vez aprobado Gamilit, proceder a:

ERP Suite (Fase 4.2)

• Estructura multi-vertical
• Mas complejo por tener verticales

---

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