Checklist — Oxymas Control

Infraestructura

• Proyecto: /home/ricardo/oxymas-control (Node.js + Express + Prisma + PostgreSQL)
• DB: oxymas_control (usuario ricardo)
• Servicio: oxymas-control.service (usuario ricardo, puerto :4000)
• Nginx: vhost control.oxymas.com → proxy a 127.0.0.1:4000 con SSL Let’s Encrypt
• Directorios: recibos/ (HTML/PDF), public/ (panel), scripts/, backups/

.env

DATABASE_URL=postgresql://ricardo:Conf1gurar@127.0.0.1:5432/oxymas_control?schema=public
JWT_SECRET=...
REFRESH_SECRET=oxymas_refresh_secret_2025
REFRESH_TOKEN_DAYS=30
PORT=4000
RECIBOS_DIR=/home/ricardo/oxymas-control/recibos
BASE_PUBLIC_URL=https://control.oxymas.com

Dependencias

• Runtime: express, cors, pino, dayjs, @prisma/client, pg, multer
• Auth: jsonwebtoken, bcrypt, cookie-parser
• PDF: puppeteer (+ librerías del sistema para Chromium)
• Dev: prisma, nodemon

Esquema (tablas)

• Usuario (id, nombre, email, hash, rol, tokenVersion)
• Cliente, Cilindro
• Movimiento (ENTREGA/DEVOLUCION/CAMBIO)
• Pago (1–1 opcional con Movimiento)
• Recibo (1–1 con Movimiento, numero único)
• Auditoria (estructura lista)
• Correlativo (por year, next)

API

• GET /health → ok
• Auth:
  • POST /api/auth/login → Access (24h) + cookie Refresh (30d, HttpOnly Secure)
  • POST /api/auth/refresh → nuevo Access (por cookie o header x-refresh-token)
  • POST /api/auth/logout → limpia cookie
  • POST /api/auth/change-password (JWT) → cambia clave y sube tokenVersion
• Clientes: GET /api/clientes?q= (público), POST /api/clientes (JWT)
• Cilindros: GET /api/cilindros, GET /api/cilindros?libres=1 (públicos), POST /api/cilindros (JWT)
• Movimientos: POST /api/movimientos (JWT), GET /api/movimientos/:id, GET /api/movimientos/recientes
• Pagos: POST /api/pagos (JWT)
• Recibos:
  • POST /api/recibos/:movId (JWT) → correlativo REC-YYYY-000001, HTML + PDF
  • POST /api/recibos/:movId/regenerar (JWT) → reescribe HTML/PDF con datos actuales
  • GET /api/recibos?limit=50 (público) → lista recientes con URLs
• Archivos: /recibos/*.html, /recibos/*.pdf (públicos)
• Panel: / listado simple de recibos y movimientos

Números de recibo

• Transacción con tabla Correlativo por año, formato REC-YYYY-000001.

PDF

• Generación con Puppeteer (A4, márgenes 10mm, printBackground).

Backups

• .pgpass seguro (600) para usuario ricardo
• Script: scripts/backup.sh → pg_dump -F c
• Cron: diario 02:15, retención 14 días, log en backups/backup.log

Operación

• Reiniciar servicio: sudo systemctl restart oxymas-control
• Logs: journalctl -u oxymas-control -n 100 --no-pager
• Health: /health

Pendientes / Ideas

• UI con login (panel de gestión), roles (operador/admin), reportes.
• Auditoría persistente para POST/PUT/DELETE.
• Respaldo remoto (S3/Backblaze) y alerta si falla cron.

Para actualizar este documento: edita public/checklist.html y guarda.