WeekBalance - Manual de Usuario
WeekBalance es una app de finanzas personales que combina una experiencia móvil construida con Expo/React Native y un backend en la nube. Estápensada para que controles tu dinero semana a semana (domingo a sábado).
Todo se sincroniza automáticamente con los servicios de Supabase, por lo que conservás tus datos aunque cambies de dispositivo.
Requisitos del Sistema
phone_android Dispositivo Compatible
- Android 8.0 o superior / iOS 13.0 o superior.
- Pantalla mínima 360 x 640 px.
- Al menos 150 MB de memoria disponible.
wifi Conexión a Internet
Es obligatoria para registrar cuenta, iniciar sesión, sincronizar movimientos y ver reportes. Si perdés señal temporalmente vas a seguir viendo los últimos datos cargados.
storage Espacio en el Dispositivo
- Instalación ~80 MB (Expo + assets).
- Recomendado 200 MB libres.
Almacenamiento de Datos
Cómo se Guardan tus Datos
- Nube (Supabase Postgres): Cada transacción, meta y perfil se guarda en la base central. Iniciar sesión desde otro teléfono recupera tu historial inmediatamente.
- Dispositivo: Solo se guarda el token de sesión cifrado (AsyncStorage) para mantenerte autenticado.
| Situación | ¿Qué sucede con tus datos? |
|---|---|
| Desinstalar la app | Al reinstalar e iniciar sesión, se sincronizan nuevamente tus datos desde Supabase. |
| Cambiar de teléfono | Basta con instalar WeekBalance e iniciar sesión con tu correo/contraseña originales. |
| Formatear el dispositivo | Los datos persisten en la nube; solo necesitás recordar tus credenciales. |
| Sin conexión | Podés revisar lo último cargado, pero las operaciones quedan pendientes hasta reconectar. |
Inicio Rápido
1. Crea tu cuenta
- Abrí la app.
- Tocá "Regístrate".
- Completá nombre, correo y contraseña (mínimo 6 caracteres).
- Confirmá con "Crear cuenta".
Tu sesión se inicia de forma automática y se genera tu cuenta financiera con saldo inicial 0.
2. Agrega tu primer ingreso
- Desde la barra inferior elegí Ingresos.
- Toca el botón flotante "Agregar".
- Elegí una categoría (ej. "Trabajo").
- Escribí la descripción.
- Ingresá el monto y confirmá con Guardar.
3. Registra un gasto
- Cambiá a la pestaña Gastos.
- Pulsá "Agregar".
- Seleccioná la categoría correspondiente (ej. "Comida").
- Ingresá descripción y monto.
- Confirmá con "Guardar".
En segundos vas a ver cómo cambian tu balance y la meta semanal.
Funcionalidades
person_add Registro e Inicio de Sesión
Crear una cuenta nueva
- Pulsá "Regístrate".
- Cargá tu nombre completo, correo y contraseña.
- Confirmá con "Crear cuenta".
El sistema crea tu perfil, cuenta y sesión en Supabase automáticamente.
Iniciar sesión
- Introducí correo y contraseña.
- Tocá "Iniciar sesión".
- Esperá la sincronización inicial (balance y movimientos se cargan desde la nube).
Cerrar sesión
- Desde cualquier pantalla, tocá tu avatar (arriba a la izquierda).
- Seleccioná Cerrar sesión y confirmá.
Esto borra el token local y regresa a la pantalla de autenticación.
trending_up Gestionar Ingresos
Los ingresos representan entradas de dinero (sueldos, freelance, regalos, etc.).
Ver historial
- Abrí Ingresos.
- Deslizá para ver grupos semanales (domingo a sábado).
- Tocá un registro para abrirlo en modo edición.
Filtrar
Utilizá el carrusel de categorías ("Todo", "Trabajo", "Regalo", etc.) para mostrar solo lo relevante. El resumen semanal se recalcula según el filtro activo.
Agregar
- Botón flotante Agregar.
- Seleccioná categoría.
- Descripción opcional pero recomendable.
- Monto positivo con dos decimales.
- Guardá. El backend ajusta tu saldo y las metas automáticamente.
Editar un ingreso
- Desde la lista, tocá el movimiento.
- Modificá monto, categoría o descripción.
- Confirmá con Actualizar ingreso.
La actualización se envía a la API /incomes/update/ y se refleja en balance y metas.
payments Gestionar Gastos
Los gastos abarcan todo egreso (alimentación, transporte, ocio, etc.).
Ver historial
- Abrí Gastos.
- Revisá los bloques semanales con totales y fechas.
- Cada tarjeta se puede presionar para editar.
Filtrar
Usá el slider de categorías ("Todo", "Comida", "Viajes", etc.). Además se muestra el total semanal acumulado en la parte superior.
Registrar un gasto
- Botón flotante Agregar.
- Seleccioná categoría.
- Ingresá monto y nota.
- Guardá. Si el monto supera tu saldo disponible, la app te avisa antes de enviar.
Editar un gasto
- Desde el historial, tocá la transacción.
- Ajustá categoría, descripción o monto.
- Confirmá con Actualizar gasto.
La operación se realiza vía /expenses/update/; el saldo y las metas se recalculan al instante.
savings Sistema de Ahorro
La sección Ahorros gestiona metas semanales basadas en tu flujo real.
Panel principal
- Meta semanal activa (progreso, monto restante, estado).
- Métricas de la semana: total ahorrado vs meta, progreso porcentual.
- Historial de metas pasadas con estado ("Completada", "Incompleta", "Extra").
Crear una meta semanal
- En Ahorros, tocá Crear meta semanal.
- Ingresá el monto objetivo.
- Guardá. Si ya existe una meta activa para la semana, la app te lo informará.
Seguimiento y ajustes
Si gastás más de lo planificado, el progreso mostrará alerta "Meta incompleta". Podés crear nuevas metas cada semana; las semanas anteriores quedan sólo para consulta. No hay eliminación retroactiva de metas ya cerradas.
account_balance_wallet Entender tu Balance
Balance = Ingresos totales - Gastos totales En Inicio encontrás:
- CardCurrentFound: muestra saldo actual, totales de ingresos/gastos acumulados.
- Resumen semanal: ingresos, gastos y ahorro esperado para la semana vigente.
- Tendencia diaria/semanal: gráficos de línea con comportamiento por día.
- Gastos recientes: últimos movimientos para control rápido.
Desde cada bloque podés navegar a historiales detallados o a la sección de metas.
Limitaciones Actuales
- Sin eliminación de movimientos: podés editar ingresos/gastos, pero no borrarlos. Para corregir errores considerá un movimiento compensatorio.
- Sin recuperación automática de contraseña: si la olvidás, necesitás contacto con soporte para resetear manualmente.
- Cambios de correo no soportados: el email queda fijo tras el registro.
- Metas históricas bloqueadas: metas de semanas anteriores son de solo lectura.
Recomendaciones de Uso
- Registrá movimientos al instante - Cargar ingresos/gastos en el momento evita olvidos y mantiene los cálculos al día.
- Revisá el resumen semanal los domingos - Ajustá metas o gastos según lo observado en el tablero semanal.
- Usá categorías consistentes - Mantener la misma categoría simplifica el análisis de la gráfica por rubros.
- Actualizá tu nombre desde Perfil - Así los reportes y notificaciones muestran información correcta.
- Verificá tu conexión antes de cerrar la app - Si quedaste sin internet, abrí nuevamente la app al reconectar para sincronizar pendientes.
Problemas Comunes
No puedo iniciar sesión
Revisá:
- Credenciales exactas (correo sin espacios, contraseña válida).
- Conexión estable. Si Supabase tarda en responder, la app mostrará "El servidor se está iniciando". Probá nuevamente luego de unos segundos.
- Si olvidaste la contraseña, por ahora necesitás registrarte con otro correo.
No puedo guardar un ingreso/gasto
- Confirmá categoría seleccionada.
- Verificá que el monto sea positivo y numérico (1500.50).
- Revisá tu saldo disponible: la app bloquea gastos mayores al balance para evitar números negativos.
- Chequeá tu conexión; sin internet la petición queda en error.
No encuentro Ahorros
En la pantalla Inicio, desplazate hasta la tarjeta "Mis Ahorros" y tocá Ver detalles o el botón correspondiente. También podés acceder desde accesos directos en encabezados cuando hay metas activas.
La app muestra "meta en riesgo"
Significa que tus gastos semanales superan el plan de ahorro. Revisa el histórico y ajustá compras futuras o incrementá ingresos para compensar.
Los datos no se actualizan
- Desliza hacia abajo en las listas para refrescar (pull-to-refresh) cuando esté disponible.
- Cierra sesión y vuelve a iniciar si persiste.
- Reiniciá el dispositivo. Si el problema continúa, contactá soporte con la hora exacta del fallo.
Quiero corregir un movimiento erróneo
- Ingresos/Gastos: abrí el registro desde el historial y usá la pantalla de Editar para ajustar. No se puede borrar.
- Metas de ahorro: solo podés crear una nueva para la semana actual; las anteriores quedan bloqueadas.
Glosario
| Término | Significado |
|---|---|
| Balance | Diferencia entre ingresos y gastos acumulados. |
| Ingreso | Entrada de dinero (sueldo, freelance, regalos, etc.). |
| Gasto | Salida de dinero (comida, transporte, ocio, etc.). |
| Meta semanal | Objetivo de ahorro para la semana en curso. |
| Semana | Periodo de domingo a sábado usado para agrupar movimientos. |
| Categoría | Etiqueta que clasifica movimientos para análisis y filtros. |
| Tendencia | Gráfico que resume el comportamiento de tus gastos/ingresos. |
| Saldo disponible | Dinero restante en tu cuenta después de los movimientos actuales. |
Categorías Disponibles
Categorías de Ingresos
- Trabajo - Sueldos, honorarios, comisiones.
- Regalo - Transferencias de familiares/amigos.
- Reintegro - Devoluciones o reembolsos.
- Otros - Entradas esporádicas no cubiertas por las anteriores.
Categorías de Gastos
- Comida - Supermercado, restaurantes, snacks.
- Viajes - Transporte público, gasolina, movilidad.
- Compras - Ropa, tecnología, artículos personales.
- Salud - Consultas médicas, farmacia, seguros.
- Ocio - Cine, suscripciones, actividades recreativas.
Contacto y Soporte
Ante errores persistentes o solicitudes de nuevas funciones, escribinos al canal oficial del proyecto o por correo al equipo de WeekBalance. Incluí capturas y hora del incidente para acelerar el diagnóstico.