Una vez que el sitio está en línea, el sitio en línea es el real: el cliente publica entradas, recibe leads, sube imágenes. Un campo nuevo, una página nueva u otro encabezado es un cambio de tema: lo haces en una copia, lo revisas y publicas solo el tema.
La publicación tiene versiones: cada una suma una versión sobre lo que está en línea y, antes, integra lo que otros publicaron. Nadie pierde su trabajo.
El ciclo seguro
-
Trae producción a tu computadora
Tu copia local se actualiza con el tema, las imágenes y el contenido del sitio en línea, sin datos personales, y trabajas con lo real. Si tiene cambios de tema aún sin publicar, la IA se detiene y pregunta: actualizar los sobrescribiría.
-
Cambia y revisa en local
Pide el cambio y míralo en el navegador y en el panel, también en el celular.
-
Publica solo el tema
Suben los archivos del tema. El contenido y la base de datos, nunca.
-
Revisa el sitio en línea
Abre las páginas que cambiaste.
Pídele a la IA
Baja el sitio de producción a mi computadora, para trabajar con el contenido real.
Pídelo al comienzo de cada ronda de cambios, no solo la primera vez.
Pídele a la IA
Publica el tema en el sitio en línea: el nuevo campo de video en los casos y la página del caso que lo muestra. Nada más.
La IA envía solo el tema y te responde con el número de la nueva versión y lo que integró del trabajo de otras personas.
Cómo funciona la publicación con versiones
El servidor guarda un registro de lo que está en línea: el número de versión, quién la publicó y cuándo, y una huella de cada archivo del tema. Tu copia recuerda de qué versión partió. Al publicar, la IA compara de dónde partiste, tu copia y lo que está en línea:
- Nada cambió en línea desde que partiste: tus cambios suben como la siguiente versión.
- Alguien publicó en el medio, o cambió archivos a mano en el servidor: sus cambios entran primero en tu copia, después todo se revisa y se publica. Un archivo que esa persona borró sale también de tu copia, y la IA te dice cuál.
Ejemplo: en línea está la v3, y tú y João parten de ella. João publica la v4. Cuando publicas, tu copia recibe sus cambios, se revisa y sube como v5.
Cuándo la IA se detiene y pregunta
| Situación | Qué pasa |
|---|---|
| Tú y otra persona cambiaron las mismas líneas, o el mismo archivo | Un conflicto. La IA te muestra en palabras simples cómo era el archivo, qué cambió cada lado y la combinación que propone, o te quedas con un lado entero. Nada sale en línea sin tu OK. |
| La publicación borraría archivos que están en línea | Los lista y pregunta. Sin un sí, no se borra nada. |
| Alguien está publicando ahora | Te dice quién y ofrece intentar de nuevo en un minuto. |
| Una publicación se detuvo a la mitad hace 15 minutos o más | Lo explica y pregunta antes de tomar el control. Una publicación cortada a la mitad se termina o se deshace en la siguiente acción: el sitio nunca queda publicado a medias. |
| El sitio ya fallaba antes de tu publicación | Te dice qué falla, que no fue tu cambio, y pregunta antes de publicar de todos modos, para enviar una corrección, por ejemplo. |
Las verificaciones en el camino
Con la copia local, antes de que algo salga de tu computadora, la IA revisa los archivos PHP del tema y ejecuta schema:validate, que detecta errores de estructura en el site.json (desde la v3.9.0 también avisa de plantillas declaradas cuyo archivo no existe, sin detener la publicación). En el servidor, el tema nuevo se prepara al lado del que está en línea, se revisa, entra en su lugar con dos renombres instantáneos y se prueba en línea: schema:validate, page:sync (que crea las páginas nuevas declaradas en el site.json y conserva lo que se escribió en el panel) y la página de inicio respondiendo sin error de servidor. Cualquier falla trae de vuelta el tema anterior al instante, y la versión no cambia.
Si el CSS o el JavaScript cambiaron y el tema los carga sin una versión en su dirección, la IA te avisa: los navegadores guardan esos archivos por un mes, así que quien vuelve al sitio vería el diseño anterior.
Qué lleva una publicación
Solo el tema: site.json, plantillas, partials, functions.php, estilos, scripts y las imágenes del tema. Nunca el contenido, storage/uploads/, el .env del servidor ni la base de datos, y nunca archivos de respaldo o de sistema (*.bak, .DS_Store) ni archivos PHP en la raíz del tema salvo functions.php. Una versión nueva de Velk es otro pedido (Actualizar Velk).
Preguntas frecuentes
Somos dos personas en el mismo tema. ¿Necesitamos Git?
Para publicar, no: cada publicación integra lo que los demás publicaron. Git sigue siendo útil para tu propio historial, pero nada de .git va al servidor ni viene de él.
La primera publicación pregunta por cada archivo que cambié. ¿Por qué?
Tu copia todavía no tiene un punto de partida, porque nunca se trajo del sitio en línea: la carpeta desde la que hiciste el despliegue, por ejemplo, o un sitio que salió en línea antes de la publicación con versiones. Cada archivo del tema distinto del que está en línea se vuelve una pregunta; la IA pregunta y, cuando tu copia es la que vale, se queda con ella. Después de esa publicación, ya lo recuerda.