bill
Aplicación multiusuario de contabilidad y reparto de gastos para individuos, familias o compañeros de piso. Desarrollada con Go (backend), Vue 3 (frontend) y SQLite. Soporta autoalojamiento vía Docker, despliegue en NAS fnOS y gestión de roles/administradores.
Ficha actualizada 22 sept 2026, 16:21 · upstream 12 sept 2026, 5:22 · release v0.1.4
Qué es bill
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Bill es una herramienta de contabilidad diseñada para gestionar gastos personales y compartidos entre múltiples usuarios. Permite crear ledgers individuales con categorías, etiquetas y múltiples cuentas bancarias o digitales (WeChat, Alipay), así como ledgers compartidos para grupos como familias o compañeros de piso. La aplicación destaca por su algoritmo de reparto flexible que soporta cuotas fijas, porcentajes o proporciones, calculando automáticamente las diferencias pendientes y sugiriendo el método de transferencia más eficiente para equilibrar saldos.
Técnicamente, la arquitectura separa el backend en Go con Gin y GORM sobre SQLite (modo WAL) del frontend construido con Vue 3, TypeScript y Vite. El sistema prioriza la seguridad al no almacenar números completos de tarjetas bancarias, solo huellas dactilares y últimos dígitos. La interfaz es totalmente responsive, adaptándose a dispositivos móviles y escritorio con soporte para temas claros y oscuros.
El despliegue es sencillo mediante contenedores Docker o scripts binarios directos. Ofrece integración nativa con el sistema operativo NAS fnOS, permitiendo autenticación directa con la cuenta del usuario de red para evitar crear credenciales duplicadas. Incluye herramientas de auditoría, gestión de usuarios y exportación de datos a CSV para análisis externo.
- Gestión de gastos compartidos en familias o compañeros de piso
- Reparto automático de facturas de viaje con cálculo de diferencias
- Control personal de ingresos y gastos con múltiples cuentas bancarias
- Auditoría de transacciones mediante logs de administración
- Despliegue autoalojado en servidor propio o NAS
- Algoritmo de reparto inteligente que minimiza el número de transferencias necesarias
- Base de datos SQLite en modo WAL para rendimiento y persistencia
- Soporte nativo para autenticación con cuenta de usuario fnOS/NAS
- Interfaz responsive con soporte completo para temas claros y oscuros
- Seguridad reforzada: no se almacenan números completos de tarjetas bancarias
- Requiere Go 20+ y Node.js 20+ para desarrollo local sin Docker
- La base de datos SQLite debe residir en un volumen persistente externo
- Las actualizaciones de versión requieren gestión manual del tag de imagen o uso de Watchtower
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.
Utilizar `docker compose up -d --build` para despliegue estándar. Asegurar que el volumen `bill-data` esté montado correctamente para persistir la base de datos SQLite. Verificar salud con GET `/api/health`. Configurar puerto 8907 o usar alias en fnOS. Para actualizaciones, cambiar tag de imagen y reiniciar contenedores.
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.