⚡ QUICK VALIDATION GUIDE¶

Test rápido de la migración completada.

✅ Pre-requisitos¶

Docker instalado y funcionando
Docker Compose instalado
PowerShell 5.1+ (Windows) o Bash (Linux/Mac)

🧪 Tests Rápidos¶

1️⃣ Test MkDocs Service (2 minutos)¶

cd "2 - FOUNDATION/03_INFRA/03_05_containerization/03_06_06_mkdocs_service"

# Build
docker-compose build

# Start
docker-compose up -d

# Verificar logs
docker-compose logs

# Acceder
# Abrir: http://localhost:8000

# Cleanup
docker-compose down

Esperado: - ✅ Container builds sin errores - ✅ Logs muestran "Serving on http://0.0.0.0:8000" - ✅ Navegador muestra página de MkDocs - ✅ Scripts Python ejecutan sin errores

2️⃣ Test Services Stack (3 minutos)¶

cd "2 - FOUNDATION/03_INFRA/03_05_containerization/03_06_07_services_stack"

# Configurar secrets
cp .env.example .env
# Editar .env: cambiar POSTGRES_PASSWORD=test123

# Start stack
docker-compose up -d

# Esperar 10 segundos
Start-Sleep -Seconds 10

# Verificar PostgreSQL
docker exec -it audiolab_postgres psql -U audiolab -d audiolab_main -c "\dt audiolab.*"

# Verificar servicios
docker ps --filter "label=audiolab.service"

# Cleanup
docker-compose down -v

Esperado: - ✅ 3 containers corriendo (postgres, fossflow, mkdocs) - ✅ PostgreSQL muestra 3 tablas: plugins, components, presets - ✅ Todos los health checks pasan - ✅ No errores en logs

3️⃣ Test Management Scripts (1 minuto)¶

cd "2 - FOUNDATION/03_INFRA/03_05_containerization/scripts"

# Windows PowerShell
.\stack-manager.ps1 -Action status

# Linux/Mac
./stack-manager.sh status

Esperado: - ✅ Script ejecuta sin errores - ✅ Muestra tabla de servicios - ✅ Muestra URLs de acceso

4️⃣ Test Hierarchy Scanner (2 minutos)¶

cd "2 - FOUNDATION/03_INFRA/03_05_containerization/03_06_06_mkdocs_service"

# Start service
docker-compose up -d

# Run hierarchy scan
docker exec -it audiolab_mkdocs python /opt/scripts/discover_hierarchy.py

# Ver resultado
docker exec -it audiolab_mkdocs cat /opt/scripts/nav_structure.yml

# Cleanup
docker-compose down

Esperado: - ✅ Script escanea repositorio - ✅ Encuentra archivos .md - ✅ Genera nav_structure.yml - ✅ YAML es válido

5️⃣ Test Backup Script (1 minuto)¶

cd "2 - FOUNDATION/03_INFRA/03_05_containerization"

# Start services
.\scripts\stack-manager.ps1 -Action start

# Run backup
.\scripts\backup-all.ps1

# Verificar backup
ls ..\..\..\..\backups\

# Cleanup
.\scripts\stack-manager.ps1 -Action stop

Esperado: - ✅ Directorio backup creado con timestamp - ✅ Archivos .tar.gz para cada volumen - ✅ Carpeta configs/ con configuraciones - ✅ postgres_dump.sql creado

🔍 Verificación de Integración¶

PostgreSQL Schema¶

docker exec -it audiolab_postgres psql -U audiolab -d audiolab_main

-- Ver schemas
\dn

-- Ver tablas
\dt audiolab.*
\dt metadata.*
\dt analytics.*

-- Ver datos de ejemplo
SELECT * FROM audiolab.plugins;

-- Ver vista
SELECT * FROM audiolab.project_status;

-- Salir
\q

FossFLOW Integration¶

# Verificar volumes montados
docker exec -it audiolab_fossflow ls -la /app/exports

# Debería mostrar link a:
# 07_META/03_documentation/docs/3_diagrams

# Ver navegación generada
docker exec -it audiolab_mkdocs cat /docs/mkdocs.yml

# Debería contener 'nav:' con estructura jerárquica

🎯 One-Command Full Test¶

# Windows
cd "2 - FOUNDATION/03_INFRA/03_05_containerization"

# Setup
cd 03_06_07_services_stack
cp .env.example .env
# Editar .env manualmente

# Test completo
cd ..\scripts
.\stack-manager.ps1 -Action start
Start-Sleep -Seconds 10
docker ps --filter "label=audiolab.service"
docker exec -it audiolab_postgres psql -U audiolab -d audiolab_main -c "SELECT * FROM audiolab.plugins;"
.\stack-manager.ps1 -Action backup
.\stack-manager.ps1 -Action stop

✅ Checklist Final¶

MkDocs builds y sirve en :8000
PostgreSQL inicializa con schema correcto
FossFLOW conecta y monta volúmenes
Scripts PowerShell/Bash funcionan
Backup genera archivos correctamente
Hierarchy scanner encuentra .md files
Network audiolab_network se crea
Volúmenes persisten datos

🚨 Troubleshooting¶

Error: "network audiolab_network not found"¶

docker network create audiolab_network --subnet=172.25.0.0/16

Error: "permission denied" (Linux/Mac)¶

chmod +x scripts/*.sh
chmod +x 03_06_06_mkdocs_service/scripts/*.sh

Error: "POSTGRES_PASSWORD not set"¶

cd 03_06_07_services_stack
cp .env.example .env
# Edit .env and set password

PostgreSQL no inicia¶

# Ver logs
docker logs audiolab_postgres

# Recrear volumen
docker-compose down -v
docker-compose up -d

Tiempo total de validación: ~10 minutos Resultado esperado: ✅ Todos los tests pasan