---
name: trampa-zona-horaria
description: "El 30-ago-2026 los recordatorios de Café Lima salieron 5 horas antes porque el servidor corre en UTC — la regla antes de programar cualquier envío."
metadata:
  node_type: memory
  type: feedback
  modified: 2026-09-15T18:25:00.000Z
---

<!--
  FICHA DE EJEMPLO — tipo `feedback`.
  Es la más valiosa del sistema y la que menos gente escribe.
  Se escribe EL MISMO DÍA que rompes algo y lo arreglas, y tiene
  exactamente tres partes en este orden:

      LA REGLA       lo primero que se lee. Imperativa. Sin contexto.
      POR QUÉ        qué pasó de verdad, con fecha y con el daño real.
      CÓMO APLICARLA qué hacer en la práctica la próxima vez.

  El orden no es decorativo: quien la abre con prisa lee la primera línea
  y ya no se estrella. El porqué es para que la regla no se rompa cuando
  aparezca un caso que "parece distinto".
  El negocio es inventado.
-->

**Antes de programar cualquier envío con hora — recordatorio, reporte, cierre de
caja — confirma en qué zona horaria corre el servidor y guarda las horas en UTC.
Convierte solo al mostrarlas.** Si el código dice `08:00` y nadie puso zona,
asume que está mal hasta que lo compruebes.

## Por qué

El **30-ago-2026** se encendieron los recordatorios de pedido programado de
[[cafe-lima-pedidos-whatsapp]]. Los mensajes estaban configurados para salir a
las 08:00. **Salieron a las 03:00 hora de Lima.**

El servidor corre en **UTC**. Lima es **UTC-5**. La hora se guardó como texto
plano, sin zona, y al programar el envío se interpretó como UTC.

El daño no fue técnico: **se despertó a 23 clientes reales a las tres de la
mañana**, y dos de ellos bloquearon el número del negocio. Eso no se revierte
con un despliegue.

Lo que hizo que se colara: **las pruebas pasaban**. Corren en la misma máquina,
también en UTC, así que 08:00 igualaba 08:00 y todo salía verde. Una prueba que
usa la zona horaria del entorno no prueba nada sobre zonas horarias.

## Cómo aplicarla

1. **Guarda en UTC siempre.** En la base, en la cola de envíos, en los archivos
   de configuración. La conversión ocurre en un solo punto: cuando se le muestra
   la hora a una persona.
2. **La zona del negocio es un dato, no una constante escondida.** En Café Lima
   es `America/Lima`, y está en la configuración con ese nombre exacto — nunca
   como `-5`, porque un número no sobrevive a un cambio de horario y el nombre sí.
3. **Las pruebas de horas fijan la zona a mano.** Si la prueba hereda la zona del
   entorno, pasa en tu laptop y falla en el servidor, o peor: pasa en los dos y
   el error sale en producción.
4. **Antes de encender cualquier envío programado, manda uno de prueba a un
   número tuyo y mira a qué hora llega de verdad.** Treinta segundos. Es la única
   comprobación que habría atrapado esto.

## Estado

**[ROTO] Los recordatorios siguen apagados al 15-sep-2026.** El arreglo está
identificado pero no aplicado. **No los enciendas sin hacer los cuatro pasos de
arriba**, y avisa antes de encenderlos.