# edwinsiguas/prueba2 architecture

> Architecture diagram of the GitHub repository edwinsiguas/prueba2, 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/edwinsiguas/prueba2
- Repository: https://github.com/edwinsiguas/prueba2

## Overview

TRANSIGOVAI is a municipal transport-permit management and roadside-inspection platform. Staff authenticate into a role-restricted web app to manage companies, drivers, vehicles, assignments, and permits; permits can be renewed or revoked, and inspectors can verify circulation status using QR codes. The backend separates REST controllers, business services, and DAO persistence, with audit, reporting, export, and monitoring capabilities. The principal API-to-service links below are shown where excerpts or the source index support them; broader frontend/API and MySQL relationships follow the README. Many subsystem implementations were not sampled.

Main entry points: [`backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java`](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java) (Assignment API), [`frontend/src/App.tsx`](https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/App.tsx) (Role-based routes), [`backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java`](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java) (Permit lifecycle), [`frontend/src/lib/api-client.ts`](https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/lib/api-client.ts) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Role-based routes<br/>[App.tsx]"]
  node_authhook["Session state<br/>[useAuth.ts]"]
  node_pages["Operations pages"]
  node_verificationui["Public verification<br/>[Verificar.tsx]"]
  node_apiclient["HTTP client<br/>[api-client.ts]"]
  node_reportsclient["Report client"]
end

subgraph group_api["REST API"]
  node_authapi["Authentication API"]
  node_fleetapi["Fleet APIs"]
  node_peopleapi["Company / driver API"]
  node_assignmentapi["Assignment API"]
  node_permitapi["Permit API"]
  node_verificationapi["Verification API"]
end

subgraph group_domain["Transport operations"]
  node_permitservice["Permit lifecycle"]
  node_vehicleservice["Vehicle mutations"]
  node_assignmentservice["Driver assignment"]
  node_circulation["Circulation checks"]
  node_qr["QR generation"]
end

subgraph group_platform["Platform services"]
  node_authservice["Authentication service"]
  node_audit["Action audit"]
  node_reporting["Reports and exports"]
  node_monitoring["Request monitoring"]
  node_response["API response envelope<br/>[ApiResponse.java]"]
end

subgraph group_data["Persistence"]
  node_permitsdao["Permit DAO<br/>[IPermisoDao.java]"]
  node_vehiclesdao["Vehicle mutation DAO"]
  node_mysql[("MySQL database")]
end

node_staff(("Municipal staff"))
node_browser(("Public / inspector"))

node_staff -->|"uses"| node_app
node_browser -.->|"opens"| node_verificationui
node_app -->|"checks session"| node_authhook
node_app -->|"routes to"| node_pages
node_app -->|"routes to"| node_verificationui
node_pages -.->|"requests data"| node_apiclient
node_verificationui -.->|"requests verification"| node_apiclient
node_apiclient -.->|"calls REST API"| node_authapi
node_apiclient -.->|"calls REST API"| node_fleetapi
node_reportsclient -.->|"requests reports"| node_reporting
node_fleetapi -->|"delegates mutations"| node_vehicleservice
node_peopleapi -->|"checks roles"| node_authservice
node_assignmentapi -->|"assigns drivers"| node_assignmentservice
node_assignmentapi -->|"validates circulation"| node_circulation
node_assignmentapi -->|"records actions"| node_audit
node_assignmentapi -->|"authorizes requests"| node_authservice
node_permitapi -->|"manages permits"| node_permitservice
node_permitapi -->|"verifies permits"| node_circulation
node_permitservice -->|"reads and writes"| node_permitsdao
node_permitservice -->|"generates QR"| node_qr
node_permitservice -->|"records issuance"| node_audit
node_vehicleservice -->|"reads and writes"| node_vehiclesdao
node_vehicleservice -->|"records changes"| node_audit
node_authapi -.->|"handles sessions"| node_authservice
node_verificationapi -.->|"checks validity"| node_circulation
node_reporting -.->|"queries records"| node_mysql
node_permitsdao -.->|"persists via JDBC"| node_mysql
node_vehiclesdao -.->|"persists via JDBC"| node_mysql
node_permitapi -->|"returns envelope"| node_response

click node_app "https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/App.tsx"
click node_authhook "https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/hooks/useAuth.ts"
click node_pages "https://github.com/edwinsiguas/prueba2/tree/main/frontend/src/pages"
click node_verificationui "https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/pages/Verificar.tsx"
click node_apiclient "https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/lib/api-client.ts"
click node_reportsclient "https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/lib/java-report-client.ts"
click node_authapi "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/AuthController.java"
click node_fleetapi "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/VehicleQueryController.java"
click node_peopleapi "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/CompanyDriverController.java"
click node_assignmentapi "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java"
click node_permitapi "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/PermitController.java"
click node_verificationapi "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/VerificationController.java"
click node_permitservice "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java"
click node_vehicleservice "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/VehiculoMutacionServiceImpl.java"
click node_assignmentservice "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/AsignacionServiceImpl.java"
click node_circulation "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/CirculacionServiceImpl.java"
click node_qr "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/CodigoQrServiceImpl.java"
click node_authservice "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/AutenticacionServiceImpl.java"
click node_audit "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/AuditoriaServiceImpl.java"
click node_reporting "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/ReporteServiceImpl.java"
click node_monitoring "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/MonitoringServiceImpl.java"
click node_response "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/dto/ApiResponse.java"
click node_permitsdao "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/dao/IPermisoDao.java"
click node_vehiclesdao "https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/dao/IVehiculoMutacionDao.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_app,node_authhook,node_pages,node_verificationui,node_apiclient,node_reportsclient toneBlue
class node_authapi,node_fleetapi,node_peopleapi,node_assignmentapi,node_permitapi,node_verificationapi toneAmber
class node_permitservice,node_vehicleservice,node_assignmentservice,node_circulation,node_qr toneMint
class node_authservice,node_audit,node_reporting,node_monitoring,node_response toneRose
class node_permitsdao,node_vehiclesdao,node_mysql,node_staff,node_browser toneIndigo
```

## Components

### Web application

- [Role-based routes](https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Session state](https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/hooks/useAuth.ts): `frontend/src/hooks/useAuth.ts`
- [Operations pages](https://github.com/edwinsiguas/prueba2/tree/main/frontend/src/pages): `frontend/src/pages`
- [Public verification](https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/pages/Verificar.tsx): `frontend/src/pages/Verificar.tsx`
- [HTTP client](https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/lib/api-client.ts): `frontend/src/lib/api-client.ts`
- [Report client](https://github.com/edwinsiguas/prueba2/blob/main/frontend/src/lib/java-report-client.ts): `frontend/src/lib/java-report-client.ts`

### REST API

- [Authentication API](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/AuthController.java): `backend/src/main/java/pe/marcona/mtc/controller/AuthController.java`
- [Fleet APIs](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/VehicleQueryController.java): `backend/src/main/java/pe/marcona/mtc/controller/VehicleQueryController.java`
- [Company / driver API](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/CompanyDriverController.java): `backend/src/main/java/pe/marcona/mtc/controller/CompanyDriverController.java`
- [Assignment API](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java): `backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java`
- [Permit API](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/PermitController.java): `backend/src/main/java/pe/marcona/mtc/controller/PermitController.java`
- [Verification API](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/controller/VerificationController.java): `backend/src/main/java/pe/marcona/mtc/controller/VerificationController.java`

### Transport operations

- [Permit lifecycle](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java`
- [Vehicle mutations](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/VehiculoMutacionServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/VehiculoMutacionServiceImpl.java`
- [Driver assignment](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/AsignacionServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/AsignacionServiceImpl.java`
- [Circulation checks](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/CirculacionServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/CirculacionServiceImpl.java`
- [QR generation](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/CodigoQrServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/CodigoQrServiceImpl.java`

### Platform services

- [Authentication service](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/AutenticacionServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/AutenticacionServiceImpl.java`
- [Action audit](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/AuditoriaServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/AuditoriaServiceImpl.java`
- [Reports and exports](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/ReporteServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/ReporteServiceImpl.java`
- [Request monitoring](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/service/impl/MonitoringServiceImpl.java): `backend/src/main/java/pe/marcona/mtc/service/impl/MonitoringServiceImpl.java`
- [API response envelope](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/dto/ApiResponse.java): `backend/src/main/java/pe/marcona/mtc/dto/ApiResponse.java`

### Persistence

- [Permit DAO](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/dao/IPermisoDao.java): `backend/src/main/java/pe/marcona/mtc/dao/IPermisoDao.java`
- [Vehicle mutation DAO](https://github.com/edwinsiguas/prueba2/blob/main/backend/src/main/java/pe/marcona/mtc/dao/IVehiculoMutacionDao.java): `backend/src/main/java/pe/marcona/mtc/dao/IVehiculoMutacionDao.java`
- **MySQL database**

### Other components

- **Municipal staff**
- **Public / inspector**

## Connections

- Municipal staff → Role-based routes: uses (evidence: `README.md`)
- Public / inspector → Public verification: opens
- Role-based routes → Session state: checks session (evidence: `frontend/src/App.tsx`)
- Role-based routes → Operations pages: routes to (evidence: `frontend/src/App.tsx`)
- Role-based routes → Public verification: routes to (evidence: `frontend/src/App.tsx`)
- Operations pages → HTTP client: requests data
- Public verification → HTTP client: requests verification
- HTTP client → Authentication API: calls REST API (evidence: `README.md`)
- HTTP client → Fleet APIs: calls REST API (evidence: `README.md`)
- Report client → Reports and exports: requests reports (evidence: `README.md`)
- Fleet APIs → Vehicle mutations: delegates mutations (evidence: `backend/src/main/java/pe/marcona/mtc/controller/VehicleQueryController.java`)
- Company / driver API → Authentication service: checks roles (evidence: `backend/src/main/java/pe/marcona/mtc/controller/CompanyDriverController.java`)
- Assignment API → Driver assignment: assigns drivers (evidence: `backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java`)
- Assignment API → Circulation checks: validates circulation (evidence: `backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java`)
- Assignment API → Action audit: records actions (evidence: `backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java`)
- Assignment API → Authentication service: authorizes requests (evidence: `backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java`)
- Permit API → Permit lifecycle: manages permits (evidence: `backend/src/main/java/pe/marcona/mtc/controller/PermitController.java`)
- Permit API → Circulation checks: verifies permits (evidence: `backend/src/main/java/pe/marcona/mtc/controller/PermitController.java`)
- Permit lifecycle → Permit DAO: reads and writes (evidence: `backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java`)
- Permit lifecycle → QR generation: generates QR (evidence: `backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java`)
- Permit lifecycle → Action audit: records issuance (evidence: `backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java`)
- Vehicle mutations → Vehicle mutation DAO: reads and writes (evidence: `backend/src/main/java/pe/marcona/mtc/service/impl/VehiculoMutacionServiceImpl.java`)
- Vehicle mutations → Action audit: records changes (evidence: `backend/src/main/java/pe/marcona/mtc/service/impl/VehiculoMutacionServiceImpl.java`)
- Authentication API → Authentication service: handles sessions
- Verification API → Circulation checks: checks validity
- Reports and exports → MySQL database: queries records (evidence: `README.md`)
- Permit DAO → MySQL database: persists via JDBC (evidence: `README.md`)
- Vehicle mutation DAO → MySQL database: persists via JDBC (evidence: `README.md`)
- Permit API → API response envelope: returns envelope (evidence: `backend/src/main/java/pe/marcona/mtc/controller/PermitController.java`)
