QR Pro (Logística)

Herramienta interna de GLASTOR-DEV para generar, personalizar y exportar códigos QR usados en operaciones de logística (etiquetado, acceso rápido a recursos, contactos, eventos y onboarding de WiFi).

Nota: los badges de CI/Deploy/CodeQL requieren que los workflows estén publicados en el repositorio remoto.

Tabla de Contenidos

• QR Pro (Logística)
  • Tabla de Contenidos
  • Características
  • Exportación
  • Requisitos
  • Uso
  • Scripts
  • Tecnologías
  • Buenas prácticas
  • Contribuir
  • Historial de cambios
  • Licencia

Características

Tipos de QR soportados:

• URL
• Texto
• vCard (Contacto)
• WiFi (SSID / password / tipo)
• Email
• SMS
• Evento

Personalización:

• Color del QR, color de fondo y tamaño (128/256/512)
• Logo centrado (opcional)
• Modo accesible (foco/outline visible)

Exportación

• Descargar SVG
• Descargar PNG
• Compartir (si el navegador lo soporta)
• Exportar historial reciente a PDF
• Exportar historial reciente a ZIP (PNGs + metadatos.csv)

Requisitos

• Node.js 20 (recomendado, alineado con CI)
• npm
• Deno (para correr tests en CI/local)

Uso

npm ci
npm run dev

Build de producción:

npm run build

Scripts

• npm run dev — desarrollo
• npm run build — build de producción
• npm test — tests (Deno)
• npm run lint — ESLint
• npm run typecheck — TypeScript (tsc)

Tecnologías

• React 19
• Vite 7
• TypeScript
• Deno test + Testing Library
• ESLint
• react-qr-code + qrcode
• jszip + file-saver
• jspdf

Buenas prácticas

• Performance: estado acotado e historial limitado
• Accesibilidad: ARIA labels y navegación por teclado
• Seguridad: validación de archivos, sanitización de nombres, manejo de errores sin exponer datos sensibles

Contribuir

¡Las contribuciones son bienvenidas! Por favor lee CONTRIBUTING.md antes de enviar un Pull Request.

Historial de cambios

Consulta el CHANGELOG.md para ver versiones y cambios.

Licencia

Ver LICENSE.