====== Firefly III ======

[[..:aplicaciones_web|Aplicación web]] para gestionar las finanzas personales.

  * [[https://www.firefly-iii.org/|Web oficial]]
  * [[https://github.com/firefly-iii/firefly-iii|Repositorio oficial]] (GitHub)
  * [[https://docs.firefly-iii.org/|Documentación oficial]]

{{ https://docs.firefly-iii.org/images/explanation/firefly-iii/about/screenshots/index.png?600 |}}

===== Características =====

  * Gestión de cuentas y movimientos
  * Organización de transacciones: categorías, etiquetas, presupuestos...
  * Transacciones recurrentes.
  * Reglas y automatización.
  * Generación de informes y gráficos.
  * Soporte para múltiples monedas
  * Importación de datos bancarios
  * REST JSON API
  * Notificaciones mediante Discord, e-mail, slack...
  * Multiusuario.

===== Modelo de Firefly III =====

<code>
                         FIRE FLY III
                              │
             ┌────────────────┼────────────────┐
             │                │                │
          DINERO          CLASIFICACIÓN     PLANIFICACIÓN
             │                │                │
        ┌────┴────┐      ┌────┼────┐       ┌────┼─────┐
        │         │      │    │    │       │    │     │
     Cuentas  Transac. Categorías Tags  Presupuestos Huchas
        │                                    │
     Saldos                              Objetivos
        │
     Patrimonio

                 AUTOMATIZACIÓN
                       │
             ┌─────────┼─────────┐
             │         │         │
           Reglas  Recurrentes Suscripciones

</code>

Cada pieza responde una pregunta distinta:

^ Funcionalidad	             ^ Pregunta que responde             ^
| Cuentas	             | ¿Dónde está mi dinero?  |
| Transacciones	             | ¿Qué ha ocurrido con mi dinero?  |
| Categorías	             | ¿En qué he gastado?  |
| Etiquetas	             | ¿Qué transacciones pertenecen a este contexto/proyecto?  |
| Presupuestos	             | ¿Cuánto quiero gastar en esto?  |
| Huchas	             | ¿Para qué estoy ahorrando?  |
| Suscripciones	             | ¿Qué pagos tengo comprometidos próximamente?  |
| Transacciones recurrentes  | ¿Qué operaciones quiero que Firefly cree automáticamente?  |
| Reglas	             | ¿Cómo quiero que Firefly clasifique/transforme automáticamente mis transacciones?  |
| Informes	             | ¿Qué ha pasado con mi dinero?  |

==== Cuentas ====

La representación de tu dinero.

<code>
ACTIVOS
├── Banco Santander
│   ├── Cuenta corriente
│   └── Cuenta ahorro
├── N26
├── Revolut
├── Efectivo
└── PayPal

PASIVOS
├── Tarjeta Visa
└── Préstamo

INGRESOS
├── Nómina
└── Otros ingresos

GASTOS
├── Supermercado
├── Amazon
└── etc.
</code>

==== Categorías ====

¿En qué he gastado? Las categorías sirven principalmente para clasificación y análisis histórico.

<code>
Alimentación
Restaurantes
Transporte
Vivienda
Electricidad
Internet
Ropa
Ocio
Viajes
Salud
Educación
...
</code>

==== Presupuestos ====

¿Cuánto quiero/puedo gastar en algo durante un período? Los presupuestos son una herramienta de planificación.

Ejemplo:

<code>
Alimentación       400 €/mes
Restaurantes       150 €/mes
Ocio               100 €/mes
Ropa               100 €/mes
</code>

No debemos crear demasiados presupuestos. Mejor empezar con poco:

<code>
🏠 Vivienda
🍎 Alimentación
🚗 Transporte
🍽️ Restaurantes
🎮 Ocio
🛍️ Compras
✈️ Viajes
💊 Salud
</code>

El presupuesto sirve para controlar gasto durante un período; la categoría sirve para saber qué naturaleza tiene ese gasto.

==== Huchas / Piggy banks ====

Puedes establecer un objetivo y hacer seguimiento de cuánto has ahorrado y cuánto falta.

  * Presupuesto: "No quiero gastar más de 400 €/mes en alimentación."
  * Hucha: "Quiero tener 3.000 € para Japón."

Puedes tener:

<code>
Banco
Saldo real: 12.000 €

Huchas:
├── Japón       2.000 €
├── Coche       1.000 €
└── Emergencia  5.000 €
</code>

Tu cuenta sigue teniendo 12.000 €.

Las huchas te dicen: de esos 12.000 €, conceptualmente tienes 2.000 € reservados para Japón, 1.000 € para el coche, etc.

==== Suscripciones ====

¿Qué pagos tengo comprometidos? 

Una suscripción representa algo como:

  * Netflix: 39,99 € / mes
  * Spotify: 10,99 € / mes
  * Internet: 45 € / mes
  * Seguro coche: 600 € / año
  * Amazon Prime: 49,90 € / año

La pregunta que responde es: "¿Qué pagos periódicos tengo y cuándo espero pagarlos?"

Es especialmente útil para previsión de gastos futuros.

<WRAP center round info 60%>
Cuando eliminemos una suscripción, las transacciones asociadas con ella perderán esa asociación, pero no se eliminarán.
</WRAP>

==== Transacciones recurrentes ====

Supongamos que todos los días 1:

<code>
Alquiler
-1.000 €
</code>

Puedes crear una transacción recurrente:


  * Alquiler
  * Periodicidad: mensual
  * Día: 1
  * Importe: 1.000 €
  * Cuenta: Santander
  * Categoría: Vivienda
  * Presupuesto: Vivienda

Y Firefly puede generar la transacción automáticamente.

<WRAP center round important 60%>
Esto requiere que el cron de Firefly III esté correctamente configurado porque es el mecanismo para ejecutar estas operaciones programadas. La propia versión Docker no ejecuta por sí sola el planificador.

</WRAP>
 
===== Instalación =====

==== Docker ====

Fichero ''docker-compose.yml'':

<code yaml>
version: "3.3"

services:
  firefly:
    image: fireflyiii/core:latest
    volumes:
      - ./upload:/var/www/html/storage/upload
    restart: "unless-stopped"
    env_file: .env

</code>

Fichero ''.env'' configurable a partir del de [[https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/.env.example|ejemplo]]

===== Uso =====

==== Usuarios ====

Tras la instalación, se podrá crear una cuenta. Por defecto, se deshabilitará el registro de nuevos usuarios.