Guía de referencia · Edu

CreaRack Pro · Flujo de trabajo completo Última actualización: Abril 2026

Estructura de directorios

C:\dev\
├── CreaRack-Pro\           → código fuente de la aplicación
└── CreaRackSL-workspace\   → contexto Claude + documentación del equipo

Repos en GitHub

Flujo de trabajo diario

Inicio de sesión de desarrollo

cd C:\dev\CreaRack-Pro
git pull origin main
docker compose up -d
claude

Claude Code leerá CLAUDE.md automáticamente — no hace falta hacer nada más.

Fin de sesión

Claude Code gestiona los commits. Verificar que todo está subido:

git status
git push origin main

Gestión del workspace

Cuándo actualizar el workspace

Solo ante cambios significativos — no en cada commit:

• Nueva dependencia o cambio de versión relevante
• Nuevo módulo o app Django
• Cambio de arquitectura o decisión técnica importante
• Nueva integración (API, servicio, herramienta)

Claude Code lo hará automáticamente cuando detecte estos cambios y te avisará con: ⚠ CreaRackSL-workspace actualizado: [archivos modificados]

Actualización manual del workspace

Si necesitas editar algo manualmente:

cd C:\dev\CreaRackSL-workspace
# Editar el archivo correspondiente
git add .
git commit -m "sync: [descripción del cambio]"
git push origin main

Archivos del workspace y cuándo tocarlos

Gestión del equipo en GitHub

Invitar a Dani o Txell

Para cada repo en github.com/CreaRackSL:

• Settings → Collaborators → Add people → username de GitHub

Si alguien pierde acceso

github.com/CreaRackSL/[repo] → Settings → Collaborators → volver a invitar

Acceso SSH a producción (Hetzner)

# Conectar al servidor
ssh root@crearack.com

# Ver estado de contenedores
ssh root@crearack.com "docker ps"

# Logs de la aplicación
ssh root@crearack.com "docker logs crearack-pro-zcmvsl-web-1 --tail 50"

# Reiniciar la app en producción
ssh root@crearack.com "docker restart crearack-pro-zcmvsl-web-1"

Cambio de nombre de empresa

Cuando tengáis el nombre definitivo, en PowerShell desde cada repo:

# Workspace
cd C:\dev\CreaRackSL-workspace
Get-ChildItem -Path . -Filter *.md -Recurse | ForEach-Object {
    (Get-Content $_.FullName) -replace 'CreaRackSL', 'NombreDefinitivo' |
    Set-Content $_.FullName
}
git add .
git commit -m "refactor: renombrar CreaRackSL → NombreDefinitivo"
git push origin main

# Código
cd C:\dev\CreaRack-Pro
git add CLAUDE.md
git commit -m "refactor: renombrar CreaRackSL → NombreDefinitivo en CLAUDE.md"
git push origin main

Después renombrar los repos en GitHub:

• github.com/CreaRackSL/CreaRack-Pro → Settings → Rename
• github.com/CreaRackSL/CreaRackSL-workspace → Settings → Rename

Y actualizar los remotes locales:

cd C:\dev\CreaRack-Pro
git remote set-url origin https://github.com/NombreDefinitivo/CreaRack-Pro.git

cd C:\dev\CreaRackSL-workspace
git remote set-url origin https://github.com/NombreDefinitivo/NombreDefinitivo-workspace.git

Referencia rápida de comandos

Desarrollo

Con observabilidad (VictoriaMetrics)

docker compose -f compose.yml -f compose.observability.yml up -d

URLs de desarrollo

Onboarding del equipo

Las guías de Dani y Txell están en:

C:\dev\CreaRackSL-workspace\docs\technical\
├── onboarding-dani.md
└── onboarding-txell.md

Cuando se incorporen, enviarles el enlace al repo o el archivo directamente.