PaqueteYa
App web para paqueterías / puntos de entrega: registro de paquetes, QR por paquete, etiqueta térmica imprimible y escáner.
Ejecutar en local
npm install
npm run dev # http://localhost:3000 (con recarga automática)
npm start
Requiere Node 22+. Lee las variables de .env (no se sube a git). La base de datos es Postgres en Supabase.
Base de datos (Supabase)
sql/schema.sql: tablas. Aplicar con npm run db:schema (se puede repetir sin romper nada).npm run db:migrar: copia los datos de la antigua base SQLite (data/app.db) a Postgres. Sólo si se quieren conservar esos datos.- RLS está activado sin políticas: la API REST pública de Supabase no puede leer las tablas; el servidor sí, porque se conecta como
postgres.
Variables de entorno
| Variable | Uso |
|---|
DATABASE_URL | URI del Transaction pooler de Supabase (puerto 6543). Caracteres especiales de la contraseña codificados (@ → %40). |
SESSION_SECRET | Clave para firmar la cookie de sesión. Obligatoria en Vercel. |
BASE_URL | Opcional. URL pública que se graba en los QR. Sin ella, en Vercel se usa el dominio de producción del proyecto (xxx.vercel.app). |
PORT | Sólo local (por defecto 3000). |
Desplegar en Vercel
- Subir el repositorio a GitHub e importarlo en Vercel (detecta Express sin configuración).
- En Settings → Environment Variables agregar
DATABASE_URL y SESSION_SECRET (Production y Preview).
vercel.json fija la región cle1 (Cleveland), junto a la base en us-east-2.- Los archivos de
public/ los sirve la CDN de Vercel; views/ se incluye solo en la función.
La cámara del navegador sólo funciona en https:// o en localhost. Si más adelante hay dominio propio, definir BASE_URL antes de imprimir etiquetas: la URL queda grabada en cada QR.
Rutas
/ landing · /registro · /login/app paquetes (Por recibir / En el punto / Entregados + búsqueda)/app/registrar nuevo paquete → código P{punto}-00001 + QR/app/escanear QR con cámara o foto de la galería/app/paquete/:codigo ficha, cambio de estado, avisos por WhatsApp/app/paquete/:codigo/ticket etiqueta para impresora térmica 58/80 mm/q/:token destino del QR: exige sesión y que el paquete sea de ese punto
