AgendaPro DevandClaude Opus 5
2437012c46
Prepara el backend Postgres para producción y lo despliega como stack de Swarm
en el servidor de Consultoría E3, detrás de Traefik.
## Lo que le faltaba al proyecto para poder empaquetarse
- **`platform/` importaba de `server/`.** `routes/dayClose.ts` traía los helpers
de zona horaria de `../../server/lib/time.ts`, contradiciendo lo que el propio
README declara. El typecheck pasaba limpio porque en el equipo de desarrollo
el archivo existe; solo se vio al contenerizar, cuando el proceso murió al
arrancar con ERR_MODULE_NOT_FOUND. Ahora hay `platform/lib/time.ts`, copia
deliberada —misma decisión que `businessDefaults.ts`— y una prueba que impide
que vuelva a colarse una importación cruzada.
- **No había endpoint de salud.** `/api/health` consulta la base: uno que solo
responde `{ok:true}` sigue en verde con Postgres caído, justo cuando el
orquestador debería reiniciar.
- **No servía el frontend.** Ahora sirve `dist/` con fallback de SPA que excluye
`/api/`, para que una ruta de API inexistente devuelva 404 y no el index.
- **No había apagado ordenado.** Sin él, cada redespliegue corta las peticiones
en vuelo. Verificado: la tarea vieja registra el SIGTERM y cierra.
## Imagen
`platform/Dockerfile`, multi-etapa. Corre como `USER node`, fija `TZ=UTC` —la
agenda saca la zona de `businesses.timezone`, y dejar la del proceso en México
haría que una recaída pasara desapercibida— y **no** ejecuta las migraciones al
arrancar: se lanzan como paso explícito del despliegue, porque hacerlo al inicio
deja el esquema a medias si el arranque falla.
`tsx` pasa de devDependencies a dependencies: este backend corre TypeScript
directo y arrancar con `npx tsx` lo bajaría de npm en cada arranque, sin versión
fijada y sobre todo el código del servidor.
## Estado en el servidor
- Base `agendapro` con rol `agendapro_app` de mínimo privilegio, `PUBLIC`
revocado. Verificado: el rol no ve ninguna tabla de las otras bases.
- Clave maestra de cifrado **generada en el servidor**, nunca copiada de
desarrollo.
- Stack `agendapro` desplegado, 1/1 réplicas, 5 migraciones aplicadas, 17 tablas.
- Salud, SPA y API de administración verificadas desde dentro de la red overlay.
## Pendiente y bloqueante para el acceso externo
El A-record `agendapro.consultoriae3.com` -> 157.173.205.217 hay que crearlo a
mano en SiteGround. Sin él no hay certificado, porque Let's Encrypt valida por
HTTP-01.
Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
90 lines
3.6 KiB
YAML
90 lines
3.6 KiB
YAML
# Stack de despliegue de 'agendapro' en el server E3 (Docker Swarm single-node + Traefik).
|
|
# Generado por New-E3Scaffold.ps1 - https://agendapro.consultoriae3.com
|
|
#
|
|
# NO EDITES A LA LIGERA:
|
|
# - Las labels de Traefik van bajo deploy.labels. Fuera de ahi se IGNORAN (servicio 1/1 + HTTP 404).
|
|
# - Sin clave 'build:' - Swarm no construye; la imagen tiene que existir ya.
|
|
# - Sin clave 'ports:' - el unico que publica al host es Traefik (80/443).
|
|
# - Los marcadores de secreto se sustituyen AL DESPLEGAR (Deploy-E3Stack.ps1 -SecretsFile).
|
|
# No los rellenes con valores reales aqui si este archivo se versiona en git.
|
|
|
|
version: "3.7"
|
|
|
|
services:
|
|
agendapro:
|
|
# Taguear por SHA y no ':latest': con un tag rodante Swarm no vuelve a
|
|
# hacer pull y un 'service update' no jala la imagen nueva.
|
|
image: agendapro:6d67b23
|
|
|
|
networks:
|
|
- network_public
|
|
|
|
# El healthcheck consulta la base, no solo el puerto: un proceso vivo con
|
|
# Postgres caido no esta sano, y sin esto Swarm lo daria por bueno.
|
|
healthcheck:
|
|
test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3100/api/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
|
|
interval: 30s
|
|
timeout: 5s
|
|
retries: 3
|
|
start_period: 40s
|
|
|
|
environment:
|
|
- NODE_ENV=production
|
|
# La variable se llama PLATFORM_PORT, no PORT: `PORT` es la del backend de
|
|
# demo de server/, que es otro proceso. Con la equivocada, el servidor
|
|
# escucharia en 3100 por defecto igualmente, pero por casualidad.
|
|
- PLATFORM_PORT=3100
|
|
- HOST=0.0.0.0
|
|
# UTC, NO America/Mexico_City.
|
|
#
|
|
# La agenda saca la zona de `businesses.timezone`, no del proceso, y las
|
|
# pruebas corren en UTC a proposito para que la del proceso y la del
|
|
# negocio nunca coincidan. Poner aqui la de Mexico haria que una recaida a
|
|
# la zona del proceso pasara desapercibida en produccion, que es
|
|
# exactamente el fallo que ya costo un incidente en este repo.
|
|
- TZ=UTC
|
|
|
|
# Postgres 14 compartido - host = nombre de servicio en network_public
|
|
# Se usa la URL completa del archivo de secretos, que New-E3Database.ps1 ya
|
|
# deja armada. El andamiaje generaba un marcador de solo-la-contrasena con
|
|
# otro nombre del que usa ese archivo, se quedaba sin resolver, y el
|
|
# servicio arrancaba sin poder conectar a Postgres.
|
|
- DATABASE_URL=<DATABASE_URL>
|
|
|
|
# Clave maestra con la que se cifran los tokens de subcuenta de cada
|
|
# negocio. Sin ella el servidor arranca pero NINGUNA credencial del CRM se
|
|
# puede descifrar. Se inyecta al desplegar; jamas va en este archivo.
|
|
- CRM_MASTER_KEY=<CRM_MASTER_KEY>
|
|
|
|
deploy:
|
|
mode: replicated
|
|
replicas: 1
|
|
placement:
|
|
constraints:
|
|
- node.role == manager
|
|
resources:
|
|
limits:
|
|
cpus: "1"
|
|
memory: 512M
|
|
restart_policy:
|
|
condition: on-failure
|
|
delay: 10s
|
|
update_config:
|
|
order: start-first
|
|
failure_action: rollback
|
|
labels:
|
|
- traefik.enable=true
|
|
- traefik.docker.network=network_public
|
|
- traefik.http.routers.agendapro.rule=Host(`agendapro.consultoriae3.com`)
|
|
- traefik.http.routers.agendapro.entrypoints=websecure
|
|
- traefik.http.routers.agendapro.tls=true
|
|
- traefik.http.routers.agendapro.tls.certresolver=letsencryptresolver
|
|
- traefik.http.routers.agendapro.service=agendapro
|
|
- traefik.http.services.agendapro.loadbalancer.server.port=3100
|
|
- traefik.http.services.agendapro.loadbalancer.passHostHeader=1
|
|
|
|
networks:
|
|
network_public:
|
|
external: true
|
|
name: network_public
|