Una aplicación intuitiva y potente para gestionar tus finanzas personales con inteligencia artificial integrada.
Gastoscopio es una aplicación móvil desarrollada con Flutter que te ayuda a tomar el control total de tus finanzas personales. Con una interfaz moderna e intuitiva, podrás registrar gastos e ingresos, crear movimientos fijos recurrentes, y obtener análisis detallados de tus patrones de gasto con la ayuda de inteligencia artificial.
- Registro rápido de gastos e ingresos con formularios intuitivos
- Categorización automática con IA para una mejor organización
- Movimientos fijos que se repiten automáticamente cada mes
- Edición y eliminación fácil de cualquier transacción
- Dashboard visual con gráficos de gastos por categoría
- Resúmenes mensuales con balance total y tendencias
- Estadísticas detalladas filtradas por mes y año
- Análisis con IA que proporciona insights personalizados sobre tus hábitos de gasto
- Categorización inteligente de movimientos usando Gemini AI
- Resúmenes financieros generados automáticamente
- Recomendaciones personalizadas para mejorar tus finanzas
- Análisis de patrones de gasto y sugerencias de ahorro
- Interfaz moderna con Material Design 3
- Modo oscuro/claro con soporte para colores dinámicos del sistema
- Animaciones suaves y transiciones fluidas
- Navegación intuitiva con acceso rápido a todas las funciones
- Almacenamiento local seguro con SQLite
- Respaldo en Google Drive opcional para sincronización
- Autenticación con Google para mayor seguridad
- Control total sobre tus datos financieros
- Patrón Singleton para servicios centralizados
- Programación reactiva con Streams y Listeners
- Gestión de estado eficiente con AnimatedBuilder
- Separación de responsabilidades con capas bien definidas
- Base de datos local SQLite con Floor ORM
- Respaldo automático en Google Drive
- Preferencias del usuario con SharedPreferences
- Gestión de archivos para importación/exportación
- Integración con Gemini AI para análisis financiero
- Categorización automática de transacciones
- Generación de resúmenes personalizados
- API Key configurable por el usuario
- Saludo personalizado con nombre del usuario
- Balance mensual destacado con colores indicativos
- Últimos movimientos del día
- Gráfico de gastos por categoría (top 3)
- Acceso rápido para añadir nuevos movimientos
- Formulario inteligente con categorización automática por IA
- Lista filtrable por mes y año
- Búsqueda rápida por descripción o categoría
- Edición en línea con validación de datos
- Eliminación segura con confirmación
- Creación de gastos recurrentes (alquiler, suscripciones, etc.)
- Aplicación automática al cambio de mes
- Gestión flexible con activación/desactivación
- Categorización personalizada para cada movimiento fijo
- Gráficos interactivos de gastos por categoría
- Tendencias mensuales con comparativas
- Resúmenes con IA que analizan patrones de gasto
- Exportación de datos para análisis externos
- Personalización de moneda (€, $, £, etc.)
- Configuración de avatar con opciones SVG y PNG
- Gestión de API Key para servicios de IA
- Términos y condiciones con scroll obligatorio
- Flutter SDK 3.0+
- Dart SDK 3.0+
- Android Studio / VS Code
- Cuenta de Google (opcional para respaldo)
- API Key de Gemini AI (opcional para funciones de IA)
- Clonar el repositorio
git clone https://github.com/tu-usuario/Gastoscopio.git
cd Gastoscopio- Instalar dependencias
flutter pub get- Configurar Firebase (opcional)
# Añadir google-services.json en android/app/
# Configurar autenticación con Google- Compilar la aplicación
# Para desarrollo
flutter run
# Para producción
flutter build apk --release- Acepta los términos y condiciones
- Configura tu moneda preferida
- Personaliza tu avatar y colores
- Opcionalmente inicia sesión con Google
- Configura tu API Key de Gemini AI para funciones inteligentes
- Ve a Configuración > Generador de API Key
- Sigue el enlace para obtener tu API Key de Gemini
- Introduce la clave en el campo correspondiente
- ¡Disfruta de las funciones de IA!
La aplicación incluye un menú de opciones de desarrollador que permite acceso a funciones avanzadas:
- Importa datos desde archivos JSON de Gastoscopio
- Funcionalidad oculta en opciones de desarrollador para evitar uso accidental
- Preserva la estructura de datos y categorías
⚠️ PELIGRO: Borra TODOS los datos de la aplicación permanentemente- Incluye confirmación múltiple para prevenir borrado accidental
- Limpia: movimientos, categorías, movimientos fijos, configuraciones
- Requiere reinicio de la app después del borrado
- Ve a Configuración
- Busca la sección "Opciones de Desarrollador"
- Toca para expandir el menú
- Usa las funciones con precaución
- Múltiples confirmaciones para operaciones destructivas
- Advertencias claras sobre irreversibilidad
- Recomendación de backup antes de limpiar datos
- Feedback visual claro para todas las operaciones
¡Las contribuciones son bienvenidas! Por favor:
- Fork el proyecto
- Crea una rama para tu feature (
git checkout -b feature/nueva-funcionalidad) - Commit tus cambios (
git commit -m 'Añadir nueva funcionalidad') - Push a la rama (
git push origin feature/nueva-funcionalidad) - Abre un Pull Request
Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.
Hecho con ❤️ y Flutter
Toma el control de tus finanzas con inteligencia