cardholder_pwa
Cardholder PWA es una aplicación auto-alojada para gestionar tarjetas de fidelidad y descuentos. Soporta escaneo QR/barcode, roles de usuario y funciona offline como PWA.
Ficha actualizada 24 sept 2026, 22:17 · upstream 24 sept 2026, 22:02 · release v1.13.0
Qué es cardholder_pwa
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Cardholder PWA es una aplicación Progresiva (PWA) diseñada para gestionar tarjetas de lealtad y descuentos en un entorno auto-alojado. Permite a los usuarios escanear códigos QR y barras mediante integración con bibliotecas ZXing-JS, Quagga2 y BWIP-JS, además de soportar múltiples formatos de código bidimensionales y unidimensionales.
- Gestión personal de tarjetas de fidelidad en dispositivos móviles
- Compartir tarjetas entre usuarios con roles definidos (owner, admin, member)
- Escaneo offline de códigos QR y barras para acceso rápido a descuentos
- Recuperación de contraseña mediante SMTP cuando está configurado
- Funciona como PWA instalable desde navegador con uso offline en modo read-only
- Soporte multi-usuario con roles jerárquicos (owner, admin, member)
- Integración con múltiples bibliotecas de escaneo ZXing-JS y Quagga2
- Generación visual de códigos mediante BWIP-JS para tipos soportados
- Despliegue simplificado vía Docker con imágenes en ghcr.io/quenary
- Requiere HTTPS para funcionalidad PWA y escaneo de video-stream
- Dificultad detectada con códigos claros sobre fondos oscuros en ZXing
- El primer usuario registrado se asigna automáticamente como owner e no puede ser eliminado
- La recuperación por email requiere configuración SMTP adicional
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Usar Docker pull de ghcr.io/quenary/cardholder_pwa:1. Ejecutar con docker run -d -p 80:80 y volumen $HOME/.cardholder_pwa:/cardholder_pwa. Para bases de datos PostgreSQL usar docker-compose.pg.yml. Configurar HTTPS con Let's Encrypt para PWA y escaneo. Definir variables SMTP en .env.example para recuperación de contraseña.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.