# jjpedrique/garita architecture

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

- Interactive diagram: https://gitdiagram.com/jjpedrique/garita
- Repository: https://github.com/jjpedrique/garita

## Overview

Garita is a Java desktop system for neighborhood-association administration and gated access. Users sign in, then role-sensitive navigation exposes residence, access-control, fee, reporting, audit, and maintenance functions. Its central business rule is that a home’s payment status determines whether access can be automatic or must be handled manually. The graph shows documented navigation, sampled database access, and the payment-status capability; several subsystems are represented at their exact source paths because their internals were not sampled.

Main entry points: [`src/Frontend/MenuPrincipal.java`](https://github.com/jjpedrique/garita/blob/main/src/Frontend/MenuPrincipal.java) (Role-based navigation), [`src/Backend/ConexionPostgres.java`](https://github.com/jjpedrique/garita/blob/main/src/Backend/ConexionPostgres.java) (Postgres access layer), [`src/Frontend/InicioSesion/MenuInicioSesion.java`](https://github.com/jjpedrique/garita/blob/main/src/Frontend/InicioSesion/MenuInicioSesion.java) (Sign-in and recovery), [`src/Frontend/ControlDeAcceso/MenuControlDeAcceso.java`](https://github.com/jjpedrique/garita/blob/main/src/Frontend/ControlDeAcceso/MenuControlDeAcceso.java) (Access control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["Application launcher<br/>[App.java]"]
  node_navigation["Role-based navigation<br/>[MenuPrincipal.java]"]
end

subgraph group_access["Identity and access"]
  node_login["Sign-in and recovery"]
  node_accessmenu["Access control"]
  node_accessrecords["Access records"]
  node_credentials["Resident credentials<br/>[MenuCarnets.java]"]
end

subgraph group_operations["Association operations"]
  node_fees["Fee administration<br/>[MenuCuotas.java]"]
  node_residence["Residence management"]
  node_homes["Home and resident records<br/>[MenuVivienda.java]"]
  node_payments["Payment and solvency<br/>[CuotasService.java]"]
  node_representatives["Representative records"]
  node_maintenance["System maintenance"]
  node_useradmin["User administration"]
  node_backup["Database backup"]
end

subgraph group_insight["Reporting and audit"]
  node_reports["Reports<br/>[MenuReporte.java]"]
  node_audit["Activity log<br/>[MenuBitacora.java]"]
end

subgraph group_platform["Shared services"]
  node_session["User session<br/>[SesionUsuario.java]"]
  node_databaseapi["Postgres access layer"]
  node_postgres[("PostgreSQL database")]
  node_theme["Swing theme utilities<br/>[ThemeManager.java]"]
end

node_operator(("System user"))

node_operator -->|"signs in"| node_login
node_app -->|"opens"| node_login
node_login -->|"starts session"| node_session
node_login -->|"opens after login"| node_navigation
node_navigation -->|"routes to"| node_accessmenu
node_navigation -->|"routes to"| node_residence
node_navigation -->|"routes to"| node_fees
node_navigation -->|"routes to"| node_reports
node_navigation -->|"routes to"| node_audit
node_navigation -->|"routes to"| node_maintenance
node_accessmenu -->|"opens records"| node_accessrecords
node_accessmenu -->|"opens credentials"| node_credentials
node_residence -->|"opens homes"| node_homes
node_residence -->|"opens representatives"| node_representatives
node_homes -->|"checks dues"| node_payments
node_reports -->|"queries data"| node_databaseapi
node_accessrecords -->|"queries records"| node_databaseapi
node_fees -->|"updates fees"| node_databaseapi
node_payments -->|"queries dues"| node_databaseapi
node_useradmin -->|"manages users"| node_databaseapi
node_maintenance -->|"opens user admin"| node_useradmin
node_maintenance -->|"opens backups"| node_backup
node_backup -->|"runs backup"| node_databaseapi
node_databaseapi -->|"executes SQL"| node_postgres
node_payments -.->|"determines solvency"| node_homes

click node_app "https://github.com/jjpedrique/garita/blob/main/src/App.java"
click node_login "https://github.com/jjpedrique/garita/blob/main/src/Frontend/InicioSesion/MenuInicioSesion.java"
click node_session "https://github.com/jjpedrique/garita/blob/main/src/Backend/SesionUsuario.java"
click node_navigation "https://github.com/jjpedrique/garita/blob/main/src/Frontend/MenuPrincipal.java"
click node_accessmenu "https://github.com/jjpedrique/garita/blob/main/src/Frontend/ControlDeAcceso/MenuControlDeAcceso.java"
click node_accessrecords "https://github.com/jjpedrique/garita/blob/main/src/Frontend/ControlDeAcceso/MenuRegistroDeAcceso.java"
click node_credentials "https://github.com/jjpedrique/garita/blob/main/src/Frontend/ControlDeAcceso/MenuCarnets.java"
click node_fees "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Cuotas/MenuCuotas.java"
click node_residence "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/MenuResidencia.java"
click node_homes "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/MenuVivienda.java"
click node_payments "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/CuotasService.java"
click node_representatives "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/MenuRepresentante.java"
click node_reports "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Reportes/MenuReporte.java"
click node_audit "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Bitacora/MenuBitacora.java"
click node_maintenance "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Mantenimiento/MenuMantenimiento.java"
click node_useradmin "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Mantenimiento/Usuarios/SubMenuUsuarios.java"
click node_backup "https://github.com/jjpedrique/garita/blob/main/src/Frontend/Mantenimiento/SubMenuGestionDeRespaldos.java"
click node_databaseapi "https://github.com/jjpedrique/garita/blob/main/src/Backend/ConexionPostgres.java"
click node_theme "https://github.com/jjpedrique/garita/blob/main/src/Backend/ThemeManager.java"

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_navigation,node_operator toneBlue
class node_login,node_accessmenu,node_accessrecords,node_credentials toneAmber
class node_fees,node_residence,node_homes,node_payments,node_representatives,node_maintenance,node_useradmin,node_backup toneMint
class node_reports,node_audit toneRose
class node_session,node_databaseapi,node_postgres,node_theme toneIndigo
```

## Components

### Application entry

- [Application launcher](https://github.com/jjpedrique/garita/blob/main/src/App.java): `src/App.java`
- [Role-based navigation](https://github.com/jjpedrique/garita/blob/main/src/Frontend/MenuPrincipal.java): `src/Frontend/MenuPrincipal.java`

### Identity and access

- [Sign-in and recovery](https://github.com/jjpedrique/garita/blob/main/src/Frontend/InicioSesion/MenuInicioSesion.java): `src/Frontend/InicioSesion/MenuInicioSesion.java`
- [Access control](https://github.com/jjpedrique/garita/blob/main/src/Frontend/ControlDeAcceso/MenuControlDeAcceso.java): `src/Frontend/ControlDeAcceso/MenuControlDeAcceso.java`
- [Access records](https://github.com/jjpedrique/garita/blob/main/src/Frontend/ControlDeAcceso/MenuRegistroDeAcceso.java): `src/Frontend/ControlDeAcceso/MenuRegistroDeAcceso.java`
- [Resident credentials](https://github.com/jjpedrique/garita/blob/main/src/Frontend/ControlDeAcceso/MenuCarnets.java): `src/Frontend/ControlDeAcceso/MenuCarnets.java`

### Association operations

- [Fee administration](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Cuotas/MenuCuotas.java): `src/Frontend/Cuotas/MenuCuotas.java`
- [Residence management](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/MenuResidencia.java): `src/Frontend/Residencia/MenuResidencia.java`
- [Home and resident records](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/MenuVivienda.java): `src/Frontend/Residencia/MenuVivienda.java`
- [Payment and solvency](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/CuotasService.java): `src/Frontend/Residencia/CuotasService.java`
- [Representative records](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Residencia/MenuRepresentante.java): `src/Frontend/Residencia/MenuRepresentante.java`
- [System maintenance](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Mantenimiento/MenuMantenimiento.java): `src/Frontend/Mantenimiento/MenuMantenimiento.java`
- [User administration](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Mantenimiento/Usuarios/SubMenuUsuarios.java): `src/Frontend/Mantenimiento/Usuarios/SubMenuUsuarios.java`
- [Database backup](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Mantenimiento/SubMenuGestionDeRespaldos.java): `src/Frontend/Mantenimiento/SubMenuGestionDeRespaldos.java`

### Reporting and audit

- [Reports](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Reportes/MenuReporte.java): `src/Frontend/Reportes/MenuReporte.java`
- [Activity log](https://github.com/jjpedrique/garita/blob/main/src/Frontend/Bitacora/MenuBitacora.java): `src/Frontend/Bitacora/MenuBitacora.java`

### Shared services

- [User session](https://github.com/jjpedrique/garita/blob/main/src/Backend/SesionUsuario.java): `src/Backend/SesionUsuario.java`
- [Postgres access layer](https://github.com/jjpedrique/garita/blob/main/src/Backend/ConexionPostgres.java): `src/Backend/ConexionPostgres.java`
- **PostgreSQL database**
- [Swing theme utilities](https://github.com/jjpedrique/garita/blob/main/src/Backend/ThemeManager.java): `src/Backend/ThemeManager.java`

### Other components

- **System user**

## Connections

- System user → Sign-in and recovery: signs in
- Application launcher → Sign-in and recovery: opens (evidence: `src/App.java`)
- Sign-in and recovery → User session: starts session (evidence: `src/Frontend/InicioSesion/MenuInicioSesion.java`)
- Sign-in and recovery → Role-based navigation: opens after login (evidence: `src/Frontend/InicioSesion/MenuInicioSesion.java`)
- Role-based navigation → Access control: routes to (evidence: `src/Frontend/MenuPrincipal.java`)
- Role-based navigation → Residence management: routes to (evidence: `src/Frontend/MenuPrincipal.java`)
- Role-based navigation → Fee administration: routes to (evidence: `src/Frontend/MenuPrincipal.java`)
- Role-based navigation → Reports: routes to (evidence: `src/Frontend/MenuPrincipal.java`)
- Role-based navigation → Activity log: routes to (evidence: `src/Frontend/MenuPrincipal.java`)
- Role-based navigation → System maintenance: routes to (evidence: `src/Frontend/MenuPrincipal.java`)
- Access control → Access records: opens records (evidence: `src/Frontend/ControlDeAcceso/MenuControlDeAcceso.java`)
- Access control → Resident credentials: opens credentials (evidence: `src/Frontend/ControlDeAcceso/MenuControlDeAcceso.java`)
- Residence management → Home and resident records: opens homes (evidence: `src/Frontend/Residencia/MenuResidencia.java`)
- Residence management → Representative records: opens representatives (evidence: `src/Frontend/Residencia/MenuResidencia.java`)
- Home and resident records → Payment and solvency: checks dues (evidence: `src/Frontend/Residencia/MenuVivienda.java`)
- Reports → Postgres access layer: queries data (evidence: `src/Frontend/Reportes/MenuReporte.java`)
- Access records → Postgres access layer: queries records (evidence: `src/Frontend/ControlDeAcceso/MenuRegistroDeAcceso.java`)
- Fee administration → Postgres access layer: updates fees (evidence: `src/Frontend/Cuotas/MenuCuotas.java`)
- Payment and solvency → Postgres access layer: queries dues (evidence: `src/Frontend/Residencia/CuotasService.java`)
- User administration → Postgres access layer: manages users (evidence: `src/Frontend/Mantenimiento/Usuarios/SubMenuUsuarios.java`)
- System maintenance → User administration: opens user admin (evidence: `src/Frontend/Mantenimiento/MenuMantenimiento.java`)
- System maintenance → Database backup: opens backups (evidence: `src/Frontend/Mantenimiento/MenuMantenimiento.java`)
- Database backup → Postgres access layer: runs backup (evidence: `src/Frontend/Mantenimiento/SubMenuGestionDeRespaldos.java`)
- Postgres access layer → PostgreSQL database: executes SQL (evidence: `src/Backend/ConexionPostgres.java`)
- Payment and solvency → Home and resident records: determines solvency (evidence: `src/Frontend/Residencia/MenuVivienda.java`)
