# francofelg/mdw_trabajofinal architecture

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

- Interactive diagram: https://gitdiagram.com/francofelg/mdw_trabajofinal
- Repository: https://github.com/francofelg/mdw_trabajofinal

## Overview

La app coordina reportes públicos de emergencia, asignación y cierre por voluntarios, junto con gestión de usuarios, capacitación y ascensos. La interfaz Next.js ofrece flujos públicos y privados; las rutas API dirigen las operaciones a controladores y servicios, que aplican reglas de dominio y acceden a persistencia. Geocodificación y cálculo de rutas respaldan la ubicación y ETA. El README documenta las capacidades principales; las relaciones de implementación se limitan a las visibles en los extractos o referencias del SOURCE INDEX, por lo que algunas áreas no muestreadas quedan sin enlaces detallados.

Main entry points: [`src/app/(publico)`](https://github.com/francofelg/mdw_trabajofinal/tree/main/src/app/(publico)) (Páginas públicas y privadas), [`src/app/api/emergencias/route.ts`](https://github.com/francofelg/mdw_trabajofinal/blob/main/src/app/api/emergencias/route.ts) (API emergencias), [`services/emergencia.service.ts`](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/emergencia.service.ts) (Reglas de emergencias), [`config/database.ts`](https://github.com/francofelg/mdw_trabajofinal/blob/main/config/database.ts) (Base de datos)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acceso["Acceso y usuarios"]
  node_api_auth["API autenticación"]
  node_auth_service["Servicio de autenticación<br/>[auth.service.ts]"]
  node_usuarios_api["API usuarios<br/>[route.ts]"]
  node_usuarios_service["Servicio de usuarios<br/>[usuario.service.ts]"]
  node_usuarios_repo["Persistencia usuarios"]
end

subgraph group_emergencias["Emergencias"]
  node_api_emergencias["API emergencias<br/>[route.ts]"]
  node_ctrl_emergencia["Controlador emergencias"]
  node_svc_emergencia["Reglas de emergencias"]
  node_repo_emergencia["Datos de emergencias"]
  node_geocoding["Geocodificación"]
  node_rutas["ETA y rutas<br/>[rutas.service.ts]"]
end

subgraph group_formacion["Capacitación y ascensos"]
  node_cursos_api["API cursos<br/>[route.ts]"]
  node_cursos_ctrl["Controlador cursos"]
  node_cursos_repo["Persistencia cursos"]
  node_certificados["Certificados y revisión"]
  node_ascensos["Solicitudes de ascenso"]
end

subgraph group_interfaz["Experiencia web"]
  node_web["Páginas públicas y privadas"]
  node_reportar["Formulario de reporte<br/>[reporte-form.tsx]"]
  node_casosui["Vista de casos y mapas<br/>[casos-vista.tsx]"]
end

subgraph group_plataforma["Servicios compartidos"]
  node_maps["Google Maps"]
  node_notificaciones["Notificaciones"]
  node_db[("Base de datos<br/>[database.ts]")]
  node_auth_lib["Verificación JWT<br/>[auth.ts]"]
end

node_persona(("Ciudadano / voluntario"))

node_persona -->|"usa"| node_web
node_web -->|"abre reporte"| node_reportar
node_reportar -->|"envía reporte"| node_api_emergencias
node_api_emergencias -->|"invoca"| node_ctrl_emergencia
node_api_emergencias -->|"usa"| node_svc_emergencia
node_ctrl_emergencia -->|"delega"| node_svc_emergencia
node_svc_emergencia -->|"lee y escribe"| node_repo_emergencia
node_svc_emergencia -->|"geocodifica"| node_geocoding
node_svc_emergencia -->|"calcula ETA"| node_rutas
node_geocoding -->|"consulta"| node_maps
node_rutas -->|"consulta rutas"| node_maps
node_casosui -.->|"consulta casos"| node_api_emergencias
node_persona -->|"inicia sesión"| node_api_auth
node_api_auth -.->|"gestiona login"| node_auth_service
node_auth_service -->|"busca usuario"| node_usuarios_repo
node_web -.->|"gestiona cuentas"| node_usuarios_api
node_usuarios_api -->|"registra usuarios"| node_usuarios_service
node_usuarios_service -->|"accede a datos"| node_usuarios_repo
node_usuarios_repo -->|"consulta"| node_db
node_api_emergencias -->|"consulta actor"| node_db
node_web -.->|"gestiona cursos"| node_cursos_api
node_cursos_api -->|"invoca"| node_cursos_ctrl
node_cursos_ctrl -->|"delega acceso"| node_cursos_repo
node_cursos_repo -->|"consulta"| node_db
node_web -.->|"carga y revisa"| node_certificados
node_web -.->|"solicita ascenso"| node_ascensos
node_api_emergencias -->|"avisa emergencia"| node_notificaciones
node_api_auth -.->|"valida token"| node_auth_lib
node_auth_lib -->|"resuelve actor"| node_db

click node_web "https://github.com/francofelg/mdw_trabajofinal/tree/main/src/app/(publico)"
click node_reportar "https://github.com/francofelg/mdw_trabajofinal/blob/main/src/components/reporte-form.tsx"
click node_casosui "https://github.com/francofelg/mdw_trabajofinal/blob/main/src/components/casos-vista.tsx"
click node_api_emergencias "https://github.com/francofelg/mdw_trabajofinal/blob/main/src/app/api/emergencias/route.ts"
click node_ctrl_emergencia "https://github.com/francofelg/mdw_trabajofinal/blob/main/controllers/emergencia.controller.ts"
click node_svc_emergencia "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/emergencia.service.ts"
click node_repo_emergencia "https://github.com/francofelg/mdw_trabajofinal/blob/main/repositories/emergencia.repository.ts"
click node_geocoding "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/geocoding.service.ts"
click node_rutas "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/rutas.service.ts"
click node_maps "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/googleMaps.client.ts"
click node_api_auth "https://github.com/francofelg/mdw_trabajofinal/tree/main/src/app/api/auth"
click node_auth_service "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/auth.service.ts"
click node_usuarios_api "https://github.com/francofelg/mdw_trabajofinal/blob/main/src/app/api/usuarios/route.ts"
click node_usuarios_service "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/usuario.service.ts"
click node_usuarios_repo "https://github.com/francofelg/mdw_trabajofinal/blob/main/repositories/usuario.repository.ts"
click node_cursos_api "https://github.com/francofelg/mdw_trabajofinal/blob/main/src/app/api/cursos/route.ts"
click node_cursos_ctrl "https://github.com/francofelg/mdw_trabajofinal/blob/main/controllers/curso.controller.ts"
click node_cursos_repo "https://github.com/francofelg/mdw_trabajofinal/blob/main/repositories/curso.repository.ts"
click node_certificados "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/certificado.service.ts"
click node_ascensos "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/solicitudAscenso.service.ts"
click node_notificaciones "https://github.com/francofelg/mdw_trabajofinal/blob/main/services/notificacion.service.ts"
click node_db "https://github.com/francofelg/mdw_trabajofinal/blob/main/config/database.ts"
click node_auth_lib "https://github.com/francofelg/mdw_trabajofinal/blob/main/src/lib/auth.ts"

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_api_auth,node_auth_service,node_usuarios_api,node_usuarios_service,node_usuarios_repo toneBlue
class node_api_emergencias,node_ctrl_emergencia,node_svc_emergencia,node_repo_emergencia,node_geocoding,node_rutas toneAmber
class node_cursos_api,node_cursos_ctrl,node_cursos_repo,node_certificados,node_ascensos toneMint
class node_web,node_reportar,node_casosui toneRose
class node_maps,node_notificaciones,node_db,node_auth_lib,node_persona toneIndigo
```

## Components

### Acceso y usuarios

- [API autenticación](https://github.com/francofelg/mdw_trabajofinal/tree/main/src/app/api/auth): `src/app/api/auth`
- [Servicio de autenticación](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/auth.service.ts): `services/auth.service.ts`
- [API usuarios](https://github.com/francofelg/mdw_trabajofinal/blob/main/src/app/api/usuarios/route.ts): `src/app/api/usuarios/route.ts`
- [Servicio de usuarios](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/usuario.service.ts): `services/usuario.service.ts`
- [Persistencia usuarios](https://github.com/francofelg/mdw_trabajofinal/blob/main/repositories/usuario.repository.ts): `repositories/usuario.repository.ts`

### Emergencias

- [API emergencias](https://github.com/francofelg/mdw_trabajofinal/blob/main/src/app/api/emergencias/route.ts): `src/app/api/emergencias/route.ts`
- [Controlador emergencias](https://github.com/francofelg/mdw_trabajofinal/blob/main/controllers/emergencia.controller.ts): `controllers/emergencia.controller.ts`
- [Reglas de emergencias](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/emergencia.service.ts): `services/emergencia.service.ts`
- [Datos de emergencias](https://github.com/francofelg/mdw_trabajofinal/blob/main/repositories/emergencia.repository.ts): `repositories/emergencia.repository.ts`
- [Geocodificación](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/geocoding.service.ts): `services/geocoding.service.ts`
- [ETA y rutas](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/rutas.service.ts): `services/rutas.service.ts`

### Capacitación y ascensos

- [API cursos](https://github.com/francofelg/mdw_trabajofinal/blob/main/src/app/api/cursos/route.ts): `src/app/api/cursos/route.ts`
- [Controlador cursos](https://github.com/francofelg/mdw_trabajofinal/blob/main/controllers/curso.controller.ts): `controllers/curso.controller.ts`
- [Persistencia cursos](https://github.com/francofelg/mdw_trabajofinal/blob/main/repositories/curso.repository.ts): `repositories/curso.repository.ts`
- [Certificados y revisión](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/certificado.service.ts): `services/certificado.service.ts`
- [Solicitudes de ascenso](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/solicitudAscenso.service.ts): `services/solicitudAscenso.service.ts`

### Experiencia web

- [Páginas públicas y privadas](https://github.com/francofelg/mdw_trabajofinal/tree/main/src/app/(publico)): `src/app/(publico)`
- [Formulario de reporte](https://github.com/francofelg/mdw_trabajofinal/blob/main/src/components/reporte-form.tsx): `src/components/reporte-form.tsx`
- [Vista de casos y mapas](https://github.com/francofelg/mdw_trabajofinal/blob/main/src/components/casos-vista.tsx): `src/components/casos-vista.tsx`

### Servicios compartidos

- [Google Maps](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/googleMaps.client.ts): `services/googleMaps.client.ts`
- [Notificaciones](https://github.com/francofelg/mdw_trabajofinal/blob/main/services/notificacion.service.ts): `services/notificacion.service.ts`
- [Base de datos](https://github.com/francofelg/mdw_trabajofinal/blob/main/config/database.ts): `config/database.ts`
- [Verificación JWT](https://github.com/francofelg/mdw_trabajofinal/blob/main/src/lib/auth.ts): `src/lib/auth.ts`

### Other components

- **Ciudadano / voluntario**

## Connections

- Ciudadano / voluntario → Páginas públicas y privadas: usa (evidence: `README.md`)
- Páginas públicas y privadas → Formulario de reporte: abre reporte (evidence: `src/components/reporte-form.tsx`)
- Formulario de reporte → API emergencias: envía reporte (evidence: `src/components/reporte-form.tsx`)
- API emergencias → Controlador emergencias: invoca (evidence: `src/app/api/emergencias/route.ts`)
- API emergencias → Reglas de emergencias: usa (evidence: `src/app/api/emergencias/route.ts`)
- Controlador emergencias → Reglas de emergencias: delega (evidence: `controllers/emergencia.controller.ts`)
- Reglas de emergencias → Datos de emergencias: lee y escribe (evidence: `services/emergencia.service.ts`)
- Reglas de emergencias → Geocodificación: geocodifica (evidence: `services/emergencia.service.ts`)
- Reglas de emergencias → ETA y rutas: calcula ETA (evidence: `services/emergencia.service.ts`)
- Geocodificación → Google Maps: consulta (evidence: `services/geocoding.service.ts`)
- ETA y rutas → Google Maps: consulta rutas (evidence: `services/rutas.service.ts`)
- Vista de casos y mapas → API emergencias: consulta casos
- Ciudadano / voluntario → API autenticación: inicia sesión (evidence: `README.md`)
- API autenticación → Servicio de autenticación: gestiona login
- Servicio de autenticación → Persistencia usuarios: busca usuario (evidence: `services/auth.service.ts`)
- Páginas públicas y privadas → API usuarios: gestiona cuentas
- API usuarios → Servicio de usuarios: registra usuarios (evidence: `src/app/api/usuarios/route.ts`)
- Servicio de usuarios → Persistencia usuarios: accede a datos (evidence: `services/usuario.service.ts`)
- Persistencia usuarios → Base de datos: consulta (evidence: `repositories/usuario.repository.ts`)
- API emergencias → Base de datos: consulta actor (evidence: `src/app/api/emergencias/route.ts`)
- Páginas públicas y privadas → API cursos: gestiona cursos
- API cursos → Controlador cursos: invoca (evidence: `src/app/api/cursos/route.ts`)
- Controlador cursos → Persistencia cursos: delega acceso (evidence: `controllers/curso.controller.ts`)
- Persistencia cursos → Base de datos: consulta (evidence: `repositories/curso.repository.ts`)
- Páginas públicas y privadas → Certificados y revisión: carga y revisa
- Páginas públicas y privadas → Solicitudes de ascenso: solicita ascenso
- API emergencias → Notificaciones: avisa emergencia (evidence: `src/app/api/emergencias/route.ts`)
- API autenticación → Verificación JWT: valida token
- Verificación JWT → Base de datos: resuelve actor (evidence: `src/lib/actor-actual.ts`)
