billy
Billy es una aplicación open-source de facturación y gestión empresarial auto-alojable, multi-empresa con frontend Vue 3/PWA y backend Node.js/Koa. Soporta facturas recurrentes, contratos, seguimiento de tiempo y analíticas por periodo, ejecutándose en tu propia infraestructura sin dependencias de r
Ficha actualizada 28 sept 2026, 9:47 · upstream 28 sept 2026, 9:35 · release sin release detectada
Qué es billy
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Billy es una aplicación open-source para facturación y gestión empresarial auto-alojable, diseñada para operar como un sistema multi-empresa donde un administrador global gestiona cuentas con datos completamente aislados. La arquitectura se basa en Vue 3 + Vuetify 3 para el frontend (SPA/PWA), Koa 2 para la API REST/WebSocket y BullMQ para trabajos asíncronos, utilizando MongoDB, Redis y MinIO como almacenamiento de datos y archivos.
El modelo de despliegue es único: las imágenes Docker son runtimes delgados sin código de aplicación; los artefactos se construyen localmente con pnpm y se montan mediante bind-mounts en el host. Esto permite actualizaciones inmediatas sin rebuilds de imágenes, salvo para el worker que integra Chromium nativo para renderizado PDF. Incluye autenticación Argon2, soporte TOTP, email transaccional con adjuntos y white-label completo.
Los casos de uso incluyen la gestión de suscripciones, generación de PDFs editables en vivo, notificaciones en tiempo real vía WebSocket y un panel analítico impulsado por periodos. La aplicación soporta siete idiomas con resolución per-cliente para facturas y correos electrónicos, permitiendo una personalización profunda sin tocar el código fuente.
- Facturación recurrente con programación flexible (cada N días del mes).
- Gestión multi-empresa con aislamiento de datos por cuenta.
- Generación y edición en vivo de PDFs con renderizado nativo.
- Seguimiento de tiempo y gestión de gastos integrados.
- Contratos y suscripciones con white-label completo.
- Email transaccional con adjuntos y lectura confirmada.
- Licencia AGPL-3.0-or-later garantizando código abierto estricto.
- Despliegue sin rebuilds de imágenes para actualizaciones rápidas.
- Renderizado PDF nativo mediante Playwright/Chromium en worker.
- Autenticación robusta con Argon2 y TOTP two-factor auth.
- Frontend PWA instalable con soporte offline y notificaciones web push.
- White-label completo con logo de marca y documento separado.
- El worker requiere build único de Chromium nativo para renderizado PDF.
- Logs persistentes solo en archivos rotativos, sin GUI integrada.
- Dependencia crítica de Node.js >= 22 y pnpm 11 para desarrollo.
- Pérdida de DATA_ENCRYPTION_KEY implica recuperación imposible de campos cifrados.
- Actualización de logs requiere recreación del contenedor al añadir volumen nuevo.
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.
Construye localmente con pnpm build antes de desplegar. Configura todos los secretos en .env (SESSION_SECRET, JWT_SECRET, etc.) y genera certificados TLS vía Traefik. Para actualizar, reconstruye los artefactos locales y reinicia los servicios api/worker; web no requiere restart.
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.