CheckPass Club
Monorepo de las aplicaciones web separadas de consumidor, comercio y plataforma.
Requisitos
- Node.js 24 LTS. Desarrollo local usa 24.19.0 (ver
.node-version); Vercel puede
ejecutar una revisión 24.x compatible.
- pnpm 11.4.0
Inicio local
pnpm install --frozen-lockfile
pnpm dev
Los health checks quedan disponibles en:
http://localhost:3200/api/health — consumerhttp://localhost:3201/api/health — merchanthttp://localhost:3002/api/health — platform
La e2e (pnpm test:e2e) levanta sus propios servidores en 3100/3101/3102
(tests/e2e/support/ports.ts), para no chocar con un pnpm dev ni con otros proyectos.
El checklist para desplegar y probar el registro real de Owner está en
docs/DEPLOY-OWNER-TEST.md.
Controles
pnpm format:check
pnpm lint
pnpm typecheck
pnpm test
pnpm test:e2e
pnpm build
QA de check-in consumer
El prototipo de la Spec 0011 no usa backend. Para probarlo desde un teléfono, expón el
puerto 3000 mediante una URL HTTPS temporal, define esa URL en .env.local como
NEXT_PUBLIC_QA_ORIGIN, ejecuta pnpm qa:qr y después pnpm dev:consumer. Abre
/qa en la computadora y escanea el QR desde el teléfono. HTTPS es necesario para que
el navegador del teléfono permita geolocalización.
Para QA HTTP en la misma red local, inicia Next con --hostname 0.0.0.0 y usa la IP LAN
del Mac. apps/consumer/next.config.ts debe incluir esa IP en allowedDevOrigins; si
cambias de Wi-Fi, actualízala y reinicia Next.
