# om3027/recidron_backend_proyecto architecture

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

- Interactive diagram: https://gitdiagram.com/om3027/recidron_backend_proyecto
- Repository: https://github.com/om3027/recidron_backend_proyecto

## Overview

Recidron is a FastAPI backend for campus waste reporting and security administration. Users submit and manage waste reports, locations and catalog data; administrators manage accounts, roles, sessions and audit activity. The documented API also provides report statistics and PDF exports, while source excerpts show report-photo uploads. The graph follows the visible request-to-service flow and the documented service/repository layering. Some route and repository implementations were not sampled, so uncertain links are omitted; the README’s SQLite description differs from the sampled MySQL configuration.

Main entry points: [`repositorios`](https://github.com/om3027/recidron_backend_proyecto/tree/main/repositorios) (Entity repositories), [`routes/usuarios.py`](https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/usuarios.py) (User routes), [`servicios/servicio_autenticacion.py`](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_autenticacion.py) (Authentication service), [`routes/reportes.py`](https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/reportes.py) (Report routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_app["FastAPI application<br/>[main.py]"]
end

subgraph group_waste["Waste reporting"]
  node_report_routes["Report routes<br/>[reportes.py]"]
  node_catalog_routes["Catalog and geo routes"]
  node_stats_routes["Statistics routes<br/>[stats.py]"]
  node_report_service["Report service"]
  node_catalog_service["Catalog service"]
  node_geo_service["Geolocation service"]
  node_stats_service["Statistics service"]
  node_pdf["PDF export<br/>[pdf_export.py]"]
end

subgraph group_security["Security management"]
  node_user_routes["User routes<br/>[usuarios.py]"]
  node_auth_routes["Auth dependencies<br/>[auth.py]"]
  node_user_service["User service"]
  node_auth_service["Authentication service"]
  node_session_service["Session service"]
  node_email["Email delivery<br/>[email.py]"]
  node_password["Password hashing<br/>[security.py]"]
end

subgraph group_data["Persistence and integrations"]
  node_report_repo["Report repository"]
  node_data_repos["Entity repositories"]
  node_models["Domain models<br/>[project.py]"]
  node_database["Database sessions<br/>[database.py]"]
  node_cloudinary["Cloudinary storage"]
end

node_client(("API client"))
node_mysql[("MySQL database")]

node_client -->|"calls API"| node_app
node_app -->|"registers routes"| node_report_routes
node_app -->|"registers routes"| node_user_routes
node_report_routes -->|"calls"| node_report_service
node_report_routes -->|"generates PDF"| node_pdf
node_report_routes -->|"requires permission"| node_auth_routes
node_user_routes -->|"calls"| node_user_service
node_user_routes -->|"starts login"| node_session_service
node_user_routes -->|"handles recovery"| node_auth_service
node_user_routes -->|"uses dependencies"| node_auth_routes
node_auth_routes -->|"validates token"| node_auth_service
node_auth_routes -->|"checks permission"| node_data_repos
node_catalog_routes -->|"delegates catalog work"| node_catalog_service
node_catalog_routes -.->|"delegates location work"| node_geo_service
node_stats_routes -.->|"delegates statistics"| node_stats_service
node_stats_routes -->|"exports PDF"| node_pdf
node_report_service -->|"uses repository layer"| node_report_repo
node_catalog_service -->|"uses repositories"| node_data_repos
node_geo_service -->|"uses repositories"| node_data_repos
node_stats_service -->|"uses repositories"| node_data_repos
node_user_service -->|"uses repositories"| node_data_repos
node_auth_service -->|"uses repositories"| node_data_repos
node_session_service -->|"uses repositories"| node_data_repos
node_report_service -->|"uploads photos"| node_cloudinary
node_auth_service -->|"sends recovery email"| node_email
node_auth_service -->|"hashes credentials"| node_password
node_user_service -->|"hashes passwords"| node_password
node_database -->|"connects to"| node_mysql
node_models -->|"uses ORM base"| node_database

click node_app "https://github.com/om3027/recidron_backend_proyecto/blob/main/main.py"
click node_report_routes "https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/reportes.py"
click node_user_routes "https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/usuarios.py"
click node_auth_routes "https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/auth.py"
click node_catalog_routes "https://github.com/om3027/recidron_backend_proyecto/tree/main/routes"
click node_stats_routes "https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/stats.py"
click node_report_service "https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_reportes.py"
click node_catalog_service "https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_catalogos.py"
click node_geo_service "https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_geolocalizaciones.py"
click node_stats_service "https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_estadisticas.py"
click node_user_service "https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_usuarios.py"
click node_auth_service "https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_autenticacion.py"
click node_session_service "https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_sesiones.py"
click node_report_repo "https://github.com/om3027/recidron_backend_proyecto/blob/main/repositorios/repositorio_reportes.py"
click node_data_repos "https://github.com/om3027/recidron_backend_proyecto/tree/main/repositorios"
click node_models "https://github.com/om3027/recidron_backend_proyecto/blob/main/models/project.py"
click node_database "https://github.com/om3027/recidron_backend_proyecto/blob/main/models/database.py"
click node_pdf "https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/pdf_export.py"
click node_cloudinary "https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/cloudinary_upload.py"
click node_email "https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/email.py"
click node_password "https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/security.py"

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_client toneBlue
class node_report_routes,node_catalog_routes,node_stats_routes,node_report_service,node_catalog_service,node_geo_service,node_stats_service,node_pdf,node_mysql toneAmber
class node_user_routes,node_auth_routes,node_user_service,node_auth_service,node_session_service,node_email,node_password toneMint
class node_report_repo,node_data_repos,node_models,node_database,node_cloudinary toneRose
```

## Components

### API and access

- [FastAPI application](https://github.com/om3027/recidron_backend_proyecto/blob/main/main.py): `main.py`

### Waste reporting

- [Report routes](https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/reportes.py): `routes/reportes.py`
- [Catalog and geo routes](https://github.com/om3027/recidron_backend_proyecto/tree/main/routes): `routes`
- [Statistics routes](https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/stats.py): `routes/stats.py`
- [Report service](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_reportes.py): `servicios/servicio_reportes.py`
- [Catalog service](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_catalogos.py): `servicios/servicio_catalogos.py`
- [Geolocation service](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_geolocalizaciones.py): `servicios/servicio_geolocalizaciones.py`
- [Statistics service](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_estadisticas.py): `servicios/servicio_estadisticas.py`
- [PDF export](https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/pdf_export.py): `utils/pdf_export.py`

### Security management

- [User routes](https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/usuarios.py): `routes/usuarios.py`
- [Auth dependencies](https://github.com/om3027/recidron_backend_proyecto/blob/main/routes/auth.py): `routes/auth.py`
- [User service](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_usuarios.py): `servicios/servicio_usuarios.py`
- [Authentication service](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_autenticacion.py): `servicios/servicio_autenticacion.py`
- [Session service](https://github.com/om3027/recidron_backend_proyecto/blob/main/servicios/servicio_sesiones.py): `servicios/servicio_sesiones.py`
- [Email delivery](https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/email.py): `utils/email.py`
- [Password hashing](https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/security.py): `utils/security.py`

### Persistence and integrations

- [Report repository](https://github.com/om3027/recidron_backend_proyecto/blob/main/repositorios/repositorio_reportes.py): `repositorios/repositorio_reportes.py`
- [Entity repositories](https://github.com/om3027/recidron_backend_proyecto/tree/main/repositorios): `repositorios`
- [Domain models](https://github.com/om3027/recidron_backend_proyecto/blob/main/models/project.py): `models/project.py`
- [Database sessions](https://github.com/om3027/recidron_backend_proyecto/blob/main/models/database.py): `models/database.py`
- [Cloudinary storage](https://github.com/om3027/recidron_backend_proyecto/blob/main/utils/cloudinary_upload.py): `utils/cloudinary_upload.py`

### Other components

- **API client**
- **MySQL database**

## Connections

- API client → FastAPI application: calls API
- FastAPI application → Report routes: registers routes (evidence: `main.py`)
- FastAPI application → User routes: registers routes (evidence: `main.py`)
- Report routes → Report service: calls (evidence: `routes/reportes.py`)
- Report routes → PDF export: generates PDF (evidence: `routes/reportes.py`)
- Report routes → Auth dependencies: requires permission (evidence: `routes/reportes.py`)
- User routes → User service: calls (evidence: `routes/usuarios.py`)
- User routes → Session service: starts login (evidence: `routes/usuarios.py`)
- User routes → Authentication service: handles recovery (evidence: `routes/usuarios.py`)
- User routes → Auth dependencies: uses dependencies (evidence: `routes/usuarios.py`)
- Auth dependencies → Authentication service: validates token (evidence: `routes/auth.py`)
- Auth dependencies → Entity repositories: checks permission (evidence: `routes/auth.py`)
- Catalog and geo routes → Catalog service: delegates catalog work (evidence: `routes/materiales.py`)
- Catalog and geo routes → Geolocation service: delegates location work
- Statistics routes → Statistics service: delegates statistics
- Statistics routes → PDF export: exports PDF (evidence: `routes/stats.py`)
- Report service → Report repository: uses repository layer (evidence: `servicios/servicio_reportes.py`)
- Catalog service → Entity repositories: uses repositories (evidence: `servicios/servicio_catalogos.py`)
- Geolocation service → Entity repositories: uses repositories (evidence: `servicios/servicio_geolocalizaciones.py`)
- Statistics service → Entity repositories: uses repositories (evidence: `servicios/servicio_estadisticas.py`)
- User service → Entity repositories: uses repositories (evidence: `servicios/servicio_usuarios.py`)
- Authentication service → Entity repositories: uses repositories (evidence: `servicios/servicio_autenticacion.py`)
- Session service → Entity repositories: uses repositories (evidence: `servicios/servicio_sesiones.py`)
- Report service → Cloudinary storage: uploads photos (evidence: `servicios/servicio_reportes.py`)
- Authentication service → Email delivery: sends recovery email (evidence: `servicios/servicio_autenticacion.py`)
- Authentication service → Password hashing: hashes credentials (evidence: `servicios/servicio_autenticacion.py`)
- User service → Password hashing: hashes passwords (evidence: `servicios/servicio_usuarios.py`)
- Database sessions → MySQL database: connects to (evidence: `models/database.py`)
- Domain models → Database sessions: uses ORM base (evidence: `models/project.py`)
