satflux
satflux es un panel de control multi-institución para BTCPay Server que permite gestionar tiendas, facturas, Lightning y exportaciones mediante una SPA Vue.js basada en Laravel.
Ficha actualizada 22 sept 2026, 21:51 · upstream 22 sept 2026, 21:49 · release sin release detectada
Qué es satflux
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
satflux.io es una aplicación web multi-tenencia diseñada para comerciantes que desean ejecutar BTCPay Server y ofrecer facturación profesional a través de un panel de control. La aplicación se construye sobre una arquitectura híbrida: un frontend SPA con Vue.js, TypeScript y Tailwind CSS, conectado mediante la API Greenfield a un servidor Laravel 12 en PHP 8.3+. El proyecto integra BTCPay Server como backend de pagos, permite facturación empresarial completa (facturas, proformas, facturas fiscales SK e-FACTURA, cobros recurrentes), gestión de inventario y almacenes, y exportaciones en formato CSV o XLSX.
La arquitectura distingue entre dos modelos de facturación: el modo local-first, donde los datos de facturación se guardan en una base de datos SQLite del navegador (Evolu) con cifrado E2EE para sincronización asíncrona vía relay, y un modelo híbrido que mantiene la compatibilidad con las bases de datos PostgreSQL existentes. El sistema soporta múltiples tipos de billeteras: Blink, Aqua + Boltz (con paring SamRock), Cashu (mint + Lightning address) y BTC. Además, ofrece autenticación por correo o contraseña, autenticación por LNURL, y un modo demo para usuarios gratuitos.
El proyecto incluye herramientas avanzadas como tickets satoshis para eventos offline, raffles de BTCPay Server, integración con WooCommerce, validación de billeteras, exportaciones masivas, y soporte para auditoría de cumplimiento (OFAC). El sistema permite la creación de tiendas desde un panel de configuración inicial, con verificación manual de billeteras y opciones de facturación recurrente.
- Gestionar múltiples tiendas BTCPay Server en una sola plataforma sin necesidad de configurar servidores separados
- Generar facturas profesionales para empresas mediante facturación empresarial (facturas, proformas, cobros recurrentes)
- Implementar facturación fiscal SK e-FACTURA y pagos con b-mail a través del puente API
- Automatizar la creación de tickets satoshis para eventos offline o raffles
- Exportar facturas en formato CSV para integración con sistemas contables externos
- Gestionar inventario, almacenes y productos asociados a las tiendas BTCPay Server
- Soporta múltiples tipos de billeteras (Blink, Aqua + Boltz, Cashu) con verificación manual de seguridad
- Implementa facturación local-first en modo E2EE para proteger datos sensibles del cliente
- Permite exportar facturas a CSV o XLSX y sincronizar pagos con b-mail
- Soporta autenticación por LNURL y permite autenticación por correo o contraseña
- Incluye validación de billeteras mediante checklist manual antes de activar el modo local-first
- Ofrece un panel de control multi-tenencia con gestión de usuarios, roles y permisos
- El modo local-first requiere un entorno aislado (no funciona en producción compartida) y no sincroniza datos entre dispositivos sin configuración adicional
- La facturación recurrente está limitada a facturas simples; las facturas complejas requieren exportar desde el panel de factura y reimportar
- No incluye gestión de inventario ni almacenes, lo que limita la capacidad de gestionar múltiples productos por tienda
- El modo local-first no soporta sincronización en tiempo real con relays externos sin configuración adicional
- La validación de billeteras es manual y no se sincroniza automáticamente desde BTCPay Server
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.
Para desplegar satflux, se requiere Docker Compose para ejecutar el entorno de desarrollo. Se recomienda configurar un proxy (como Nginx o Caddy) como reverse proxy con las cabeceras correctas para que la aplicación funcione detrás del servidor web. Es necesario configurar correctamente los dominios de estado de sesión y los certificados SSL. Para producción, se debe desplegar en un entorno aislado donde BTCPay Server no corra en el mismo servidor, ya que el modo local-first requiere una base de datos SQLite independiente por tienda. Se recomienda usar Docker Compose para gestionar las dependencias del backend (Laravel + PHP) y el frontend (Node.js + Vue). El proyecto soporta autenticación con JWT a través de Sanctum y permite la creación de tiendas desde un panel de configuración inicial.
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.