Solo para el mantenedor · Camilo

Manual de mantenimiento

Cómo funcionan las versiones, cómo publicar cada semana, qué mostrar en la demo y qué pedirle a quien está de turno.

Cómo llegar aquí: directo en programas-tierra-linda.pages.dev/mantenimiento.html, o desde la aplicación abierta con ?publicar, botón ⚙️ Mantenimiento. Los autores no ven ese botón, así que esta página no les aparece por ningún lado. Conviene tener las dos direcciones en favoritos.

1. Las tres versiones que existen

Casi todos los enredos que puedan pasar salen de confundir estas tres cosas. Son distintas y viven en lugares distintos.

VersiónDónde viveQuién la veSe actualiza
La copia de cada persona En el teléfono o computador de quien edita Solo esa persona, en ese equipo Sola, con cada tecla
El enlace (editable o de solo lectura) Dentro de la dirección, comprimido Quien reciba el enlace Nunca. Es una foto del momento en que se copió
El programa publicado programas/AAAA-MM-DD.json en el repositorio Todos los que entren a la página sin enlace y sin copia propia Cuando yo hago commit y push
El enlace es una foto. Lo publicado es el original.

Consecuencia práctica: si Andrés me manda su enlace y después sigue corrigiendo, su enlace no cambia. Tiene que mandarme uno nuevo, o yo publico y quedamos sobre lo publicado.

2. El flujo de una semana

1

Jueves o viernes: el de turno arma el programaautor

Abre programas-tierra-linda.pages.dev. Le sale el programa publicado del sábado anterior, edita fecha, etiquetas del encabezado y espacios. Puede usar 🗂️ Programas para partir de otro sábado parecido.

2

Me manda el enlace editableautor

Botón 🔗 Enlace editable y me lo pega por WhatsApp. Ese enlace ya trae el programa completo adentro, no necesita mandarme nada más.

3

Lo reviso y lo publicoyo

Abro su enlace. Como yo tengo copia propia guardada, la página me pregunta si reemplazo la mía: le digo que sí (mi copia no importa, la oficial es la que voy a publicar). Reviso horas y nombres, y sigo el paso 3 de abajo.

4

Se reparteautor

Ya publicado, el de turno manda al grupo el 👁️ Enlace de solo lectura o el PDF. El programa queda cerrado y nadie lo cambia sin querer.

Por qué este orden: el paso 3 es el que crea la única versión oficial. Si nos saltamos ese paso, lo que circula son fotos sueltas y el sábado aparecen dos programas distintos. Es exactamente el problema que veníamos teniendo con las fotos de WhatsApp.

3. Publicar, paso a paso

  1. Abrir mi enlace de trabajo: programas-tierra-linda.pages.dev/?publicar (si vengo del enlace de otra persona, agregarle ?publicar antes del #).
  2. Verificar arriba a la derecha el sello ⚙️ Modo publicación.
  3. Botón ⬇️ Publicar JSON. Descarga el archivo con el nombre de la fecha, por ejemplo 2026-09-05.json, sacado del campo de fecha del programa.
  4. En la terminal:
# desde ~/Documents/Iglesia/projects/programas-tierra-linda
mv ~/Downloads/2026-09-05.json programas/
node tools/indexar.js
git add -A
git commit -m "Programa del 5 de septiembre"
git push

Cloudflare despliega en menos de un minuto. Verificación de 5 segundos: abrir la página en una ventana privada (sin copia guardada) y confirmar que aparece la fecha nueva.

Nunca editar programas/index.json a mano. Lo genera indexar.js leyendo la carpeta, y el orden por nombre de archivo es lo que define cuál es el vigente.

4. Casos especiales

Corregir algo después de publicar

Editar, volver a publicar con la misma fecha (el archivo se sobreescribe), node tools/indexar.js, commit y push. El historial de la corrección queda en Git.

Publicar con anticipación

El vigente es el de la fecha más nueva, así que si publico el del 5 de septiembre un lunes, desde ese lunes la gente ve el del 5. Eso es lo que uno quiere para el que está armando el programa, pero conviene saberlo: no muestra "el de hoy", muestra el más adelantado.

Revertir una publicación mala

git rm programas/2026-09-05.json
node tools/indexar.js
git commit -m "Revertir el programa del 5" && git push

El vigente vuelve a ser el sábado anterior, que sigue en la carpeta.

Dos personas editando el mismo sábado

No hay edición simultánea y no la va a haber sin servidor. La regla: una sola persona arma el programa, el de turno. Si alguien más tiene cambios, se los manda por texto y el de turno los mete. El que publica define la versión oficial.

Alguien perdió lo que estaba haciendo

Primero ↶ Deshacer, que guarda 40 pasos. Si ya cerró la página y entró desde otro equipo, no hay recuperación: su copia vive en el equipo donde editaba. Por eso el mensaje del manual insiste en mandarse el enlace a sí mismo cuando va a medias.

Cambiar el logo

Reemplazar logo-tl.png o logo-sda.png en el repositorio y hacer push. El botón de reemplazar logo dentro de la página es solo para la copia de esa persona, no cambia el logo de todos.

5. Guion de la demo, 6 minutos

Orden pensado para que se entienda el valor antes de la mecánica. Abrir con el programa del sábado ya cargado, no con la página vacía.

MinutoQué muestroQué digo
0:00La página abierta con el programa del sábado "Esto es el programa del sábado, en el mismo formato que ya usamos. No hay que instalar nada ni crear cuenta."
0:45Clic sobre un nombre y lo cambio "Se escribe encima, así de simple. Aquí no hay campos ni formularios."
1:30Cambio una hora y señalo los minutos "Los minutos se calculan solos. Nadie tiene que sumar."
2:15Muevo un espacio con ↑ y lo devuelvo con Deshacer "Se puede reordenar, y si uno se equivoca, se deshace."
3:00Imprimir / Guardar PDF "Y de aquí sale el PDF de siempre, en una hoja, para el grupo."
4:00Los dos enlaces, abriendo el de solo lectura "Dos formas de compartir: uno para trabajar entre nosotros, y este de solo lectura para cuando ya está cerrado, que nadie puede cambiar."
5:00El teléfono, en vista de tarjetas "Y se puede hacer desde el celular, con letra grande."
5:30El manual "Todo esto está explicado en el manual, con el enlace en la misma página."
Lo que no muestro en la demo: el modo publicación, el JSON, el repositorio, ni la palabra Git. Eso es mío. Si alguien pregunta cómo queda "el oficial", la respuesta corta es "yo lo publico y a todos les aparece al entrar".

Antes de la demo, dos minutos de alistamiento: entrar en una ventana privada para que cargue el programa publicado y no mi copia de pruebas, tener el celular con la página abierta, y tener listo el enlace de solo lectura para pegarlo en el grupo en vivo.

6. Qué pedirle a Andrés esta vez

Andrés está de turno el sábado 22 y es el que va a estrenar esto. Lo que necesito de él es concreto y en este orden:

  1. Que arme el programa del 22 en la página, partiendo de lo que ya está cargado (que es justo su programa, el que él preparó). Solo tiene que revisar y ajustar lo que cambie.
  2. Que me mande el enlace editable cuando lo tenga listo, para publicarlo yo.
  3. Que reparta el enlace de solo lectura o el PDF al grupo, no el editable.
  4. Que me diga qué le estorbó. Esto es lo que más me sirve: es el primero que lo usa de verdad y con turno encima.

Y lo que yo le doy, para que quede claro el intercambio: el programa ya cargado, el manual, y yo publico y sostengo la herramienta. Él no tiene que aprender nada técnico.

7. Rutina semanal en una tarjeta

CuándoQué
JuevesRecordarle al de turno que arme el programa en la página y me mande el enlace editable.
Viernes a.m.Revisar, publicar (4 comandos) y confirmar en ventana privada.
Viernes p.m.Que el de turno reparta el enlace de solo lectura o el PDF.
Cada tantoCorrer las pruebas antes de tocar el código: node tests/horas.js, node tests/modelo.js.

← Ir a la aplicación en modo publicación  ·  Manual de los autores