card-bill-assistant
card-bill-assistant es una aplicación web auto-alojada para la gestión integral de facturas de tarjetas de crédito y gastos fijos. Sincroniza correos electrónicos bancarios mediante IMAP, parsea automáticamente datos de transacciones y fechas de pago, y envía recordatorios de vencimiento a múltiples
Ficha actualizada 27 sept 2026, 21:10 · upstream 27 sept 2026, 21:00 · release v0.6.1
Qué es card-bill-assistant
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
card-bill-assistant es una herramienta auto-alojada diseñada para la gestión integral de facturas de tarjetas de crédito y gastos fijos. Sincroniza correos electrónicos bancarios mediante IMAP, parsea automáticamente datos de transacciones y fechas de pago, y envía recordatorios de vencimiento a múltiples canales como Telegram o Bark.
La aplicación centraliza el control financiero en un panel web responsive compatible con escritorio y móviles. Ofrece gestión segura de tarjetas con encriptación AES-256-GCM local para datos sensibles como CVV y números de tarjeta, sin almacenamiento en la nube. Incluye soporte para múltiples temas visuales y modo oscuro.
La arquitectura está construida sobre Node.js y React, utilizando MySQL para el almacenamiento persistente. Permite extenderse con nuevos parseadores bancarios y soporta despliegue mediante Docker Compose, ya sea con una base de datos integrada o externa.
- Automatización del seguimiento de pagos de tarjetas de crédito mediante parseo de correos electrónicos bancarios.
- Gestión centralizada de gastos fijos (alquiler, servicios) con recordatorios programables y registro manual.
- Sincronización segura de datos financieros sensibles en un entorno auto-alojado sin exponer información a terceros.
- Visualización de tendencias de gasto y seguimiento de anualidades de tarjetas mediante alertas automáticas.
- Soporte nativo para parseo de correos electrónicos de múltiples bancos chinos (ej. CMB, ICBC) con actualizaciones de plantillas.
- Encriptación AES-256-GCM local para datos sensibles como CVV y números de tarjeta, sin almacenamiento en la nube.
- Arquitectura modular basada en Docker que permite despliegue con MySQL integrado o externo.
- Sistema de notificaciones multi-canal (Telegram, Bark, PushPlus) con soporte para plantillas personalizadas.
- Dependencia de la estabilidad de los correos electrónicos bancarios; cambios en las plantillas pueden requerir actualización manual del parseador.
- Requiere acceso a IMAP (código de autorización) y no soporta autenticación por contraseña simple sin habilitación específica.
- La extracción de transacciones para bancos como SPDB requiere intervención manual o verificación debido a limitaciones en la API del banco.
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.
Despliegue recomendado mediante Docker Compose con imagen oficial ghcr.io/kukushouhou/card-bill-assistant. Utilizar MySQL externo para mayor seguridad o integrado si es un entorno aislado. Configurar variables de entorno para claves de encriptación y credenciales IMAP. No exponer puertos 3000, 5173 ni 3306 directamente a la red pública sin protección HTTPS y proxy inverso. Realizar copias de seguridad periódicas de la base de datos MySQL y el archivo .env.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.