Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Davidmallega/Gastos-App/llms.txt

Use this file to discover all available pages before exploring further.

GastosApp es un sistema de control financiero de escritorio diseñado específicamente para pequeñas y medianas empresas chilenas. Construido sobre Electron y React, corre directamente en el computador del usuario sin necesidad de internet, servidores externos ni suscripciones mensuales. Está pensado para los tres perfiles que conviven en el día a día financiero de una empresa: el administrador que necesita una vista global, el encargado de caja que registra gastos sobre la marcha, y el contador que trabaja con documentos tributarios del SII.

Características principales

Facturas SII

Registra facturas electrónicas con folio, RUT proveedor y desglose neto/IVA/total. Vincula Notas de Crédito directamente a la factura que anulan.

Gastos por Caja

Registra pagos sin factura SII — efectivo, débito o transferencia — con o sin boleta. Incluye semáforo de salud y programación de pagos a fecha futura.

Compromisos Recurrentes

Define gastos periódicos (semanal, quincenal, mensual, bimestral, trimestral o anual) con seguimiento automático de estado: Vencido, Próximo, Registrado, Impago, Pendiente o Inactivo.

Informes

Resumen financiero por mes o año completo con tablas por categoría y proveedor, gráficos de evolución, distribución y comparativa, e impresión PDF con un solo clic.

Importar CSV SII

Stepper de 3 pasos para importar el Libro de Compras del SII (CSV latin1, delimitador ;). Detecta duplicados y auto-categoriza en 3 niveles.

Backup / Restore

Exporta e importa todos los datos en JSON. El restore aplica migraciones automáticas de esquema, por lo que los backups de versiones anteriores siempre son compatibles.

Stakeholders

GastosApp está diseñado alrededor de tres roles con necesidades distintas pero complementarias:
RolNecesidad principal
Administrador / DueñoVista global del año en curso: KPIs anuales, informes por categoría y proveedor, seguimiento de compromisos recurrentes y estado de pagos pendientes.
Encargado de cajaRegistro rápido de gastos diarios, marcado de pagos con fecha y método reales, consulta del semáforo de salud por antigüedad del documento.
ContadorImportación del Libro de Compras SII, gestión de Notas de Crédito vinculadas a facturas, generación de informes por período para cuadratura mensual.
Cada perfil accede a la misma instalación local; no existe gestión de usuarios ni autenticación, ya que GastosApp es una aplicación de escritorio monousuario.

Alcance

Incluido

  • Registro y control de gastos por caja y facturas SII (con Notas de Crédito)
  • Gestión de pagos pendientes y realizados con historial y función Revivir
  • Compromisos de gasto recurrente con 6 frecuencias y seguimiento automático de estado
  • Importación del Libro de Compras SII en formato CSV latin1
  • Informes financieros mensuales y anuales con impresión PDF
  • Backup y restore JSON con versionado de esquema y migraciones automáticas
  • Papelera con soft-delete, restauración y auto-purga a 30 días
  • Tema claro y oscuro con persistencia de preferencia

Fuera del alcance

  • Contabilidad formal o presentación de declaraciones al SII
  • Emisión de documentos tributarios (facturas, boletas, NC)
  • Sincronización en la nube o uso multiusuario simultáneo
  • IVA variable: la aplicación usa 19% fijo para todos los cálculos

Stack tecnológico

CapaTecnologíaVersión
DesktopElectron42.3
UIReact19.2
BuildVite8.0
EstilosTailwind CSS4.3
GráficosRecharts3.8
Parser CSVPapaParse5.5
Fechasdate-fns4.4
TestsVitest4.1
El estado global de la aplicación se gestiona mediante un store singleton a nivel de módulo, sin librerías externas como Redux o Zustand. Cada mutación persiste de forma inmediata en localStorage y notifica a todos los componentes suscritos.
GastosApp funciona 100% offline. Todos los datos viven en localStorage del proceso Electron, bajo la clave gastos_app_data. No se realiza ninguna conexión a internet durante el uso normal de la aplicación.

Build docs developers (and LLMs) love