# nexo-vital/nexovital architecture

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

- Interactive diagram: https://gitdiagram.com/nexo-vital/nexovital
- Repository: https://github.com/nexo-vital/nexovital

## Overview

Nexo Vital is an emergency-operations platform: a React client fronts a Spring Boot modular monolith for reporting emergencies, coordinating ambulance requests and fleet status, and managing aid-center inventory. The client routes users to role-specific screens and calls the backend; the backend exposes domain APIs and real-time updates. The README documents authentication, audit, scaling and optional distributed storage, but sampled source does not establish all their runtime wiring, so those links are omitted or marked unverified.

Main entry points: [`Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/NexovitalApplication.java`](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/NexovitalApplication.java) (Spring API), [`Front_NexoVital/src/app/AppRouter.tsx`](https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/app/AppRouter.tsx) (Role-based SPA), [`Front_NexoVital/src/services/apiClient.ts`](https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/services/apiClient.ts) (API client), [`Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/usuarios/infrastructure/adapter/in/RegistroController.java`](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/usuarios/infrastructure/adapter/in/RegistroController.java) (Registration and sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["Role-based SPA<br/>[AppRouter.tsx]"]
  node_api["API client<br/>[apiClient.ts]"]
  node_emergencyui["Emergency reporting"]
  node_fleetui["Fleet console"]
end

subgraph group_identity["Identity and audit"]
  node_identityapi["Registration and sessions"]
  node_audit[("Audit and request log")]
end

subgraph group_operations["Emergency operations"]
  node_emergencyapi["Emergency reports"]
  node_mapapi["Operations map"]
  node_requests["Ambulance requests"]
  node_fleet["Fleet status"]
end

subgraph group_resources["Aid resources"]
  node_inventory["Inventory and donations"]
  node_centers["Aid-center management"]
end

subgraph group_platform["Realtime and platform"]
  node_backend["Spring API"]
  node_push["Push fan-out"]
end

node_citizen(("Citizen"))
node_driver(("Ambulance driver"))
node_rabbit["RabbitMQ"]
node_database[("Application database")]
node_prometheus["Prometheus and Grafana"]
node_citus[("Optional Citus cluster")]

node_citizen -->|"uses"| node_webapp
node_driver -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_emergencyui
node_webapp -->|"routes to"| node_fleetui
node_webapp -.->|"uses"| node_api
node_api -.->|"calls API"| node_backend
node_backend -.->|"serves"| node_identityapi
node_backend -.->|"serves"| node_emergencyapi
node_backend -.->|"serves"| node_mapapi
node_backend -.->|"serves"| node_requests
node_backend -.->|"serves"| node_fleet
node_backend -.->|"serves"| node_inventory
node_backend -.->|"serves"| node_centers
node_identityapi -->|"records requests"| node_audit
node_backend -.->|"dispatches updates"| node_push
node_push -->|"propagates events"| node_rabbit
node_backend -->|"persists data"| node_database
node_backend -->|"exposes metrics"| node_prometheus
node_backend -.->|"can use"| node_citus

click node_webapp "https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/app/AppRouter.tsx"
click node_api "https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/services/apiClient.ts"
click node_emergencyui "https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/features/emergencias/CitizenReportDialog.tsx"
click node_fleetui "https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/pages/DriverConsolePage.tsx"
click node_backend "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/NexovitalApplication.java"
click node_identityapi "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/usuarios/infrastructure/adapter/in/RegistroController.java"
click node_audit "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/auditoria/infrastructure/adapter/in/AuditoriaController.java"
click node_emergencyapi "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/mapa/infrastructure/adapter/in/EmergenciaController.java"
click node_mapapi "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/mapa/infrastructure/adapter/in/MapaController.java"
click node_requests "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/flota/infrastructure/adapter/in/SolicitudController.java"
click node_fleet "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/flota/infrastructure/adapter/in/FlotaController.java"
click node_inventory "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/recursos/infrastructure/adapter/in/InventarioController.java"
click node_centers "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/recursos/infrastructure/adapter/in/MiCentroController.java"
click node_push "https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/gateway/infrastructure/adapter/out/PushFanOutAdapter.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_webapp,node_api,node_emergencyui,node_fleetui toneBlue
class node_identityapi,node_audit,node_database,node_citus toneAmber
class node_emergencyapi,node_mapapi,node_requests,node_fleet toneMint
class node_inventory,node_centers toneRose
class node_backend,node_push,node_citizen,node_driver,node_rabbit,node_prometheus toneIndigo
```

## Components

### Web client

- [Role-based SPA](https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/app/AppRouter.tsx): `Front_NexoVital/src/app/AppRouter.tsx`
- [API client](https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/services/apiClient.ts): `Front_NexoVital/src/services/apiClient.ts`
- [Emergency reporting](https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/features/emergencias/CitizenReportDialog.tsx): `Front_NexoVital/src/features/emergencias/CitizenReportDialog.tsx`
- [Fleet console](https://github.com/nexo-vital/nexovital/blob/main/Front_NexoVital/src/pages/DriverConsolePage.tsx): `Front_NexoVital/src/pages/DriverConsolePage.tsx`

### Identity and audit

- [Registration and sessions](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/usuarios/infrastructure/adapter/in/RegistroController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/usuarios/infrastructure/adapter/in/RegistroController.java`
- [Audit and request log](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/auditoria/infrastructure/adapter/in/AuditoriaController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/auditoria/infrastructure/adapter/in/AuditoriaController.java`

### Emergency operations

- [Emergency reports](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/mapa/infrastructure/adapter/in/EmergenciaController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/mapa/infrastructure/adapter/in/EmergenciaController.java`
- [Operations map](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/mapa/infrastructure/adapter/in/MapaController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/mapa/infrastructure/adapter/in/MapaController.java`
- [Ambulance requests](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/flota/infrastructure/adapter/in/SolicitudController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/flota/infrastructure/adapter/in/SolicitudController.java`
- [Fleet status](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/flota/infrastructure/adapter/in/FlotaController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/flota/infrastructure/adapter/in/FlotaController.java`

### Aid resources

- [Inventory and donations](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/recursos/infrastructure/adapter/in/InventarioController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/recursos/infrastructure/adapter/in/InventarioController.java`
- [Aid-center management](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/recursos/infrastructure/adapter/in/MiCentroController.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/recursos/infrastructure/adapter/in/MiCentroController.java`

### Realtime and platform

- [Spring API](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/NexovitalApplication.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/NexovitalApplication.java`
- [Push fan-out](https://github.com/nexo-vital/nexovital/blob/main/Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/gateway/infrastructure/adapter/out/PushFanOutAdapter.java): `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/gateway/infrastructure/adapter/out/PushFanOutAdapter.java`

### Other components

- **Citizen**
- **Ambulance driver**
- **RabbitMQ**
- **Application database**
- **Prometheus and Grafana**
- **Optional Citus cluster**

## Connections

- Citizen → Role-based SPA: uses (evidence: `Front_NexoVital/src/app/AppRouter.tsx`)
- Ambulance driver → Role-based SPA: uses (evidence: `Front_NexoVital/src/app/AppRouter.tsx`)
- Role-based SPA → Emergency reporting: routes to (evidence: `Front_NexoVital/src/app/AppRouter.tsx`)
- Role-based SPA → Fleet console: routes to (evidence: `Front_NexoVital/src/app/AppRouter.tsx`)
- Role-based SPA → API client: uses
- API client → Spring API: calls API
- Spring API → Registration and sessions: serves
- Spring API → Emergency reports: serves
- Spring API → Operations map: serves
- Spring API → Ambulance requests: serves
- Spring API → Fleet status: serves
- Spring API → Inventory and donations: serves
- Spring API → Aid-center management: serves
- Registration and sessions → Audit and request log: records requests (evidence: `Back_NexoVital/src/main/java/co/edu/escuelaing/nexovital/usuarios/infrastructure/adapter/in/RegistroController.java`)
- Spring API → Push fan-out: dispatches updates
- Push fan-out → RabbitMQ: propagates events (evidence: `README.md`)
- Spring API → Application database: persists data (evidence: `README.md`)
- Spring API → Prometheus and Grafana: exposes metrics (evidence: `README.md`)
- Spring API → Optional Citus cluster: can use (evidence: `README.md`)
