# panghys/generador-mapas-de-ruido-web architecture

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

- Interactive diagram: https://gitdiagram.com/panghys/generador-mapas-de-ruido-web
- Repository: https://github.com/panghys/generador-mapas-de-ruido-web

## Overview

This is a web application for managing users and noise-mapping projects. The main workflow is to authenticate, create or open a project, define its geographic area, trace streets and enter traffic data, calculate street-noise levels, then preview and export a noise map. The backend enforces project ownership and persists users, projects, and streets. The README documents Docker-based operation but does not describe additional product behavior. Some frontend capabilities are represented from the file tree and SOURCE INDEX; their internal wiring is therefore left unspecified.

Main entry points: [`Frontend/src/components/proyecto/MapaProyecto.jsx`](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/MapaProyecto.jsx) (Project map), [`Frontend/src/App.jsx`](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/App.jsx) (App routing), [`Backend/src/routes/project.routes.js`](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/routes/project.routes.js) (Project routes), [`Backend/src/controllers/street.controller.js`](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/controllers/street.controller.js) (Street operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_project_ui["Project screens<br/>[Proyecto.jsx]"]
  node_project_create["Project creation<br/>[ProyectoNuevo.jsx]"]
  node_http_client["API client<br/>[clienteAxios.js]"]
end

subgraph group_api["Backend API"]
  node_backend["HTTP application<br/>[app.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_project_routes["Project routes<br/>[project.routes.js]"]
  node_street_routes["Street routes<br/>[street.routes.js]"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_project_controller["Project operations"]
  node_street_controller["Street operations"]
  node_token["Token verification<br/>[verifyToken.js]"]
end

subgraph group_domain["Noise mapping"]
  node_map_ui["Project map<br/>[MapaProyecto.jsx]"]
  node_street_form["Street editor<br/>[CalleModal.jsx]"]
  node_map_raster["Noise raster<br/>[CapaRuidoRaster.js]"]
  node_noise_levels["Noise levels<br/>[nivelesRuido.js]"]
  node_local_noise["Local noise<br/>[ruidoLocal.js]"]
  node_propagation["Noise propagation"]
  node_map_export["Map export"]
  node_noise_calculator["RLS-90 calculator"]
end

subgraph group_persistence["Persistence"]
  node_project_repository["Project repository"]
  node_street_repository["Street repository"]
  node_user_repository["User repository<br/>[user.repository.js]"]
  node_project_model["Project model<br/>[Project.js]"]
  node_street_model["Street model<br/>[Street.js]"]
  node_user_model["User model<br/>[User.js]"]
  node_database[("MariaDB connection<br/>[database.js]")]
end

node_visitor(("User"))
node_google(("Google identity"))
node_osm(("OpenStreetMap"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_project_ui
node_app -->|"routes to"| node_project_create
node_app -->|"routes to"| node_map_ui
node_project_ui -->|"requests via"| node_http_client
node_map_ui -->|"requests via"| node_http_client
node_map_ui -->|"opens"| node_street_form
node_map_ui -->|"calculates with"| node_local_noise
node_map_ui -->|"colors with"| node_noise_levels
node_map_ui -->|"exports through"| node_map_export
node_map_export -->|"uses"| node_noise_levels
node_map_export -->|"uses"| node_propagation
node_http_client -->|"sends API requests"| node_backend
node_backend -->|"mounts"| node_auth_routes
node_backend -->|"mounts"| node_project_routes
node_project_routes -->|"requires"| node_token
node_project_routes -->|"dispatches"| node_project_controller
node_project_routes -->|"mounts"| node_street_routes
node_street_routes -->|"requires"| node_token
node_street_routes -->|"dispatches"| node_street_controller
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"reads and writes"| node_user_repository
node_auth_controller -->|"verifies identity"| node_google
node_project_controller -->|"reads and writes"| node_project_repository
node_street_controller -->|"checks ownership"| node_project_repository
node_street_controller -->|"reads and writes"| node_street_repository
node_street_controller -->|"calculates noise"| node_noise_calculator
node_project_repository -->|"queries"| node_project_model
node_street_repository -->|"queries"| node_street_model
node_user_repository -->|"queries"| node_user_model
node_project_model -->|"uses connection"| node_database
node_street_model -->|"uses connection"| node_database
node_user_model -->|"uses connection"| node_database
node_map_ui -.->|"uses map data"| node_osm
node_map_ui -.->|"renders noise layer"| node_map_raster

click node_app "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/App.jsx"
click node_login "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/Login.jsx"
click node_project_ui "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/Proyecto.jsx"
click node_project_create "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/ProyectoNuevo.jsx"
click node_map_ui "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/MapaProyecto.jsx"
click node_street_form "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/CalleModal.jsx"
click node_map_raster "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/CapaRuidoRaster.js"
click node_noise_levels "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/nivelesRuido.js"
click node_local_noise "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/ruidoLocal.js"
click node_propagation "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/ruidoPropagacion.js"
click node_map_export "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/exportarMapaRuido.js"
click node_http_client "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/config/clienteAxios.js"
click node_backend "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/app.js"
click node_auth_routes "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/routes/auth.routes.js"
click node_project_routes "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/routes/project.routes.js"
click node_street_routes "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/routes/street.routes.js"
click node_auth_controller "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/controllers/auth.controller.js"
click node_project_controller "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/controllers/project.controller.js"
click node_street_controller "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/controllers/street.controller.js"
click node_token "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/middlewares/verifyToken.js"
click node_noise_calculator "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/services/ruido.calculator.js"
click node_project_repository "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/repository/project.repository.js"
click node_street_repository "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/repository/street.repository.js"
click node_user_repository "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/repository/user.repository.js"
click node_project_model "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/models/Project.js"
click node_street_model "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/models/Street.js"
click node_user_model "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/models/User.js"
click node_database "https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/database/database.js"

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_login,node_project_ui,node_project_create,node_http_client,node_visitor toneBlue
class node_backend,node_auth_routes,node_project_routes,node_street_routes,node_auth_controller,node_project_controller,node_street_controller,node_token toneAmber
class node_map_ui,node_street_form,node_map_raster,node_noise_levels,node_local_noise,node_propagation,node_map_export,node_noise_calculator toneMint
class node_project_repository,node_street_repository,node_user_repository,node_project_model,node_street_model,node_user_model,node_database toneRose
class node_google,node_osm toneIndigo
```

## Components

### Web application

- [App routing](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Login](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/Login.jsx): `Frontend/src/components/Login.jsx`
- [Project screens](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/Proyecto.jsx): `Frontend/src/components/Proyecto.jsx`
- [Project creation](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/ProyectoNuevo.jsx): `Frontend/src/components/proyecto/ProyectoNuevo.jsx`
- [API client](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/config/clienteAxios.js): `Frontend/src/components/config/clienteAxios.js`

### Backend API

- [HTTP application](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/app.js): `Backend/src/app.js`
- [Auth routes](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/routes/auth.routes.js): `Backend/src/routes/auth.routes.js`
- [Project routes](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/routes/project.routes.js): `Backend/src/routes/project.routes.js`
- [Street routes](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/routes/street.routes.js): `Backend/src/routes/street.routes.js`
- [Authentication](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/controllers/auth.controller.js): `Backend/src/controllers/auth.controller.js`
- [Project operations](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/controllers/project.controller.js): `Backend/src/controllers/project.controller.js`
- [Street operations](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/controllers/street.controller.js): `Backend/src/controllers/street.controller.js`
- [Token verification](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/middlewares/verifyToken.js): `Backend/src/middlewares/verifyToken.js`

### Noise mapping

- [Project map](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/MapaProyecto.jsx): `Frontend/src/components/proyecto/MapaProyecto.jsx`
- [Street editor](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/CalleModal.jsx): `Frontend/src/components/proyecto/CalleModal.jsx`
- [Noise raster](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/CapaRuidoRaster.js): `Frontend/src/components/proyecto/CapaRuidoRaster.js`
- [Noise levels](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/nivelesRuido.js): `Frontend/src/components/proyecto/nivelesRuido.js`
- [Local noise](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/ruidoLocal.js): `Frontend/src/components/proyecto/ruidoLocal.js`
- [Noise propagation](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/ruidoPropagacion.js): `Frontend/src/components/proyecto/ruidoPropagacion.js`
- [Map export](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Frontend/src/components/proyecto/exportarMapaRuido.js): `Frontend/src/components/proyecto/exportarMapaRuido.js`
- [RLS-90 calculator](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/services/ruido.calculator.js): `Backend/src/services/ruido.calculator.js`

### Persistence

- [Project repository](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/repository/project.repository.js): `Backend/src/persintence/repository/project.repository.js`
- [Street repository](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/repository/street.repository.js): `Backend/src/persintence/repository/street.repository.js`
- [User repository](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/repository/user.repository.js): `Backend/src/persintence/repository/user.repository.js`
- [Project model](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/models/Project.js): `Backend/src/persintence/models/Project.js`
- [Street model](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/models/Street.js): `Backend/src/persintence/models/Street.js`
- [User model](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/models/User.js): `Backend/src/persintence/models/User.js`
- [MariaDB connection](https://github.com/panghys/generador-mapas-de-ruido-web/blob/main/Backend/src/persintence/database/database.js): `Backend/src/persintence/database/database.js`

### Other components

- **User**
- **Google identity**
- **OpenStreetMap**

## Connections

- User → App routing: uses
- App routing → Login: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Project screens: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Project creation: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Project map: routes to (evidence: `Frontend/src/App.jsx`)
- Project screens → API client: requests via (evidence: `Frontend/src/components/Proyecto.jsx`)
- Project map → API client: requests via (evidence: `Frontend/src/components/proyecto/MapaProyecto.jsx`)
- Project map → Street editor: opens (evidence: `Frontend/src/components/proyecto/MapaProyecto.jsx`)
- Project map → Local noise: calculates with (evidence: `Frontend/src/components/proyecto/MapaProyecto.jsx`)
- Project map → Noise levels: colors with (evidence: `Frontend/src/components/proyecto/MapaProyecto.jsx`)
- Project map → Map export: exports through (evidence: `Frontend/src/components/proyecto/MapaProyecto.jsx`)
- Map export → Noise levels: uses (evidence: `Frontend/src/components/proyecto/exportarMapaRuido.js`)
- Map export → Noise propagation: uses (evidence: `Frontend/src/components/proyecto/exportarMapaRuido.js`)
- API client → HTTP application: sends API requests
- HTTP application → Auth routes: mounts (evidence: `Backend/src/app.js`)
- HTTP application → Project routes: mounts (evidence: `Backend/src/app.js`)
- Project routes → Token verification: requires (evidence: `Backend/src/routes/project.routes.js`)
- Project routes → Project operations: dispatches (evidence: `Backend/src/routes/project.routes.js`)
- Project routes → Street routes: mounts (evidence: `Backend/src/routes/project.routes.js`)
- Street routes → Token verification: requires (evidence: `Backend/src/routes/street.routes.js`)
- Street routes → Street operations: dispatches (evidence: `Backend/src/routes/street.routes.js`)
- Auth routes → Authentication: dispatches (evidence: `Backend/src/routes/auth.routes.js`)
- Authentication → User repository: reads and writes (evidence: `Backend/src/controllers/auth.controller.js`)
- Authentication → Google identity: verifies identity (evidence: `Backend/src/controllers/auth.controller.js`)
- Project operations → Project repository: reads and writes (evidence: `Backend/src/controllers/project.controller.js`)
- Street operations → Project repository: checks ownership (evidence: `Backend/src/controllers/street.controller.js`)
- Street operations → Street repository: reads and writes (evidence: `Backend/src/controllers/street.controller.js`)
- Street operations → RLS-90 calculator: calculates noise (evidence: `Backend/src/controllers/street.controller.js`)
- Project repository → Project model: queries (evidence: `Backend/src/persintence/repository/project.repository.js`)
- Street repository → Street model: queries (evidence: `Backend/src/persintence/repository/street.repository.js`)
- User repository → User model: queries (evidence: `Backend/src/persintence/repository/user.repository.js`)
- Project model → MariaDB connection: uses connection (evidence: `Backend/src/persintence/models/Project.js`)
- Street model → MariaDB connection: uses connection (evidence: `Backend/src/persintence/models/Street.js`)
- User model → MariaDB connection: uses connection (evidence: `Backend/src/persintence/models/User.js`)
- Project map → OpenStreetMap: uses map data
- Project map → Noise raster: renders noise layer (evidence: `Frontend/src/components/proyecto/MapaProyecto.jsx`)
