Metodología con Backups

Esta es la metodología recomendada para trabajar en equipo con GitSCase. Combina backups de ScriptCase con versionamiento Git para asegurar que todo el equipo trabaje sobre la misma base.

Concepto clave

Todos deben partir de la misma versión de ScriptCase.

GitSCase versiona el código (eventos, métodos, SQL, configuraciones), pero ScriptCase tiene muchas cosas que no son código (estructura de base de datos, conexiones, configuraciones internas, etc.).

Para evitar problemas, el equipo debe:

1. Partir del mismo backup de ScriptCase (versión base común)
2. Versionar el código con GitSCase (cambios progresivos)
3. Sincronizar cambios via GitHub (todos reciben lo mismo)

Setup inicial del equipo

Paso 1: Líder prepara la versión base

El líder del proyecto (o quien tenga la versión más actualizada):

1. Abre su proyecto en ScriptCase — La versión que será la base del equipo
2. Vincula el proyecto en GitSCase — Configura la carpeta local
3. Hace Primera Detección — Escanea TODO el proyecto
4. Hace Commit — Guarda todo en la carpeta local
5. Sube a GitHub — Publica el repositorio (privado)

En GitSCase:

1. Abrir ScriptCase desde GitSCase
2. Abrir el proyecto en ScriptCase
3. GitSCase → Tab "Detectar cambios" → "Primera detección"
4. GitSCase → Tab "Commit" → Seleccionar todo → Commit

En GitHub Desktop:

1. File → Add local repository
2. Seleccionar la carpeta del proyecto
3. Create repository
4. Commit to main
5. Publish repository (marcar como Privado)

Paso 2: Líder crea el backup de ScriptCase

Importante: Este backup debe hacerse después de subir a GitHub, para que ambos estén sincronizados.

1. En ScriptCase, haz clic derecho en el proyecto
2. Selecciona "Backup"
3. Guarda el archivo .zip en un lugar seguro
4. Comparte este .zip con todo el equipo

Paso 3: Equipo restaura el backup

Cada desarrollador:

1. Descarga el backup que compartió el líder
2. Restaura el backup en ScriptCase:
   • ScriptCase → Backup → Restore
   • Selecciona el archivo .zip
   • Espera a que termine
3. Clona el repositorio de GitHub:
   • GitHub Desktop → Clone repository
   • Selecciona el repo del equipo
   • Elige carpeta local
4. Vincula el proyecto en GitSCase:
   • Abre ScriptCase desde GitSCase
   • Abre el proyecto en ScriptCase
   • GitSCase detectará el proyecto
   • Configura carpeta → Selecciona la carpeta clonada

Flujo de trabajo diario

Desarrollador hace cambios

1. Trabaja en ScriptCase — Modifica eventos, métodos, SQL
2. GitSCase detecta los cambios — Automáticamente
3. Hace commit en GitSCase — Guarda en carpeta local
4. Hace commit + push en GitHub — Sube los cambios

Ejemplo:

Dev A trabaja en form_usuarios:
1. Modifica onExecute.php
2. GitSCase → Tab "Commit" → Selecciona el cambio → Commit
3. GitHub Desktop → Commit to main → Push origin
4. Avisa en el chat: "Subí cambios en form_usuarios"

Equipo recibe los cambios

1. Hace pull en GitHub Desktop — Descarga los cambios
2. Detecta cambios en GitSCase — Compara repo vs ScriptCase
3. Aplica los cambios — GitSCase los escribe en ScriptCase
4. Refresca ScriptCase — Ve los cambios aplicados

Ejemplo:

Dev B recibe los cambios de Dev A:
1. GitHub Desktop → Pull origin
2. GitSCase → Tab "Detectar cambios" → Detectar → Aplicar
3. ScriptCase → F5 (refrescar)
4. Ahora tiene los cambios de Dev A

Ventajas de este flujo

✅ Todos parten de la misma base

El backup asegura que todos tienen:

• La misma estructura de base de datos
• Las mismas conexiones
• Las mismas configuraciones internas de ScriptCase
• Las mismas aplicaciones

✅ Cambios progresivos

En lugar de implementar muchos cambios de golpe manualmente:

• Cada desarrollador sube sus cambios cuando los termina
• Los demás los reciben y aplican de uno en uno
• Nadie pierde cambios
• GitHub registra quién hizo qué y cuándo

✅ Backups desactualizados no son problema

Si un nuevo desarrollador se une al equipo:

1. Recibe el backup (puede estar desactualizado)
2. Restaura el backup en ScriptCase
3. Clona el repositorio de GitHub (versión actual)
4. Vincula en GitSCase
5. Detecta y aplica cambios — GitSCase actualiza el código automáticamente

Resultado: El nuevo desarrollador queda sincronizado con el equipo, aunque el backup tenga 5, 10 o 20 cambios atrás.

Qué versiona GitSCase

✅ Sí versiona (código)

• Eventos PHP (onExecute, onValidate, etc.)
• Métodos PHP
• Consultas SQL
• Librerías externas (CSS, JS)
• Librerías internas (PHP compartido)

❌ No versiona (no-code)

• Estructura de base de datos
• Conexiones a base de datos
• Configuraciones internas de ScriptCase
• Permisos y usuarios de ScriptCase
• Configuraciones del servidor

Por eso es importante el backup: Asegura que todos tengan las mismas configuraciones no-code.

Casos de uso

Caso 1: Equipo nuevo empieza proyecto

1. Líder crea el proyecto en ScriptCase
2. Líder hace primera detección y sube a GitHub
3. Líder crea backup y lo comparte
4. Equipo restaura backup y clona repo
5. Todos empiezan a trabajar

Caso 2: Desarrollador nuevo se une

1. Recibe el backup (puede estar desactualizado)
2. Restaura el backup
3. Clona el repositorio de GitHub
4. Vincula en GitSCase
5. Detecta y aplica cambios (se actualiza automáticamente)

Caso 3: Cambio grande en estructura

Si el líder hace un cambio grande en la estructura de ScriptCase (nueva conexión, nueva tabla, etc.):

1. Líder hace los cambios en ScriptCase
2. Líder versiona el código con GitSCase
3. Líder crea un nuevo backup
4. Líder avisa al equipo
5. Equipo restaura el nuevo backup
6. Equipo hace pull y aplica cambios

Rutina recomendada

Diaria (mañana)

1. Abrir GitHub Desktop → Pull
2. Abrir GitSCase → Detectar cambios → Aplicar
3. Refrescar ScriptCase
4. Empezar a trabajar

Diaria (tarde)

1. GitSCase → Commit
2. GitHub Desktop → Commit + Push
3. Avisar en el chat qué se subió

Semanal (líder)

1. Revisar que el repo esté limpio
2. Verificar que no haya conflictos pendientes
3. (Opcional) Crear backup actualizado por si acaso

Consejos

✅ Hacer

• Partir del mismo backup siempre
• Hacer pull al menos 2 veces al día
• Commitear cambios frecuentemente
• Avisar en el chat cuando subes cambios importantes
• Crear nuevo backup si hay cambios estructurales

❌ Evitar

• Que cada uno use su propia versión de ScriptCase sin backup común
• Acumular muchos cambios sin subir
• Hacer cambios estructurales sin avisar al equipo
• Ignorar conflictos

Solución de problemas

"Mi ScriptCase no tiene las mismas conexiones que el equipo"

Causa: No restauraste el backup base.

Solución:

1. Pide el backup al líder
2. Restaura el backup en ScriptCase
3. Vincula de nuevo en GitSCase
4. Detecta y aplica cambios

"Apliqué cambios pero no funcionan"

Causa: Puede ser un cambio no-code que no está en el backup.

Solución:

1. Pregunta al equipo si hubo cambios estructurales
2. Pide el backup actualizado
3. Restaura el backup

"Soy nuevo y el backup está muy desactualizado"

No hay problema:

1. Restaura el backup viejo
2. Clona el repo de GitHub
3. Vincula en GitSCase
4. Detecta y aplica cambios
5. GitSCase te actualiza automáticamente

Próximos pasos

• Commit — Guarda tus cambios
• Detección — Recibe cambios de otros
• Colaboración — Trabaja en equipo