# 🏠 HomeManager

> **Gestión inteligente del hogar** — Aplicación de escritorio para Windows que centraliza las finanzas, garantías, deudas y alertas de tu hogar o familia en un solo lugar.

![Version](https://img.shields.io/badge/versión-1.0.0-green)
![Platform](https://img.shields.io/badge/plataforma-Windows-blue)
![Framework](https://img.shields.io/badge/.NET-10.0-purple)
![License](https://img.shields.io/badge/uso-gratuito-orange)

---

## ✨ ¿Qué es HomeManager?

HomeManager es una aplicación **gratuita** para Windows que te ayuda a tener el control total de las finanzas de tu hogar. Sin suscripciones, sin datos en la nube, sin publicidad. **Todo en tu equipo, todo bajo tu control.**

Diseñada para familias y personas que quieren saber exactamente en qué gastan, cuánto deben, qué garantías tienen activas y cuándo vencen sus próximos pagos.

---

## 🚀 Funcionalidades principales

### 💰 Finanzas
- **Cuentas bancarias** — Corrientes, ahorro, tarjetas, efectivo y criptomonedas con saldo en tiempo real
- **Movimientos** — Registro de ingresos y gastos con categorías, estados y métodos de pago
- **Presupuestos** — Mensual, trimestral y anual con alertas visuales cuando te acercas al límite
- **Metas de ahorro** — Define objetivos, vincula movimientos y sigue tu progreso automáticamente
- **Deudas** — Hipotecas, préstamos, tarjetas e informales con seguimiento de cuotas y pagos

### 🛡️ Garantías
- Registro de garantías de todos tus electrodomésticos y dispositivos
- Alertas automáticas cuando una garantía está próxima a vencer
- Soporte para garantías extendidas

### 📊 Informes
- Resumen mensual de ingresos y gastos
- Análisis por categoría y por cuenta
- Comparativa de presupuestos ejecutados
- Exportación a CSV

### 🔔 Alertas
- Avisos automáticos de garantías próximas a vencer
- Recordatorio de cuotas de deudas
- Alertas de presupuestos excedidos
- Recordatorios manuales personalizables

### 👥 Multi-usuario
- Varios usuarios con roles (Administrador, Adulto, Menor)
- Ámbitos independientes (Familiar, Personal, Infantil)
- Cada usuario ve solo lo que le corresponde

---

## 🌍 Idiomas disponibles

| 🇪🇸 Español | 🇬🇧 English | 🇫🇷 Français | 🇩🇪 Deutsch |
|---|---|---|---|
| ✅ Completo | ✅ Completo | ✅ Completo | ✅ Completo |

---

## 🗄️ Bases de datos compatibles

| Motor | Descripción |
|---|---|
| **SQLite** | Fichero local — recomendado para uso personal |
| **MariaDB / MySQL** | Servidor en red — ideal para familia compartida |
| **SQL Server** | Entorno corporativo o empresarial |

---

## 📦 Instalación

### Requisitos
- Windows 10 / 11 (64 bits)
- .NET 10.0 Runtime ([descargar aquí](https://dotnet.microsoft.com/download/dotnet/10.0))

### Pasos
1. Descarga el instalador desde la sección [**Releases**](../../releases)
2. Ejecuta `HomeManager_Setup.exe`
3. Sigue el asistente de instalación
4. Al arrancar por primera vez, configura tu base de datos y crea el usuario administrador

---

## 🖥️ Capturas de pantalla

> *Próximamente*

---

## 🗺️ Roadmap

### v1.0.0 — Actual
- [x] Gestión completa de cuentas, movimientos, presupuestos, metas, deudas y garantías
- [x] Sistema de alertas automáticas y manuales
- [x] Informes y exportación CSV
- [x] Copias de seguridad (JSON, SQL, CSV)
- [x] Multi-idioma (ES, EN, FR, DE)
- [x] Multi-motor de BD (SQLite, MariaDB, SQL Server)
- [x] Logs de actividad en BD y fichero

### v1.1.0 — Próximamente
- [ ] Sistema de actualizaciones automáticas
- [ ] Módulo de mascotas
- [ ] Lista de la compra
- [ ] Mantenimiento del hogar

### Futuro
- [ ] App móvil (Android / iOS)
- [ ] Portal web
- [ ] Importación bancaria (OFX/QIF/CSV)
- [ ] Integración con banca online (PSD2)

---

## 🐛 Reportar un problema o sugerir una mejora

Si encuentras un bug o tienes una idea para mejorar HomeManager:

1. Abre una [**Issue**](../../issues) describiendo el problema o la sugerencia
2. Incluye tu versión de Windows y la versión de HomeManager
3. Si es un bug, describe los pasos para reproducirlo

---

## 📄 Licencia y uso

HomeManager es **gratuito para uso personal**. El programa puede descargarse y usarse libremente.

El código fuente es propiedad de **Rafael Campanero** y está sujeto a todos los derechos reservados. No está permitida su copia, modificación ni redistribución sin autorización expresa del autor.

---

## 👨‍💻 Autor

Desarrollado por **Rafael Campanero**

---

*HomeManager — Porque conocer tus finanzas es el primer paso para mejorarlas.*