# contactoiusasol/monitoreoiusasol architecture

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

- Interactive diagram: https://gitdiagram.com/contactoiusasol/monitoreoiusasol
- Repository: https://github.com/contactoiusasol/monitoreoiusasol

## Overview

Monitoreo IUSASOL is a private React dashboard for energy-monitoring and operational reporting. Users sign in, enter the protected dashboard, and choose views for generation, meters, contracts, reports, solar listings, or billing; billing loads workbook and meter-generation data to calculate invoice totals. Authentication is handled through Supabase, while the meter database view fetches a CSV. The graph preserves the documented route capabilities and major page modules; several page-to-data relationships are unverified because their implementations were not excerpted.

Main entry points: [`src/routes.jsx`](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/routes.jsx) (Route map), [`src/app.jsx`](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/app.jsx) (Application), [`src/contexts/auth-context.jsx`](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/contexts/auth-context.jsx) (Auth context), [`src/pages/facturacion.jsx`](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/facturacion.jsx) (Billing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_app["Application<br/>[app.jsx]"]
  node_routes["Route map<br/>[routes.jsx]"]
  node_dashboard["Dashboard layout<br/>[layout.jsx]"]
  node_private["Private route<br/>[private-route.jsx]"]
  node_loading["Loading screen<br/>[loading-screen.jsx]"]
end

subgraph group_identity["Authentication"]
  node_login["Login and signup<br/>[login.jsx]"]
  node_signup["Signup page<br/>[signup.jsx]"]
  node_auth["Auth context<br/>[auth-context.jsx]"]
  node_supabase["Supabase auth<br/>[supabase.js]"]
end

subgraph group_monitoring["Monitoring views"]
  node_charts["Generation charts<br/>[graficas.jsx]"]
  node_table["Generation table<br/>[tabla.jsx]"]
  node_five["Five-minute data<br/>[cincominutal.jsx]"]
  node_meter["Meter views<br/>[medidores.jsx]"]
  node_meterdb["Meter database"]
  node_csv["Meter CSV"]
  node_reports["Reports<br/>[reportes.jsx]"]
end

subgraph group_operations["Operations and billing"]
  node_porteo["Porteo view<br/>[porteo.jsx]"]
  node_contracts["Contracts<br/>[contratos.jsx]"]
  node_solar["Solar listing<br/>[listadoSFV.jsx]"]
  node_billing["Billing<br/>[facturacion.jsx]"]
  node_billingdata["Billing calculations<br/>[facturacion.js]"]
  node_receipt["Receipt PDF<br/>[recibo-pdf.jsx]"]
  node_settings["Settings<br/>[settings.jsx]"]
end

subgraph group_design["Shared presentation"]
  node_theme["Theme factory<br/>[index.jsx]"]
  node_components["Component styling"]
end

node_user(("Dashboard user"))

node_user -->|"opens"| node_app
node_app -->|"resolves routes"| node_routes
node_app -->|"provides auth"| node_auth
node_app -->|"creates theme"| node_theme
node_app -->|"shows while loading"| node_loading
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_signup
node_routes -->|"guards dashboard"| node_private
node_routes -->|"wraps private views"| node_dashboard
node_login -.->|"authenticates through"| node_auth
node_signup -.->|"registers through"| node_auth
node_auth -->|"calls auth API"| node_supabase
node_private -.->|"checks session"| node_auth
node_routes -->|"routes to"| node_charts
node_routes -->|"routes to"| node_table
node_routes -->|"routes to"| node_five
node_routes -->|"routes to"| node_meter
node_routes -->|"routes to"| node_meterdb
node_routes -->|"routes to"| node_reports
node_routes -->|"routes to"| node_porteo
node_routes -->|"routes to"| node_contracts
node_routes -->|"routes to"| node_solar
node_routes -->|"routes to"| node_billing
node_routes -->|"routes to"| node_settings
node_meterdb -->|"fetches"| node_csv
node_billing -->|"calls calculations"| node_billingdata
node_billing -.->|"renders receipt"| node_receipt
node_theme -->|"builds styles"| node_components

click node_app "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/app.jsx"
click node_routes "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/routes.jsx"
click node_dashboard "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/layouts/dashboard/layout.jsx"
click node_private "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/components/private-route.jsx"
click node_login "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/login.jsx"
click node_signup "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/signup.jsx"
click node_auth "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/contexts/auth-context.jsx"
click node_supabase "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/lib/supabase.js"
click node_charts "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/graficas.jsx"
click node_table "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/tabla.jsx"
click node_five "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/cincominutal.jsx"
click node_meter "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/medidores.jsx"
click node_meterdb "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/databaseiusasol.jsx"
click node_reports "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/reportes.jsx"
click node_porteo "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/porteo.jsx"
click node_contracts "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/contratos.jsx"
click node_solar "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/listadoSFV.jsx"
click node_billing "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/facturacion.jsx"
click node_billingdata "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/lib/facturacion.js"
click node_receipt "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/components/recibo-pdf.jsx"
click node_settings "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/settings.jsx"
click node_theme "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/theme/index.jsx"
click node_components "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/theme/create-components.jsx"
click node_loading "https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/components/loading-screen.jsx"

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_app,node_routes,node_dashboard,node_private,node_loading,node_user toneBlue
class node_login,node_signup,node_auth,node_supabase toneAmber
class node_charts,node_table,node_five,node_meter,node_meterdb,node_csv,node_reports toneMint
class node_porteo,node_contracts,node_solar,node_billing,node_billingdata,node_receipt,node_settings toneRose
class node_theme,node_components toneIndigo
```

## Components

### Application shell

- [Application](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/app.jsx): `src/app.jsx`
- [Route map](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/routes.jsx): `src/routes.jsx`
- [Dashboard layout](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/layouts/dashboard/layout.jsx): `src/layouts/dashboard/layout.jsx`
- [Private route](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/components/private-route.jsx): `src/components/private-route.jsx`
- [Loading screen](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/components/loading-screen.jsx): `src/components/loading-screen.jsx`

### Authentication

- [Login and signup](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/login.jsx): `src/pages/login.jsx`
- [Signup page](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/signup.jsx): `src/pages/signup.jsx`
- [Auth context](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/contexts/auth-context.jsx): `src/contexts/auth-context.jsx`
- [Supabase auth](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/lib/supabase.js): `src/lib/supabase.js`

### Monitoring views

- [Generation charts](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/graficas.jsx): `src/pages/graficas.jsx`
- [Generation table](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/tabla.jsx): `src/pages/tabla.jsx`
- [Five-minute data](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/cincominutal.jsx): `src/pages/cincominutal.jsx`
- [Meter views](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/medidores.jsx): `src/pages/medidores.jsx`
- [Meter database](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/databaseiusasol.jsx): `src/pages/databaseiusasol.jsx`
- **Meter CSV**
- [Reports](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/reportes.jsx): `src/pages/reportes.jsx`

### Operations and billing

- [Porteo view](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/porteo.jsx): `src/pages/porteo.jsx`
- [Contracts](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/contratos.jsx): `src/pages/contratos.jsx`
- [Solar listing](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/listadoSFV.jsx): `src/pages/listadoSFV.jsx`
- [Billing](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/facturacion.jsx): `src/pages/facturacion.jsx`
- [Billing calculations](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/lib/facturacion.js): `src/lib/facturacion.js`
- [Receipt PDF](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/components/recibo-pdf.jsx): `src/components/recibo-pdf.jsx`
- [Settings](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/pages/settings.jsx): `src/pages/settings.jsx`

### Shared presentation

- [Theme factory](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/theme/index.jsx): `src/theme/index.jsx`
- [Component styling](https://github.com/contactoiusasol/monitoreoiusasol/blob/main/src/theme/create-components.jsx): `src/theme/create-components.jsx`

### Other components

- **Dashboard user**

## Connections

- Dashboard user → Application: opens
- Application → Route map: resolves routes (evidence: `src/app.jsx`)
- Application → Auth context: provides auth (evidence: `src/app.jsx`)
- Application → Theme factory: creates theme (evidence: `src/app.jsx`)
- Application → Loading screen: shows while loading (evidence: `src/app.jsx`)
- Route map → Login and signup: routes to (evidence: `src/routes.jsx`)
- Route map → Signup page: routes to (evidence: `src/routes.jsx`)
- Route map → Private route: guards dashboard (evidence: `src/routes.jsx`)
- Route map → Dashboard layout: wraps private views (evidence: `src/routes.jsx`)
- Login and signup → Auth context: authenticates through
- Signup page → Auth context: registers through
- Auth context → Supabase auth: calls auth API (evidence: `src/contexts/auth-context.jsx`)
- Private route → Auth context: checks session
- Route map → Generation charts: routes to (evidence: `src/routes.jsx`)
- Route map → Generation table: routes to (evidence: `src/routes.jsx`)
- Route map → Five-minute data: routes to (evidence: `src/routes.jsx`)
- Route map → Meter views: routes to (evidence: `src/routes.jsx`)
- Route map → Meter database: routes to (evidence: `src/routes.jsx`)
- Route map → Reports: routes to (evidence: `src/routes.jsx`)
- Route map → Porteo view: routes to (evidence: `src/routes.jsx`)
- Route map → Contracts: routes to (evidence: `src/routes.jsx`)
- Route map → Solar listing: routes to (evidence: `src/routes.jsx`)
- Route map → Billing: routes to (evidence: `src/routes.jsx`)
- Route map → Settings: routes to (evidence: `src/routes.jsx`)
- Meter database → Meter CSV: fetches (evidence: `src/pages/databaseiusasol.jsx`)
- Billing → Billing calculations: calls calculations (evidence: `src/pages/facturacion.jsx`)
- Billing → Receipt PDF: renders receipt
- Theme factory → Component styling: builds styles (evidence: `src/theme/index.jsx`)
