1. ¿Qué es Finanzas HNL?

Es una aplicación web de finanzas personales diseñada específicamente para Honduras: la moneda principal es el Lempira (HNL), los nombres de bancos y formatos son locales, y permite gestionar prácticamente todos los aspectos de tu vida financiera.

La app reúne en un solo lugar:

• Cuentas bancarias (ahorro, corriente), débito, tarjetas de crédito, efectivo, billeteras digitales e inversiones.
• Ingresos y gastos por categoría y por cuenta.
• Transferencias entre cuentas y pagos a tarjetas.
• Recurrentes automáticos (salario, suscripciones).
• Deudas con estrategias de pago.
• Metas y planes de ahorro.
• Presupuestos con alertas por categoría.
• Calendario de pagos próximos.
• Multi-usuario con datos aislados por cuenta.

2. Primer ingreso

1. Abre finanzas.zablah.cloud.
2. Elegí Continuar con Google (más rápido, trae tu foto de perfil) o Crear cuenta con email y contraseña.
3. Entrás al Dashboard vacío — es un lienzo en blanco listo para registrar tus finanzas. Sin datos demo.
4. Primer paso sugerido: ir a Cuentas → Nueva cuenta y agregar tu cuenta bancaria principal o efectivo.

3. Crear cuentas (bancos, tarjetas, efectivo)

Una cuenta representa cualquier lugar donde tengas dinero (o donde debas dinero en el caso de tarjetas de crédito).

Pasos:

1. En la barra lateral, ve a Cuentas.
2. Clic en Nueva cuenta.
3. Elige el tipo: Efectivo, Cuenta de ahorro, Cuenta corriente, Tarjeta débito, Tarjeta de crédito, Billetera digital (Tigo Money, etc.), Inversión, Préstamo u Otra.
4. Nombre (ej. BAC Ahorro), institución (ej. Banco BAC Credomatic), saldo inicial y color.
5. Guarda.

El saldo de cada cuenta se recalcula automáticamente con tus ingresos, gastos y transferencias. No necesitas actualizarlo a mano.

4. Tarjetas de crédito

Cuando eliges tipo Tarjeta de crédito, aparecen campos extra:

• Límite de crédito
• Tasa anual (%) — informativa
• Día de corte
• Día de pago límite
• Pago mínimo (%) sobre el saldo utilizado

La app calcula en tiempo real:

• Saldo adeudado
• % de utilización (barra que se pone amarilla al 50% y roja al 80%)
• Crédito disponible
• Pago mínimo sugerido
• Días hasta el vencimiento (con alerta en rojo si faltan 3 días o menos)

Entra a la cuenta en Cuentas → nombre de la tarjeta para ver su dashboard completo con movimientos, gráfico histórico y gastos por categoría.

5. Registrar ingresos

1. Sidebar → Ingresos → Nuevo ingreso.
2. Indica fecha, monto, fuente (Salario, Freelance, etc.), descripción y cuenta de depósito (la cuenta cuyo saldo aumentará).
3. Guardar.

Puedes filtrar por mes/año desde la barra superior, buscar por texto y exportar a CSV.

6. Registrar gastos

1. Sidebar → Gastos → Nuevo gasto.
2. Elige fecha, monto, categoría, tipo (Fijo o Variable) y la cuenta desde donde pagas.
3. Opcionalmente añade descripción, adjunta foto del recibo o divide el gasto entre personas.

La página de gastos muestra totales del período, fijos vs variables, totales por categoría (con badge OK/Cerca/Excedido si tienes presupuesto) y permite filtrar por categoría, tipo y cuenta.

7. Agregar rápido (botón flotante)

En la esquina inferior derecha hay un botón azul con + visible en todas las páginas. Te permite registrar Gasto, Ingreso o Transferencia sin moverte de donde estás. Ideal para apuntar cosas al instante en el celular.

8. Transferencias y pago de tarjetas

Las transferencias mueven dinero entre tus propias cuentas.

1. Sidebar → Transferencias → Nueva transferencia.
2. Elige cuenta origen y destino, monto y fecha.
3. Si el destino es una tarjeta de crédito, la app lo marca automáticamente como Pago TC y reduce el saldo adeudado de esa tarjeta.

9. Cobros / cuentas por cobrar

Cuando alguien te debe dinero (préstamo, venta a crédito, reembolso pendiente), lo registrás desde Sidebar → Cobros → Nuevo cobro.

1. Indicá deudor, monto original, tasa opcional y fecha de cobro esperada.
2. Opcionalmente asignás una cuenta destino (a dónde entra el dinero cuando te paguen).
3. A medida que te van pagando, registrás pagos parciales: fecha, monto y cuenta. Si elegís cuenta, se crea automáticamente el ingreso correspondiente.
4. La app calcula el saldo pendiente y cambia el estado: Pendiente → Parcial → Cobrado. Podés marcar como Incobrable si se perdió.

El calendario muestra las fechas esperadas como eventos, y el dashboard tiene un widget con los top cobros pendientes, flaggeando los vencidos en rojo.

10. Transacciones recurrentes

Las reglas recurrentes evitan que apuntes manualmente cosas que se repiten cada mes (salario, renta, Netflix, aporte a ahorro).

1. Sidebar → Recurrentes → Nueva regla.
2. Elige tipo (Ingreso / Gasto / Transferencia), nombre, monto y frecuencia (diaria, semanal, quincenal, mensual, trimestral, anual).
3. Fecha de la primera ocurrencia (y opcionalmente fecha de fin).
4. Marca Generar automáticamente si quieres que la app cree la transacción sola cuando llegue el día.

Cuando abras la app, las reglas activas con Auto crearán las transacciones pendientes automáticamente. Para reglas manuales, usa el botón ▶️ en la tabla.

11. Calendario de pagos

Sidebar → Calendario. Muestra un mes completo con eventos de colores:

• Verde: ingresos recurrentes
• Rojo: gastos recurrentes
• Azul: transferencias recurrentes
• Amarillo: vencimiento de pago de tarjeta
• Morado: cuota de deuda
• Magenta: fecha objetivo de una meta

Haz clic en cualquier día para ver el detalle. A la derecha, el panel Próximos 30 días te muestra los eventos ordenados cronológicamente.

12. Deudas (Snowball / Avalanche)

Sidebar → Deudas. Lleva control de préstamos (no incluye tarjetas de crédito — esas se manejan como cuentas). Cada deuda tiene: saldo actual, pago mensual, tasa anual, día de pago, prioridad y estado.

Estrategias disponibles:

• Avalanche: priorizas la deuda con la tasa más alta. Te ahorra más dinero en intereses.
• Snowball: priorizas la deuda con menor saldo. Da impulso psicológico al ver deudas pagadas rápido.

La app proyecta en cuántos meses terminarías cada deuda con tu pago actual.

13. Metas y planes de ahorro

Sidebar → Metas → Nueva meta. Define:

• Nombre (ej. Fondo de emergencia, Viaje a México)
• Monto objetivo
• Ahorro actual
• Fecha objetivo

La app calcula automáticamente el aporte mensual recomendado, el progreso (%), si vas En ruta, Atrasada o Completada, y te alerta si el avance real es menor al tiempo transcurrido.

Puedes registrar aportes parciales con un clic desde cada tarjeta de meta.

14. Presupuestos por categoría

Define cuánto quieres gastar al mes en cada categoría. La app compara con lo que llevas gastado y muestra:

• OK — vas por debajo del 80%
• Cerca — entre 80% y 100%
• Excedido — pasaste el límite

Si excedes el presupuesto, aparece una alerta en el dashboard.

15. Dividir un gasto entre personas

Al crear un gasto, pulsa Dividir entre personas. Añade los participantes, el monto que a cada uno le toca, y marca quién ya pagó. Puedes dividir en partes iguales automáticamente con el botón Dividir en partes iguales.

La app valida que la suma de las partes cuadre con el total y muestra si falta o sobra.

16. Foto de recibos

Al crear o editar un gasto, pulsa Adjuntar recibo. Puedes subir una imagen o, en móvil, tomarla al instante con la cámara. La app la comprime y redimensiona para que ocupe poco espacio y se guarda junto al gasto.

17. Categorías jerárquicas

En Configuración → Categorías puedes crear subcategorías dentro de una categoría existente. Por ejemplo:

• Transporte
  • ↳ Gasolina
  • ↳ Uber
  • ↳ Mantenimiento

Las subcategorías aparecen con ↳ al elegirlas en el formulario de gasto.

18. Multi-moneda

En Configuración → Monedas y tipos de cambio, puedes elegir la moneda principal (por defecto HNL) y añadir tipos de cambio para otras monedas (USD, EUR, etc.).

La tasa se expresa como cuántas unidades de la moneda principal equivalen a 1 unidad de la moneda extranjera. Por ejemplo, si HNL es principal y pones USD = 24.70, quiere decir que 1 USD = 24.70 HNL.

Cuando registres un gasto, puedes elegir la moneda en el formulario. Los totales y KPIs se muestran en la principal.

19. Backup / importar JSON

Como toda la información vive en tu navegador, es muy importante respaldar regularmente. En Configuración → Datos y respaldo:

• Exportar backup JSON — descarga un archivo con todo: cuentas, transacciones, metas, configuración, etc.
• Importar JSON — restaura un respaldo desde un archivo.
• Exportar CSV — exporta módulos individuales.
• Restablecer demo — reemplaza tus datos con los datos de demostración.
• Borrar todo — elimina tus datos (no tu usuario).

20. Sincronización en la nube

Finanzas HNL usa Firebase Auth + Firestore como fuente de verdad. Cuando te registrás (email/password o Google Sign-In), tus datos se asocian a tu UID y se guardan en la nube con caché offline persistente.

• Multi-dispositivo: abrí la app en laptop, celular y tablet con el mismo correo. Cualquier cambio se refleja en vivo en los demás.
• Offline real: si perdés conexión, seguís registrando gastos/cobros/etc. La app sincroniza automáticamente cuando vuelve la red.
• Google Sign-In: botón en la página de login. Al primer ingreso crea tu perfil automáticamente y carga tu foto de perfil.

21. Seguridad y privacidad

Finanzas HNL corre 100% del lado del cliente; no hay servidor propio. Auth + Firestore de Google manejan la persistencia y seguridad.

• Las contraseñas jamás tocan tu código — Firebase Auth las gestiona con estándares bancarios (bcrypt + salting + rate limiting).
• Las Security Rules de Firestore garantizan que cada usuario solo lee/escribe su propio namespace.
• Podés cerrar sesión en cualquier dispositivo y los datos quedan solo en la nube — la app no almacena nada sensible en localStorage.

Para máxima seguridad: no uses computadoras compartidas, cerrá sesión al terminar, y activá verificación en dos pasos en tu cuenta de Google.