How edwinsiguas/prueba2 works
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: AssignmentController.java Assignment API · App.tsx Role-based routes · PermisoServiceImpl.java Permit lifecycle · api-client.ts HTTP client
Components 27
Web application
- Role-based routes
frontend/src/App.tsx - Session state
frontend/src/hooks/useAuth.ts - Operations pages
frontend/src/pages - Public verification
frontend/src/pages/Verificar.tsx - HTTP client
frontend/src/lib/api-client.ts - Report client
frontend/src/lib/java-report-client.ts
REST API
- Authentication API
backend/src/main/java/pe/marcona/mtc/controller/AuthController.java - Fleet APIs
backend/src/main/java/pe/marcona/mtc/controller/VehicleQueryController.java - Company / driver API
backend/src/main/java/pe/marcona/mtc/controller/CompanyDriverController.java - Assignment API
backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java - Permit API
backend/src/main/java/pe/marcona/mtc/controller/PermitController.java - Verification API
backend/src/main/java/pe/marcona/mtc/controller/VerificationController.java
Transport operations
- Permit lifecycle
backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java - Vehicle mutations
backend/src/main/java/pe/marcona/mtc/service/impl/VehiculoMutacionServiceImpl.java - Driver assignment
backend/src/main/java/pe/marcona/mtc/service/impl/AsignacionServiceImpl.java - Circulation checks
backend/src/main/java/pe/marcona/mtc/service/impl/CirculacionServiceImpl.java - QR generation
backend/src/main/java/pe/marcona/mtc/service/impl/CodigoQrServiceImpl.java
Platform services
- Authentication service
backend/src/main/java/pe/marcona/mtc/service/impl/AutenticacionServiceImpl.java - Action audit
backend/src/main/java/pe/marcona/mtc/service/impl/AuditoriaServiceImpl.java - Reports and exports
backend/src/main/java/pe/marcona/mtc/service/impl/ReporteServiceImpl.java - Request monitoring
backend/src/main/java/pe/marcona/mtc/service/impl/MonitoringServiceImpl.java - API response envelope
backend/src/main/java/pe/marcona/mtc/dto/ApiResponse.java
Persistence
- Permit DAO
backend/src/main/java/pe/marcona/mtc/dao/IPermisoDao.java - Vehicle mutation DAO
backend/src/main/java/pe/marcona/mtc/dao/IVehiculoMutacionDao.java - MySQL database
Other components
- Municipal staff
- Public / inspector
Connections 29
- Municipal staff → Role-based routes: uses
README.md - Public / inspector → Public verification: opens
- Role-based routes → Session state: checks session
frontend/src/App.tsx - Role-based routes → Operations pages: routes to
frontend/src/App.tsx - Role-based routes → Public verification: routes to
frontend/src/App.tsx - Operations pages → HTTP client: requests data
- Public verification → HTTP client: requests verification
- HTTP client → Authentication API: calls REST API
README.md - HTTP client → Fleet APIs: calls REST API
README.md - Report client → Reports and exports: requests reports
README.md - Fleet APIs → Vehicle mutations: delegates mutations
backend/src/main/java/pe/marcona/mtc/controller/VehicleQueryController.java - Company / driver API → Authentication service: checks roles
backend/src/main/java/pe/marcona/mtc/controller/CompanyDriverController.java - Assignment API → Driver assignment: assigns drivers
backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java - Assignment API → Circulation checks: validates circulation
backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java - Assignment API → Action audit: records actions
backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java - Assignment API → Authentication service: authorizes requests
backend/src/main/java/pe/marcona/mtc/controller/AssignmentController.java - Permit API → Permit lifecycle: manages permits
backend/src/main/java/pe/marcona/mtc/controller/PermitController.java - Permit API → Circulation checks: verifies permits
backend/src/main/java/pe/marcona/mtc/controller/PermitController.java - Permit lifecycle → Permit DAO: reads and writes
backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java - Permit lifecycle → QR generation: generates QR
backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java - Permit lifecycle → Action audit: records issuance
backend/src/main/java/pe/marcona/mtc/service/impl/PermisoServiceImpl.java - Vehicle mutations → Vehicle mutation DAO: reads and writes
backend/src/main/java/pe/marcona/mtc/service/impl/VehiculoMutacionServiceImpl.java - Vehicle mutations → Action audit: records changes
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
README.md - Permit DAO → MySQL database: persists via JDBC
README.md - Vehicle mutation DAO → MySQL database: persists via JDBC
README.md - Permit API → API response envelope: returns envelope
backend/src/main/java/pe/marcona/mtc/controller/PermitController.java