# edualv1904/mis-finanzas architecture

> Architecture diagram of the GitHub repository edualv1904/mis-finanzas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edualv1904/mis-finanzas
- Repository: https://github.com/edualv1904/mis-finanzas

## Overview

Mis Finanzas es una app Android local para registrar y organizar gastos. El flujo principal recibe notificaciones bancarias, las interpreta, las deduplica y las guarda; la persona revisa movimientos no reconocidos y administra sus gastos desde la app. También ofrece captura manual, mensualidades, tarjetas, ubicación, widget y respaldos. El README documenta estas capacidades; las conexiones no visibles en los extractos se limitan a relaciones documentadas allí o se omiten.

Main entry points: [`app/src/main/java/com/misfinanzas/MainActivity.kt`](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/MainActivity.kt) (Actividad principal), [`app/src/main/java/com/misfinanzas/Registro.kt`](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Registro.kt) (Registro y deduplicación), [`app/src/main/java/com/misfinanzas/FinanzasViewModel.kt`](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/FinanzasViewModel.kt) (Estado de finanzas), [`app/src/main/java/com/misfinanzas/ui/App.kt`](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/App.kt) (Navegación principal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Captura e importación"]
  node_listener["Receptor de avisos<br/>[WalletListener.kt]"]
  node_parsers["Lectores bancarios<br/>[Parsers.kt]"]
  node_categories["Reglas de categoría<br/>[Categorias.kt]"]
  node_statements["Importación de estados<br/>[extraer_estados.py]"]
  node_importer["Carga de movimientos"]
end

subgraph group_records["Movimientos y datos"]
  node_registration["Registro y deduplicación<br/>[Registro.kt]"]
  node_database[("Base local Room<br/>[Db.kt]")]
  node_viewmodel["Estado de finanzas"]
end

subgraph group_app["App y consulta"]
  node_main["Actividad principal<br/>[MainActivity.kt]"]
  node_appui["Navegación principal<br/>[App.kt]"]
  node_transactions["Movimientos y resumen"]
  node_collected["Avisos recolectados"]
end

subgraph group_features["Funciones financieras"]
  node_cards["Tarjetas y ciclos"]
  node_installments["Compras a meses<br/>[Meses.kt]"]
  node_location["Ubicación de compras<br/>[Ubicacion.kt]"]
  node_map["Mapa de gastos<br/>[PantallaMapa.kt]"]
  node_widget["Widget y captura rápida<br/>[FinanzasWidget.kt]"]
  node_quick["Captura manual"]
end

subgraph group_services["Servicios auxiliares"]
  node_settings["Preferencias y acceso<br/>[Ajustes.kt]"]
  node_reminders["Avisos de pago<br/>[Recordatorios.kt]"]
  node_backup["Respaldo en Drive<br/>[Respaldo.kt]"]
end

node_person(("Persona usuaria"))
node_wallet{{"Wallet y bancos"}}
node_drive{{"Google Drive"}}

node_wallet -->|"envía avisos"| node_listener
node_listener -->|"interpreta"| node_parsers
node_parsers -->|"entrega pagos"| node_registration
node_registration -->|"categoriza"| node_categories
node_registration -->|"guarda y consulta"| node_database
node_person -->|"prepara estados"| node_statements
node_statements -->|"extrae movimientos"| node_importer
node_importer -->|"genera carga"| node_registration
node_main -->|"procesa cargas"| node_registration
node_main -->|"completa direcciones"| node_location
node_main -->|"muestra interfaz"| node_appui
node_appui -->|"obtiene estado"| node_viewmodel
node_appui -->|"navega a"| node_transactions
node_appui -->|"navega a"| node_collected
node_transactions -->|"consulta movimientos"| node_viewmodel
node_viewmodel -->|"lee movimientos"| node_database
node_viewmodel -->|"gestiona mensualidades"| node_installments
node_cards -->|"consulta tarjetas"| node_viewmodel
node_person -->|"revisa y edita"| node_transactions
node_transactions -->|"asigna lugar"| node_location
node_location -->|"actualiza ubicación"| node_database
node_map -->|"consulta compras ubicadas"| node_viewmodel
node_widget -->|"consulta totales"| node_database
node_widget -->|"abre captura"| node_quick
node_quick -->|"guarda movimiento"| node_registration
node_main -->|"carga preferencias"| node_settings
node_main -->|"programa avisos"| node_reminders
node_main -->|"programa respaldo"| node_backup
node_backup -->|"sube copias"| node_drive

click node_listener "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/WalletListener.kt"
click node_parsers "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Parsers.kt"
click node_categories "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Categorias.kt"
click node_statements "https://github.com/edualv1904/mis-finanzas/blob/main/herramientas/extraer_estados.py"
click node_importer "https://github.com/edualv1904/mis-finanzas/blob/main/herramientas/importar_estados.py"
click node_registration "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Registro.kt"
click node_database "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/data/Db.kt"
click node_viewmodel "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/FinanzasViewModel.kt"
click node_main "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/MainActivity.kt"
click node_appui "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/App.kt"
click node_transactions "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaPrincipal.kt"
click node_collected "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaRecolectadas.kt"
click node_cards "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaTarjetas.kt"
click node_installments "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Meses.kt"
click node_location "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Ubicacion.kt"
click node_map "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaMapa.kt"
click node_widget "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/widget/FinanzasWidget.kt"
click node_quick "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/CapturaRapidaActivity.kt"
click node_settings "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Ajustes.kt"
click node_reminders "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Recordatorios.kt"
click node_backup "https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Respaldo.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_listener,node_parsers,node_categories,node_statements,node_importer toneBlue
class node_registration,node_database,node_viewmodel toneAmber
class node_main,node_appui,node_transactions,node_collected toneMint
class node_cards,node_installments,node_location,node_map,node_widget,node_quick toneRose
class node_settings,node_reminders,node_backup,node_person,node_wallet,node_drive toneIndigo
```

## Components

### Captura e importación

- [Receptor de avisos](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/WalletListener.kt): `app/src/main/java/com/misfinanzas/WalletListener.kt`
- [Lectores bancarios](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Parsers.kt): `app/src/main/java/com/misfinanzas/Parsers.kt`
- [Reglas de categoría](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Categorias.kt): `app/src/main/java/com/misfinanzas/Categorias.kt`
- [Importación de estados](https://github.com/edualv1904/mis-finanzas/blob/main/herramientas/extraer_estados.py): `herramientas/extraer_estados.py`
- [Carga de movimientos](https://github.com/edualv1904/mis-finanzas/blob/main/herramientas/importar_estados.py): `herramientas/importar_estados.py`

### Movimientos y datos

- [Registro y deduplicación](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Registro.kt): `app/src/main/java/com/misfinanzas/Registro.kt`
- [Base local Room](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/data/Db.kt): `app/src/main/java/com/misfinanzas/data/Db.kt`
- [Estado de finanzas](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/FinanzasViewModel.kt): `app/src/main/java/com/misfinanzas/FinanzasViewModel.kt`

### App y consulta

- [Actividad principal](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/MainActivity.kt): `app/src/main/java/com/misfinanzas/MainActivity.kt`
- [Navegación principal](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/App.kt): `app/src/main/java/com/misfinanzas/ui/App.kt`
- [Movimientos y resumen](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaPrincipal.kt): `app/src/main/java/com/misfinanzas/ui/PantallaPrincipal.kt`
- [Avisos recolectados](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaRecolectadas.kt): `app/src/main/java/com/misfinanzas/ui/PantallaRecolectadas.kt`

### Funciones financieras

- [Tarjetas y ciclos](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaTarjetas.kt): `app/src/main/java/com/misfinanzas/ui/PantallaTarjetas.kt`
- [Compras a meses](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Meses.kt): `app/src/main/java/com/misfinanzas/Meses.kt`
- [Ubicación de compras](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Ubicacion.kt): `app/src/main/java/com/misfinanzas/Ubicacion.kt`
- [Mapa de gastos](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/ui/PantallaMapa.kt): `app/src/main/java/com/misfinanzas/ui/PantallaMapa.kt`
- [Widget y captura rápida](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/widget/FinanzasWidget.kt): `app/src/main/java/com/misfinanzas/widget/FinanzasWidget.kt`
- [Captura manual](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/CapturaRapidaActivity.kt): `app/src/main/java/com/misfinanzas/CapturaRapidaActivity.kt`

### Servicios auxiliares

- [Preferencias y acceso](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Ajustes.kt): `app/src/main/java/com/misfinanzas/Ajustes.kt`
- [Avisos de pago](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Recordatorios.kt): `app/src/main/java/com/misfinanzas/Recordatorios.kt`
- [Respaldo en Drive](https://github.com/edualv1904/mis-finanzas/blob/main/app/src/main/java/com/misfinanzas/Respaldo.kt): `app/src/main/java/com/misfinanzas/Respaldo.kt`

### Other components

- **Persona usuaria**
- **Wallet y bancos**
- **Google Drive**

## Connections

- Wallet y bancos → Receptor de avisos: envía avisos (evidence: `README.md`)
- Receptor de avisos → Lectores bancarios: interpreta (evidence: `README.md`)
- Lectores bancarios → Registro y deduplicación: entrega pagos (evidence: `README.md`)
- Registro y deduplicación → Reglas de categoría: categoriza (evidence: `app/src/main/java/com/misfinanzas/Registro.kt`)
- Registro y deduplicación → Base local Room: guarda y consulta (evidence: `app/src/main/java/com/misfinanzas/Registro.kt`)
- Persona usuaria → Importación de estados: prepara estados (evidence: `README.md`)
- Importación de estados → Carga de movimientos: extrae movimientos (evidence: `README.md`)
- Carga de movimientos → Registro y deduplicación: genera carga (evidence: `README.md`)
- Actividad principal → Registro y deduplicación: procesa cargas (evidence: `app/src/main/java/com/misfinanzas/MainActivity.kt`)
- Actividad principal → Ubicación de compras: completa direcciones (evidence: `app/src/main/java/com/misfinanzas/MainActivity.kt`)
- Actividad principal → Navegación principal: muestra interfaz (evidence: `app/src/main/java/com/misfinanzas/MainActivity.kt`)
- Navegación principal → Estado de finanzas: obtiene estado (evidence: `app/src/main/java/com/misfinanzas/ui/App.kt`)
- Navegación principal → Movimientos y resumen: navega a (evidence: `app/src/main/java/com/misfinanzas/ui/App.kt`)
- Navegación principal → Avisos recolectados: navega a (evidence: `app/src/main/java/com/misfinanzas/ui/App.kt`)
- Movimientos y resumen → Estado de finanzas: consulta movimientos (evidence: `app/src/main/java/com/misfinanzas/ui/PantallaPrincipal.kt`)
- Estado de finanzas → Base local Room: lee movimientos (evidence: `app/src/main/java/com/misfinanzas/FinanzasViewModel.kt`)
- Estado de finanzas → Compras a meses: gestiona mensualidades (evidence: `app/src/main/java/com/misfinanzas/FinanzasViewModel.kt`)
- Tarjetas y ciclos → Estado de finanzas: consulta tarjetas (evidence: `app/src/main/java/com/misfinanzas/ui/PantallaTarjetas.kt`)
- Persona usuaria → Movimientos y resumen: revisa y edita (evidence: `README.md`)
- Movimientos y resumen → Ubicación de compras: asigna lugar (evidence: `app/src/main/java/com/misfinanzas/ui/PantallaPrincipal.kt`)
- Ubicación de compras → Base local Room: actualiza ubicación (evidence: `app/src/main/java/com/misfinanzas/Ubicacion.kt`)
- Mapa de gastos → Estado de finanzas: consulta compras ubicadas (evidence: `app/src/main/java/com/misfinanzas/ui/PantallaMapa.kt`)
- Widget y captura rápida → Base local Room: consulta totales (evidence: `app/src/main/java/com/misfinanzas/widget/FinanzasWidget.kt`)
- Widget y captura rápida → Captura manual: abre captura (evidence: `app/src/main/java/com/misfinanzas/widget/FinanzasWidget.kt`)
- Captura manual → Registro y deduplicación: guarda movimiento (evidence: `app/src/main/java/com/misfinanzas/CapturaRapidaActivity.kt`)
- Actividad principal → Preferencias y acceso: carga preferencias (evidence: `app/src/main/java/com/misfinanzas/MainActivity.kt`)
- Actividad principal → Avisos de pago: programa avisos (evidence: `app/src/main/java/com/misfinanzas/MainActivity.kt`)
- Actividad principal → Respaldo en Drive: programa respaldo (evidence: `app/src/main/java/com/misfinanzas/MainActivity.kt`)
- Respaldo en Drive → Google Drive: sube copias (evidence: `app/src/main/java/com/misfinanzas/Respaldo.kt`)
