SeFue (nombre provisional)
App colaborativa que muestra en tiempo real qué sectores de una ciudad están sin luz, agua o internet, o con calles inundadas. Empieza en Guayaquil.
La fuente de verdad del producto y las reglas de trabajo están en CLAUDE.md.
Desarrollo local
Requisitos: Node 24 y npm.
npm ci
cp .env.example .env.local # completar valores; nunca se versiona
npm run dev
Verificaciones
npm run lint
npm run typecheck
npm test
npm run build
Flujo de trabajo
Ramas feat/, fix/, chore/, commits con Conventional Commits y PR obligatorio hacia main con CI verde.
Despliegue y observabilidad
- Vercel: importar el repositorio y cargar las variables de
.env.example en el panel (nunca en el repo). Las variables NEXT_PUBLIC_* se fijan en el build: si cambian, hay que redesplegar.
- Sentry: con
NEXT_PUBLIC_SENTRY_DSN el navegador reporta solo errores no capturados, sin datos personales y con el SDK cargado en diferido. Con SENTRY_AUTH_TOKEN el build sube los source maps a Sentry y los borra del output. Prueba rápida en la consola del navegador: setTimeout(() => { throw new Error("prueba") }).
- Uptime: monitorear
/api/health cada minuto.
- Peso: el CSP con nonce obliga a renderizar el HTML por petición. El JS inicial se mide en CI cuando exista el presupuesto de bundle (CLAUDE.md §13).
