# jaypariyar97/indtransfreightsolutionsllp architecture

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

- Interactive diagram: https://gitdiagram.com/jaypariyar97/indtransfreightsolutionsllp
- Repository: https://github.com/jaypariyar97/indtransfreightsolutionsllp

## Overview

INDTRANS is a freight-operations application: staff use a routed web interface to manage consignment notes (GCNs), fleet, customers, billing and related records, while public users can track consignments. The frontend’s shared auth state and API client connect UI workflows to a Spring backend; backend controllers handle domain operations and repositories persist records. GCN creation and printing, authentication, and permission handling have sampled relationship evidence. Other major areas are represented from the file tree, but their internal calls are not asserted; cross-layer links without direct evidence are dashed.

Main entry points: [`frontend/src/App.tsx`](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/App.tsx) (Routes and pages), [`frontend/src/services/api.ts`](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/services/api.ts) (API client), [`backend/src/main/java/com/indtrans/freight/controller/GcnController.java`](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/controller/GcnController.java) (GCN operations), [`backend/src/main/java/com/indtrans/freight/service/AuthService.java`](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/service/AuthService.java) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Routes and pages<br/>[App.tsx]"]
  node_authstate["Auth state<br/>[useAuth.tsx]"]
  node_apiclient["API client<br/>[api.ts]"]
  node_nav["Staff navigation<br/>[Sidebar.tsx]"]
end

subgraph group_freight["Freight operations"]
  node_gcnui["GCN workflow<br/>[GCN.tsx]"]
  node_vhcui["VHC workflow<br/>[VHC.tsx]"]
  node_vehicleui["Vehicle management<br/>[Vehicles.tsx]"]
  node_billingui["Billing workflow<br/>[Billing.tsx]"]
  node_recordsui["Operations pages"]
  node_trackingui["Tracking pages<br/>[TrackingPublic.tsx]"]
end

subgraph group_backend["Backend services"]
  node_fleetapi["Fleet and record APIs"]
  node_gcnapi["GCN operations<br/>[GcnController.java]"]
  node_gcnentity["GCN record<br/>[Gcn.java]"]
  node_fleetmodels["Fleet records"]
  node_persistence[("Freight database")]
  node_gcnprint["GCN print rendering"]
  node_serials["Serial numbering"]
end

subgraph group_security["Identity and access"]
  node_authapi["Authentication API<br/>[AuthService.java]"]
  node_permissions["Permission checks"]
  node_employee["Employee account<br/>[Employee.java]"]
  node_employee_repo[("Employee repository")]
end

node_staff(("Staff user"))
node_public(("Public user"))

node_staff -.->|"uses"| node_app
node_public -.->|"opens tracking"| node_app
node_app -->|"provides"| node_authstate
node_app -->|"routes to"| node_gcnui
node_app -->|"routes to"| node_vhcui
node_app -->|"routes to"| node_vehicleui
node_app -->|"routes to"| node_billingui
node_app -->|"routes to"| node_recordsui
node_app -->|"routes to"| node_trackingui
node_authstate -->|"calls"| node_apiclient
node_gcnui -->|"calls"| node_apiclient
node_gcnui -->|"renders"| node_nav
node_vhcui -->|"calls"| node_apiclient
node_vehicleui -->|"calls"| node_apiclient
node_billingui -->|"calls"| node_apiclient
node_apiclient -.->|"requests"| node_gcnapi
node_apiclient -.->|"requests"| node_fleetapi
node_gcnapi -->|"reads and writes"| node_gcnentity
node_gcnapi -->|"uses repositories"| node_persistence
node_gcnapi -->|"uses"| node_gcnprint
node_gcnapi -->|"uses"| node_serials
node_fleetapi -.->|"manages records"| node_fleetmodels
node_fleetapi -.->|"uses repositories"| node_persistence
node_serials -->|"uses counter repository"| node_persistence
node_authapi -->|"authenticates against"| node_employee_repo
node_authapi -->|"uses account"| node_employee
node_authapi -.->|"serves login requests"| node_apiclient
node_permissions -->|"loads account"| node_employee_repo
node_permissions -->|"checks role"| node_employee

click node_app "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/App.tsx"
click node_authstate "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/hooks/useAuth.tsx"
click node_apiclient "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/services/api.ts"
click node_nav "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/components/Sidebar.tsx"
click node_gcnui "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/GCN.tsx"
click node_vhcui "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/VHC.tsx"
click node_vehicleui "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/Vehicles.tsx"
click node_billingui "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/Billing.tsx"
click node_recordsui "https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/frontend/src/pages"
click node_trackingui "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/TrackingPublic.tsx"
click node_fleetapi "https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/backend/src/main/java/com/indtrans/freight/controller"
click node_gcnapi "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/controller/GcnController.java"
click node_gcnentity "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/model/Gcn.java"
click node_fleetmodels "https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/backend/src/main/java/com/indtrans/freight/model"
click node_persistence "https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/backend/src/main/java/com/indtrans/freight/repository"
click node_gcnprint "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/service/GcnPrintTemplateService.java"
click node_serials "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/util/SerialNumberGenerator.java"
click node_authapi "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/service/AuthService.java"
click node_permissions "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/security/PermissionService.java"
click node_employee "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/model/Employee.java"
click node_employee_repo "https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/repository/EmployeeRepository.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_authstate,node_apiclient,node_nav,node_staff,node_public toneBlue
class node_gcnui,node_vhcui,node_vehicleui,node_billingui,node_recordsui,node_trackingui toneAmber
class node_fleetapi,node_gcnapi,node_gcnentity,node_fleetmodels,node_persistence,node_gcnprint,node_serials toneMint
class node_authapi,node_permissions,node_employee,node_employee_repo toneRose
```

## Components

### Web application

- [Routes and pages](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth state](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/hooks/useAuth.tsx): `frontend/src/hooks/useAuth.tsx`
- [API client](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Staff navigation](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/components/Sidebar.tsx): `frontend/src/components/Sidebar.tsx`

### Freight operations

- [GCN workflow](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/GCN.tsx): `frontend/src/pages/GCN.tsx`
- [VHC workflow](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/VHC.tsx): `frontend/src/pages/VHC.tsx`
- [Vehicle management](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/Vehicles.tsx): `frontend/src/pages/Vehicles.tsx`
- [Billing workflow](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/Billing.tsx): `frontend/src/pages/Billing.tsx`
- [Operations pages](https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/frontend/src/pages): `frontend/src/pages`
- [Tracking pages](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/frontend/src/pages/TrackingPublic.tsx): `frontend/src/pages/TrackingPublic.tsx`

### Backend services

- [Fleet and record APIs](https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/backend/src/main/java/com/indtrans/freight/controller): `backend/src/main/java/com/indtrans/freight/controller`
- [GCN operations](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/controller/GcnController.java): `backend/src/main/java/com/indtrans/freight/controller/GcnController.java`
- [GCN record](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/model/Gcn.java): `backend/src/main/java/com/indtrans/freight/model/Gcn.java`
- [Fleet records](https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/backend/src/main/java/com/indtrans/freight/model): `backend/src/main/java/com/indtrans/freight/model`
- [Freight database](https://github.com/jaypariyar97/indtransfreightsolutionsllp/tree/main/backend/src/main/java/com/indtrans/freight/repository): `backend/src/main/java/com/indtrans/freight/repository`
- [GCN print rendering](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/service/GcnPrintTemplateService.java): `backend/src/main/java/com/indtrans/freight/service/GcnPrintTemplateService.java`
- [Serial numbering](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/util/SerialNumberGenerator.java): `backend/src/main/java/com/indtrans/freight/util/SerialNumberGenerator.java`

### Identity and access

- [Authentication API](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/service/AuthService.java): `backend/src/main/java/com/indtrans/freight/service/AuthService.java`
- [Permission checks](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/security/PermissionService.java): `backend/src/main/java/com/indtrans/freight/security/PermissionService.java`
- [Employee account](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/model/Employee.java): `backend/src/main/java/com/indtrans/freight/model/Employee.java`
- [Employee repository](https://github.com/jaypariyar97/indtransfreightsolutionsllp/blob/main/backend/src/main/java/com/indtrans/freight/repository/EmployeeRepository.java): `backend/src/main/java/com/indtrans/freight/repository/EmployeeRepository.java`

### Other components

- **Staff user**
- **Public user**

## Connections

- Staff user → Routes and pages: uses
- Public user → Routes and pages: opens tracking
- Routes and pages → Auth state: provides (evidence: `frontend/src/App.tsx`)
- Routes and pages → GCN workflow: routes to (evidence: `frontend/src/App.tsx`)
- Routes and pages → VHC workflow: routes to (evidence: `frontend/src/App.tsx`)
- Routes and pages → Vehicle management: routes to (evidence: `frontend/src/App.tsx`)
- Routes and pages → Billing workflow: routes to (evidence: `frontend/src/App.tsx`)
- Routes and pages → Operations pages: routes to (evidence: `frontend/src/App.tsx`)
- Routes and pages → Tracking pages: routes to (evidence: `frontend/src/App.tsx`)
- Auth state → API client: calls (evidence: `frontend/src/hooks/useAuth.tsx`)
- GCN workflow → API client: calls (evidence: `frontend/src/pages/GCN.tsx`)
- GCN workflow → Staff navigation: renders (evidence: `frontend/src/pages/GCN.tsx`)
- VHC workflow → API client: calls (evidence: `frontend/src/pages/VHC.tsx`)
- Vehicle management → API client: calls (evidence: `frontend/src/pages/Vehicles.tsx`)
- Billing workflow → API client: calls (evidence: `frontend/src/pages/Billing.tsx`)
- API client → GCN operations: requests
- API client → Fleet and record APIs: requests
- GCN operations → GCN record: reads and writes (evidence: `backend/src/main/java/com/indtrans/freight/controller/GcnController.java`)
- GCN operations → Freight database: uses repositories (evidence: `backend/src/main/java/com/indtrans/freight/controller/GcnController.java`)
- GCN operations → GCN print rendering: uses (evidence: `backend/src/main/java/com/indtrans/freight/controller/GcnController.java`)
- GCN operations → Serial numbering: uses (evidence: `backend/src/main/java/com/indtrans/freight/controller/GcnController.java`)
- Fleet and record APIs → Fleet records: manages records (evidence: `backend/src/main/java/com/indtrans/freight/controller/GcnController.java`)
- Fleet and record APIs → Freight database: uses repositories (evidence: `backend/src/main/java/com/indtrans/freight/controller/GcnController.java`)
- Serial numbering → Freight database: uses counter repository (evidence: `backend/src/main/java/com/indtrans/freight/util/SerialNumberGenerator.java`)
- Authentication API → Employee repository: authenticates against (evidence: `backend/src/main/java/com/indtrans/freight/service/AuthService.java`)
- Authentication API → Employee account: uses account (evidence: `backend/src/main/java/com/indtrans/freight/service/AuthService.java`)
- Authentication API → API client: serves login requests
- Permission checks → Employee repository: loads account (evidence: `backend/src/main/java/com/indtrans/freight/security/PermissionService.java`)
- Permission checks → Employee account: checks role (evidence: `backend/src/main/java/com/indtrans/freight/security/PermissionService.java`)
