# thomaslopezro/proyectoarqui architecture

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

- Interactive diagram: https://gitdiagram.com/thomaslopezro/proyectoarqui
- Repository: https://github.com/thomaslopezro/proyectoarqui

## Overview

La plataforma coordina la atención de desastres desde el registro y la evaluación de daños hasta las solicitudes de recursos, notificaciones y reconstrucción. Organismos usan la web operativa y la app de campo; esta última captura sin conexión y sincroniza por lotes. El núcleo es dueño del ciclo del desastre, mientras Campo y mapas gestiona evaluaciones y mapas, Notificaciones distribuye avisos y Reconstrucción gestiona proyectos y seguimiento. El README documenta las relaciones entre servicios; la integración de Reconstrucción se declara escrita, pero aún no compilada ni probada.

Main entry points: [`nucleo/src/main/java/com/pgdr/api/RestApplication.java`](https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/api/RestApplication.java) (API del núcleo), [`reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/entrada/rest/ReconstruccionController.java`](https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/entrada/rest/ReconstruccionController.java) (API reconstrucción), [`servidor/src/Mapas.Api/Program.cs`](https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/src/Mapas.Api/Program.cs) (API mapas), [`servidor/web/app.js`](https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/web/app.js) (Web operativa)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_canales["Canales operativos"]
  node_web["Web operativa<br/>[app.js]"]
  node_app_campo["App de campo<br/>[CapturaPage.cs]"]
  node_almacen[("Almacén local<br/>[AlmacenCampo.cs]")]
  node_sync_campo["Sincronización"]
end

subgraph group_campo["Campo y mapas"]
  node_api_mapas["API mapas<br/>[Program.cs]"]
  node_afectaciones["Afectaciones"]
  node_operaciones_campo[("Operaciones campo<br/>[CampoRepository.cs]")]
end

subgraph group_nucleo["Núcleo y solicitudes"]
  node_auth["Identidad y acceso<br/>[AuthService.java]"]
  node_api_nucleo["API del núcleo"]
  node_desastres_core["Ciclo de desastres"]
  node_solicitudes["Solicitudes recursos"]
  node_outbox[("Bandeja de avisos")]
end

subgraph group_avisos["Notificaciones"]
  node_notificaciones["Servicio avisos"]
end

subgraph group_reconstruccion["Reconstrucción"]
  node_recon_web["Portal reconstrucción<br/>[App.jsx]"]
  node_recon_api["API reconstrucción"]
  node_proyectos["Casos de uso"]
  node_repos_proyectos[("Proyectos y seguimiento")]
end

node_organismo(("Organismo usuario"))
node_cola["RabbitMQ"]

node_organismo -->|"opera"| node_web
node_organismo -->|"captura daños"| node_app_campo
node_app_campo -->|"guarda local"| node_almacen
node_app_campo -->|"solicita sincronización"| node_sync_campo
node_sync_campo -->|"sincroniza lotes"| node_api_mapas
node_api_mapas -->|"registra daños"| node_afectaciones
node_afectaciones -.->|"consulta y persiste"| node_operaciones_campo
node_web -.->|"consulta mapas"| node_api_mapas
node_web -.->|"gestiona operación"| node_api_nucleo
node_api_nucleo -.->|"valida identidad"| node_auth
node_api_nucleo -.->|"gestiona ciclo"| node_desastres_core
node_api_nucleo -.->|"tramita recursos"| node_solicitudes
node_desastres_core -->|"registra aviso"| node_outbox
node_outbox -->|"publica avisos"| node_notificaciones
node_notificaciones -.->|"envía por cola"| node_cola
node_notificaciones -.->|"notifica por correo"| node_organismo
node_organismo -->|"gestiona proyectos"| node_recon_web
node_recon_web -->|"solicita operaciones"| node_recon_api
node_recon_api -->|"invoca casos"| node_proyectos
node_proyectos -.->|"persiste proyectos"| node_repos_proyectos
node_recon_api -.->|"consulta núcleo"| node_api_nucleo
node_recon_api -.->|"consulta evaluaciones"| node_api_mapas

click node_web "https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/web/app.js"
click node_app_campo "https://github.com/thomaslopezro/proyectoarqui/blob/main/campo/src/Arqui.Campo/CapturaPage.cs"
click node_almacen "https://github.com/thomaslopezro/proyectoarqui/blob/main/campo/src/Arqui.Campo/AlmacenCampo.cs"
click node_sync_campo "https://github.com/thomaslopezro/proyectoarqui/blob/main/campo/src/Arqui.Campo/SincronizadorCampo.cs"
click node_api_mapas "https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/src/Mapas.Api/Program.cs"
click node_afectaciones "https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/src/Mapas.Api/Application/AfectacionesService.cs"
click node_operaciones_campo "https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/src/Mapas.Api/Infrastructure/CampoRepository.cs"
click node_auth "https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/application/AuthService.java"
click node_api_nucleo "https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/api/RestApplication.java"
click node_desastres_core "https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/application/DesastreService.java"
click node_solicitudes "https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/co/edu/javeriana/emergencias/aplicacion/servicio/SolicitudServicio.java"
click node_outbox "https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/application/DesastreService.java"
click node_notificaciones "https://github.com/thomaslopezro/proyectoarqui/blob/main/desastres/src/main/java/co/edu/javeriana/emergencias/aplicacion/servicio/DesastreServicio.java"
click node_recon_web "https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/web/src/App.jsx"
click node_recon_api "https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/entrada/rest/ReconstruccionController.java"
click node_proyectos "https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/aplicacion/casosdeuso/CrearProyectos.java"
click node_repos_proyectos "https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/salida/persistencia/RepositorioProyectosJdbc.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_web,node_app_campo,node_almacen,node_sync_campo toneBlue
class node_api_mapas,node_afectaciones,node_operaciones_campo toneAmber
class node_auth,node_api_nucleo,node_desastres_core,node_solicitudes,node_outbox toneMint
class node_notificaciones toneRose
class node_recon_web,node_recon_api,node_proyectos,node_repos_proyectos,node_organismo,node_cola toneIndigo
```

## Components

### Canales operativos

- [Web operativa](https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/web/app.js): `servidor/web/app.js`
- [App de campo](https://github.com/thomaslopezro/proyectoarqui/blob/main/campo/src/Arqui.Campo/CapturaPage.cs): `campo/src/Arqui.Campo/CapturaPage.cs`
- [Almacén local](https://github.com/thomaslopezro/proyectoarqui/blob/main/campo/src/Arqui.Campo/AlmacenCampo.cs): `campo/src/Arqui.Campo/AlmacenCampo.cs`
- [Sincronización](https://github.com/thomaslopezro/proyectoarqui/blob/main/campo/src/Arqui.Campo/SincronizadorCampo.cs): `campo/src/Arqui.Campo/SincronizadorCampo.cs`

### Campo y mapas

- [API mapas](https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/src/Mapas.Api/Program.cs): `servidor/src/Mapas.Api/Program.cs`
- [Afectaciones](https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/src/Mapas.Api/Application/AfectacionesService.cs): `servidor/src/Mapas.Api/Application/AfectacionesService.cs`
- [Operaciones campo](https://github.com/thomaslopezro/proyectoarqui/blob/main/servidor/src/Mapas.Api/Infrastructure/CampoRepository.cs): `servidor/src/Mapas.Api/Infrastructure/CampoRepository.cs`

### Núcleo y solicitudes

- [Identidad y acceso](https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/application/AuthService.java): `nucleo/src/main/java/com/pgdr/application/AuthService.java`
- [API del núcleo](https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/api/RestApplication.java): `nucleo/src/main/java/com/pgdr/api/RestApplication.java`
- [Ciclo de desastres](https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/application/DesastreService.java): `nucleo/src/main/java/com/pgdr/application/DesastreService.java`
- [Solicitudes recursos](https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/co/edu/javeriana/emergencias/aplicacion/servicio/SolicitudServicio.java): `nucleo/src/main/java/co/edu/javeriana/emergencias/aplicacion/servicio/SolicitudServicio.java`
- [Bandeja de avisos](https://github.com/thomaslopezro/proyectoarqui/blob/main/nucleo/src/main/java/com/pgdr/application/DesastreService.java): `nucleo/src/main/java/com/pgdr/application/DesastreService.java`

### Notificaciones

- [Servicio avisos](https://github.com/thomaslopezro/proyectoarqui/blob/main/desastres/src/main/java/co/edu/javeriana/emergencias/aplicacion/servicio/DesastreServicio.java): `desastres/src/main/java/co/edu/javeriana/emergencias/aplicacion/servicio/DesastreServicio.java`

### Reconstrucción

- [Portal reconstrucción](https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/web/src/App.jsx): `reconstruccion/web/src/App.jsx`
- [API reconstrucción](https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/entrada/rest/ReconstruccionController.java): `reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/entrada/rest/ReconstruccionController.java`
- [Casos de uso](https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/aplicacion/casosdeuso/CrearProyectos.java): `reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/aplicacion/casosdeuso/CrearProyectos.java`
- [Proyectos y seguimiento](https://github.com/thomaslopezro/proyectoarqui/blob/main/reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/salida/persistencia/RepositorioProyectosJdbc.java): `reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/salida/persistencia/RepositorioProyectosJdbc.java`

### Other components

- **Organismo usuario**
- **RabbitMQ**

## Connections

- Organismo usuario → Web operativa: opera (evidence: `README.md`)
- Organismo usuario → App de campo: captura daños (evidence: `README.md`)
- App de campo → Almacén local: guarda local (evidence: `campo/src/Arqui.Campo/CapturaPage.cs`)
- App de campo → Sincronización: solicita sincronización (evidence: `campo/src/Arqui.Campo/CapturaPage.cs`)
- Sincronización → API mapas: sincroniza lotes (evidence: `README.md`)
- API mapas → Afectaciones: registra daños (evidence: `servidor/src/Mapas.Api/Program.cs`)
- Afectaciones → Operaciones campo: consulta y persiste
- Web operativa → API mapas: consulta mapas
- Web operativa → API del núcleo: gestiona operación
- API del núcleo → Identidad y acceso: valida identidad
- API del núcleo → Ciclo de desastres: gestiona ciclo
- API del núcleo → Solicitudes recursos: tramita recursos
- Ciclo de desastres → Bandeja de avisos: registra aviso (evidence: `nucleo/src/main/java/com/pgdr/application/DesastreService.java`)
- Bandeja de avisos → Servicio avisos: publica avisos (evidence: `README.md`)
- Servicio avisos → RabbitMQ: envía por cola (evidence: `README.md`)
- Servicio avisos → Organismo usuario: notifica por correo (evidence: `README.md`)
- Organismo usuario → Portal reconstrucción: gestiona proyectos (evidence: `README.md`)
- Portal reconstrucción → API reconstrucción: solicita operaciones (evidence: `reconstruccion/web/src/App.jsx`)
- API reconstrucción → Casos de uso: invoca casos (evidence: `reconstruccion/backend/src/main/java/com/pgdr/reconstruccion/adaptadores/entrada/rest/ReconstruccionController.java`)
- Casos de uso → Proyectos y seguimiento: persiste proyectos
- API reconstrucción → API del núcleo: consulta núcleo (evidence: `README.md`)
- API reconstrucción → API mapas: consulta evaluaciones (evidence: `README.md`)
