# jcanales1097/control-gastos architecture

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

- Interactive diagram: https://gitdiagram.com/jcanales1097/control-gastos
- Repository: https://github.com/jcanales1097/control-gastos

## Overview

Control de Gastos es una aplicación web familiar para importar movimientos de Money Manager, asignarlos y distribuirlos entre controles y proyectos, y permitir que usuarios autorizados consulten y registren gastos. El flujo principal va de la sincronización y revisión administrativa a la asignación, validación y consulta de saldos. El README documenta además vehículos, comprobantes, informes y operación sin conexión. La implementación de la interfaz no fue muestreada; sus subsistemas y vínculos se incluyen solo donde el README los describe. The graph reflects documented behavior, not inspected internals of index.html or supabase.sql.

Main entry points: [`index.html`](https://github.com/jcanales1097/control-gastos/blob/main/index.html) (Aplicación web), [`servidor.py`](https://github.com/jcanales1097/control-gastos/blob/main/servidor.py) (Servidor local), [`sw.js`](https://github.com/jcanales1097/control-gastos/blob/main/sw.js) (Caché y modo offline), [`config.js`](https://github.com/jcanales1097/control-gastos/blob/main/config.js) (Configuración Supabase)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g_ingest["Importación y asignación"]
  node_web_app["Aplicación web<br/>[index.html]"]
  node_sync["Sincronización<br/>[index.html]"]
  node_local_server["Servidor local<br/>[servidor.py]"]
  node_inbox["Bandeja y cambios<br/>[index.html]"]
  node_allocation["Asignaciones y divisiones<br/>[index.html]"]
  node_projects["Controles y proyectos<br/>[index.html]"]
end

subgraph group_g_access["Acceso y colaboración"]
  node_auth["Cuentas y acceso<br/>[index.html]"]
  node_review["Validación de registros<br/>[index.html]"]
  node_dashboard["Inicio y saldos<br/>[index.html]"]
  node_exports["Excel y reportes PDF<br/>[index.html]"]
end

subgraph group_g_vehicles["Vehículos y comprobantes"]
  node_vehicle_records["Fichas y mantenimiento<br/>[index.html]"]
  node_fuel_trips["Combustible y recorridos<br/>[index.html]"]
  node_receipts["Comprobantes y detalle<br/>[index.html]"]
end

subgraph group_g_platform["Plataforma y datos"]
  node_service_worker["Caché y modo offline<br/>[sw.js]"]
  node_config["Configuración Supabase<br/>[config.js]"]
  node_database_rules["Esquema y permisos<br/>[supabase.sql]"]
  node_supabase[("Supabase")]
  node_storage[("Supabase Storage")]
end

node_admin(("Administrador"))
node_members(("Participantes"))
node_money_manager["Money Manager"]

node_admin -->|"administra"| node_web_app
node_members -->|"consulta y registra"| node_web_app
node_admin -->|"inicia"| node_sync
node_sync -->|"solicita portal"| node_local_server
node_local_server -->|"lee movimientos"| node_money_manager
node_local_server -.->|"devuelve datos"| node_sync
node_sync -->|"importa y detecta cambios"| node_inbox
node_admin -->|"revisa movimientos"| node_inbox
node_admin -->|"asigna y divide"| node_allocation
node_inbox -->|"entrega pendientes"| node_allocation
node_allocation -->|"asigna a controles"| node_projects
node_admin -->|"activa usuarios"| node_auth
node_auth -->|"limita visibilidad"| node_projects
node_members -->|"envía registros"| node_review
node_admin -->|"aprueba o rechaza"| node_review
node_review -->|"actualiza saldos"| node_dashboard
node_projects -->|"muestra asignaciones"| node_dashboard
node_admin -->|"genera informes"| node_exports
node_admin -->|"gestiona vehículos"| node_vehicle_records
node_vehicle_records -->|"registra uso y servicio"| node_fuel_trips
node_fuel_trips -->|"vincula gastos"| node_allocation
node_members -->|"adjunta comprobantes"| node_receipts
node_receipts -->|"guarda archivos"| node_storage
node_web_app -.->|"lee configuración"| node_config
node_config -.->|"configura conexión"| node_supabase
node_web_app -->|"consulta y modifica datos"| node_supabase
node_database_rules -->|"define RLS"| node_supabase
node_service_worker -->|"sirve caché offline"| node_web_app
node_service_worker -->|"cachea lecturas"| node_supabase

click node_web_app "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_sync "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_local_server "https://github.com/jcanales1097/control-gastos/blob/main/servidor.py"
click node_inbox "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_allocation "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_projects "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_auth "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_review "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_dashboard "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_exports "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_vehicle_records "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_fuel_trips "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_receipts "https://github.com/jcanales1097/control-gastos/blob/main/index.html"
click node_service_worker "https://github.com/jcanales1097/control-gastos/blob/main/sw.js"
click node_config "https://github.com/jcanales1097/control-gastos/blob/main/config.js"
click node_database_rules "https://github.com/jcanales1097/control-gastos/blob/main/supabase.sql"

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_web_app,node_sync,node_local_server,node_inbox,node_allocation,node_projects toneBlue
class node_auth,node_review,node_dashboard,node_exports toneAmber
class node_vehicle_records,node_fuel_trips,node_receipts toneMint
class node_service_worker,node_config,node_database_rules,node_supabase,node_storage toneRose
class node_admin,node_members,node_money_manager toneIndigo
```

## Components

### Importación y asignación

- [Aplicación web](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Sincronización](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Servidor local](https://github.com/jcanales1097/control-gastos/blob/main/servidor.py): `servidor.py`
- [Bandeja y cambios](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Asignaciones y divisiones](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Controles y proyectos](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`

### Acceso y colaboración

- [Cuentas y acceso](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Validación de registros](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Inicio y saldos](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Excel y reportes PDF](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`

### Vehículos y comprobantes

- [Fichas y mantenimiento](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Combustible y recorridos](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`
- [Comprobantes y detalle](https://github.com/jcanales1097/control-gastos/blob/main/index.html): `index.html`

### Plataforma y datos

- [Caché y modo offline](https://github.com/jcanales1097/control-gastos/blob/main/sw.js): `sw.js`
- [Configuración Supabase](https://github.com/jcanales1097/control-gastos/blob/main/config.js): `config.js`
- [Esquema y permisos](https://github.com/jcanales1097/control-gastos/blob/main/supabase.sql): `supabase.sql`
- **Supabase**
- **Supabase Storage**

### Other components

- **Administrador**
- **Participantes**
- **Money Manager**

## Connections

- Administrador → Aplicación web: administra (evidence: `README.md`)
- Participantes → Aplicación web: consulta y registra (evidence: `README.md`)
- Administrador → Sincronización: inicia (evidence: `README.md`)
- Sincronización → Servidor local: solicita portal (evidence: `README.md`)
- Servidor local → Money Manager: lee movimientos (evidence: `servidor.py`)
- Servidor local → Sincronización: devuelve datos
- Sincronización → Bandeja y cambios: importa y detecta cambios (evidence: `README.md`)
- Administrador → Bandeja y cambios: revisa movimientos (evidence: `README.md`)
- Administrador → Asignaciones y divisiones: asigna y divide (evidence: `README.md`)
- Bandeja y cambios → Asignaciones y divisiones: entrega pendientes (evidence: `README.md`)
- Asignaciones y divisiones → Controles y proyectos: asigna a controles (evidence: `README.md`)
- Administrador → Cuentas y acceso: activa usuarios (evidence: `README.md`)
- Cuentas y acceso → Controles y proyectos: limita visibilidad (evidence: `README.md`)
- Participantes → Validación de registros: envía registros (evidence: `README.md`)
- Administrador → Validación de registros: aprueba o rechaza (evidence: `README.md`)
- Validación de registros → Inicio y saldos: actualiza saldos (evidence: `README.md`)
- Controles y proyectos → Inicio y saldos: muestra asignaciones (evidence: `README.md`)
- Administrador → Excel y reportes PDF: genera informes (evidence: `README.md`)
- Administrador → Fichas y mantenimiento: gestiona vehículos (evidence: `README.md`)
- Fichas y mantenimiento → Combustible y recorridos: registra uso y servicio (evidence: `README.md`)
- Combustible y recorridos → Asignaciones y divisiones: vincula gastos (evidence: `README.md`)
- Participantes → Comprobantes y detalle: adjunta comprobantes (evidence: `README.md`)
- Comprobantes y detalle → Supabase Storage: guarda archivos (evidence: `README.md`)
- Aplicación web → Configuración Supabase: lee configuración
- Configuración Supabase → Supabase: configura conexión
- Aplicación web → Supabase: consulta y modifica datos (evidence: `README.md`)
- Esquema y permisos → Supabase: define RLS (evidence: `README.md`)
- Caché y modo offline → Aplicación web: sirve caché offline (evidence: `sw.js`)
- Caché y modo offline → Supabase: cachea lecturas (evidence: `sw.js`)
