Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lucavallini/aibar-frontend/llms.txt

Use this file to discover all available pages before exploring further.

Aibar SRL App is an Angular 22 single-page application built for Aibar SRL, a transport company that needs a unified platform to run its fleet operations. The frontend communicates exclusively with a FastAPI REST API backend — hosted in production at https://aibar-api.onrender.com — and covers every operational concern from trip logging and driver management to fuel tracking and tamper-evident audit trails. The entire interface loads in the browser with no page refreshes, giving dispatchers and managers instant feedback as they work.

User Roles

The application enforces two roles, determined from the JWT payload returned at login:
RoleAccess
administradorFull access to all modules, including the Auditoría and Usuarios sections
empleadoAccess to operational modules: Viajes, Choferes, Camiones, Multas, and Combustible
Role checks happen at the route level through Angular guards (authGuard and adminGuard), so unauthorized navigation attempts are blocked before any component is rendered.

Feature Modules

The application is organized into seven feature modules, each representing a distinct operational domain:

Viajes

Record and manage trips: assign drivers and trucks, log departure and arrival details, and maintain a complete journey history for the fleet.

Choferes

Maintain the driver roster: add new drivers, update personal and license information, and track each driver’s assignment history.

Camiones

Manage the truck fleet: register vehicles, track plate numbers and capacity, and keep maintenance records up to date.

Multas

Log and track traffic fines: associate penalties with specific drivers and vehicles, record amounts, and monitor resolution status.

Combustible

Track fuel consumption and refuelling events: link fill-ups to trucks and trips to monitor cost and efficiency across the fleet.

Auditoría

View the full system audit log: every create, update, and delete action is recorded with the responsible user and a timestamp. Restricted to the administrador role.

Usuarios

Manage system users: create employee and administrator accounts, reset credentials, and control who has access to the platform. Restricted to the administrador role.

Tech Stack

Aibar SRL App is built entirely on modern, standards-aligned web technologies:
LayerTechnology
FrameworkAngular 22 (standalone components, signals API)
LanguageTypeScript 6, compiled to ES2022
Reactive stateAngular Signals (signal()) and RxJS 7.8
HTTPAngular HttpClient with a functional authInterceptor
RoutingAngular Router with functional guards (authGuard, adminGuard)
TestingVitest 4 (via @angular/build:unit-test)
Build toolingAngular CLI 22 (@angular/build:application)
Package managernpm 11
Backend APIFastAPI REST API at https://aibar-api.onrender.com
All components use Angular’s signal() primitive for reactive local state instead of BehaviorSubject or component-level ngOnChanges, keeping the data flow explicit and fine-grained.

Build docs developers (and LLMs) love