# ma813/carpoolmobileapp architecture

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

- Interactive diagram: https://gitdiagram.com/ma813/carpoolmobileapp
- Repository: https://github.com/ma813/carpoolmobileapp

## Overview

This is a mobile-friendly employee social and carpooling app: users register, set addresses and work schedules, discover nearby colleagues, form parties, and view optimized commute routes. The backend exposes the corresponding account, colleague, party, profile, transport, and destination features, with Entity Framework persistence and Mapbox routing. The README gives the product purpose, while source excerpts show several controller-to-database and routing relationships. Some frontend-to-API wiring and unsampled feature internals are not visible, so those links are left dashed or omitted.

Main entry points: [`Backend/Backend/AppDbContext.cs`](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/AppDbContext.cs) (Data access context), [`Frontend/Frontend/app/pages/Map.tsx`](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Map.tsx) (Map screen), [`Backend/Backend/Controllers/UserAddressController.cs`](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/UserAddressController.cs) (Addresses and matches), [`Backend/Backend/Controllers/PartyController.cs`](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/PartyController.cs) (Party management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile app"]
  node_app["App entry<br/>[index.tsx]"]
  node_navigation["Navigation<br/>[navigation.ts]"]
  node_nav["Navigation bar<br/>[NavBar.tsx]"]
  node_mapui["Map screen<br/>[Map.tsx]"]
  node_mapcontrols["Map controls"]
  node_popup["Selection popup<br/>[PopUpSelect.tsx]"]
end

subgraph group_identity["Accounts and profile"]
  node_authui["Login and signup<br/>[LoginPage.tsx]"]
  node_profileui["Profile settings<br/>[Profile.tsx]"]
  node_addressui["Address settings<br/>[Addresses.tsx]"]
  node_scheduleui["Work schedule<br/>[UserWorkTime.tsx]"]
  node_transportui["Transport choice"]
  node_authapi["Auth API<br/>[authApi.ts]"]
  node_storage[("Local session storage<br/>[localStorage.ts]")]
  node_carui["Car selection<br/>[CarSelect.tsx]"]
  node_worktimesui["Work time view<br/>[WorkTimesPage.tsx]"]
  node_authcontroller["Authentication<br/>[AuthController.cs]"]
  node_authservice["JWT generation<br/>[Auth.cs]"]
  node_carscontroller["Car management<br/>[CarsController.cs]"]
  node_transportcontroller["Transport mode"]
  node_worktimecontroller["Work schedule API"]
end

subgraph group_matching["Colleague matching"]
  node_addresscontroller["Addresses and matches"]
end

subgraph group_carpool["Parties and routes"]
  node_partyui["Party screens<br/>[Party.tsx]"]
  node_createpartyui["Create party<br/>[CreateParty.tsx]"]
  node_partycontroller["Party management<br/>[PartyController.cs]"]
  node_destinationcontroller["Destinations and routes"]
  node_weathercontroller["Weather endpoint"]
end

subgraph group_data["Backend and persistence"]
  node_clientapi["API client<br/>[api.ts]"]
  node_dbcontext["Data access context<br/>[AppDbContext.cs]"]
  node_database[("Application database")]
end

node_employee(("Employee"))
node_mapbox{{"Mapbox routing"}}

node_employee -->|"uses"| node_app
node_app -->|"renders"| node_nav
node_app -->|"uses routes"| node_navigation
node_nav -->|"clears session"| node_storage
node_mapui -->|"renders"| node_nav
node_mapui -->|"uses"| node_mapcontrols
node_mapui -->|"uses"| node_popup
node_authui -.->|"submits credentials"| node_authapi
node_authapi -->|"uses"| node_clientapi
node_authapi -->|"stores session"| node_storage
node_clientapi -->|"reads token"| node_storage
node_clientapi -.->|"HTTP requests"| node_authcontroller
node_addressui -.->|"address requests"| node_addresscontroller
node_scheduleui -.->|"schedule requests"| node_worktimecontroller
node_transportui -.->|"mode requests"| node_transportcontroller
node_carui -.->|"car requests"| node_carscontroller
node_partyui -.->|"party requests"| node_partycontroller
node_createpartyui -.->|"creates party"| node_partycontroller
node_mapui -.->|"finds colleagues"| node_addresscontroller
node_mapui -.->|"route requests"| node_destinationcontroller
node_authcontroller -->|"generates token"| node_authservice
node_authcontroller -->|"reads and writes"| node_dbcontext
node_addresscontroller -->|"queries and saves"| node_dbcontext
node_partycontroller -->|"queries and saves"| node_dbcontext
node_destinationcontroller -->|"queries and saves"| node_dbcontext
node_carscontroller -->|"queries and saves"| node_dbcontext
node_transportcontroller -.->|"queries and saves"| node_dbcontext
node_worktimecontroller -->|"queries and saves"| node_dbcontext
node_weathercontroller -.->|"reads forecast"| node_dbcontext
node_dbcontext -->|"maps entities"| node_database
node_addresscontroller -->|"requests distances"| node_mapbox
node_partycontroller -->|"requests routing"| node_mapbox
node_destinationcontroller -->|"optimizes routes"| node_mapbox

click node_app "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/index.tsx"
click node_navigation "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/navigation.ts"
click node_nav "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/components/NavBar.tsx"
click node_mapui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Map.tsx"
click node_mapcontrols "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/components/GoogleMapsButton.tsx"
click node_popup "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/components/PopUpSelect.tsx"
click node_authui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/LoginPage.tsx"
click node_profileui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Profile.tsx"
click node_addressui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Addresses.tsx"
click node_scheduleui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/UserWorkTime.tsx"
click node_transportui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/ModeOfTransport.tsx"
click node_clientapi "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/services/api.ts"
click node_authapi "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/services/authApi.ts"
click node_storage "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/services/localStorage.ts"
click node_carui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/CarSelect.tsx"
click node_partyui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Party.tsx"
click node_createpartyui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/CreateParty.tsx"
click node_worktimesui "https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/WorkTimesPage.tsx"
click node_authcontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/AuthController.cs"
click node_authservice "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Services/Auth.cs"
click node_addresscontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/UserAddressController.cs"
click node_partycontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/PartyController.cs"
click node_destinationcontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/DestinationController.cs"
click node_carscontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/CarsController.cs"
click node_transportcontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/ModeOfTransportController.cs"
click node_worktimecontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/UserWorkTimeController.cs"
click node_weathercontroller "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/WeatherForecastController.cs"
click node_dbcontext "https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/AppDbContext.cs"

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_navigation,node_nav,node_mapui,node_mapcontrols,node_popup toneBlue
class node_authui,node_profileui,node_addressui,node_scheduleui,node_transportui,node_authapi,node_storage,node_carui,node_worktimesui,node_authcontroller,node_authservice,node_carscontroller,node_transportcontroller,node_worktimecontroller toneAmber
class node_addresscontroller toneMint
class node_partyui,node_createpartyui,node_partycontroller,node_destinationcontroller,node_weathercontroller toneRose
class node_clientapi,node_dbcontext,node_database,node_employee,node_mapbox toneIndigo
```

## Components

### Mobile app

- [App entry](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/index.tsx): `Frontend/Frontend/app/index.tsx`
- [Navigation](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/navigation.ts): `Frontend/Frontend/app/navigation.ts`
- [Navigation bar](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/components/NavBar.tsx): `Frontend/Frontend/app/components/NavBar.tsx`
- [Map screen](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Map.tsx): `Frontend/Frontend/app/pages/Map.tsx`
- [Map controls](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/components/GoogleMapsButton.tsx): `Frontend/Frontend/app/components/GoogleMapsButton.tsx`
- [Selection popup](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/components/PopUpSelect.tsx): `Frontend/Frontend/app/components/PopUpSelect.tsx`

### Accounts and profile

- [Login and signup](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/LoginPage.tsx): `Frontend/Frontend/app/pages/LoginPage.tsx`
- [Profile settings](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Profile.tsx): `Frontend/Frontend/app/pages/Profile.tsx`
- [Address settings](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Addresses.tsx): `Frontend/Frontend/app/pages/Addresses.tsx`
- [Work schedule](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/UserWorkTime.tsx): `Frontend/Frontend/app/pages/UserWorkTime.tsx`
- [Transport choice](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/ModeOfTransport.tsx): `Frontend/Frontend/app/pages/ModeOfTransport.tsx`
- [Auth API](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/services/authApi.ts): `Frontend/Frontend/services/authApi.ts`
- [Local session storage](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/services/localStorage.ts): `Frontend/Frontend/services/localStorage.ts`
- [Car selection](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/CarSelect.tsx): `Frontend/Frontend/app/pages/CarSelect.tsx`
- [Work time view](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/WorkTimesPage.tsx): `Frontend/Frontend/app/pages/WorkTimesPage.tsx`
- [Authentication](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/AuthController.cs): `Backend/Backend/Controllers/AuthController.cs`
- [JWT generation](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Services/Auth.cs): `Backend/Backend/Services/Auth.cs`
- [Car management](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/CarsController.cs): `Backend/Backend/Controllers/CarsController.cs`
- [Transport mode](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/ModeOfTransportController.cs): `Backend/Backend/Controllers/ModeOfTransportController.cs`
- [Work schedule API](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/UserWorkTimeController.cs): `Backend/Backend/Controllers/UserWorkTimeController.cs`

### Colleague matching

- [Addresses and matches](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/UserAddressController.cs): `Backend/Backend/Controllers/UserAddressController.cs`

### Parties and routes

- [Party screens](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/Party.tsx): `Frontend/Frontend/app/pages/Party.tsx`
- [Create party](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/app/pages/CreateParty.tsx): `Frontend/Frontend/app/pages/CreateParty.tsx`
- [Party management](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/PartyController.cs): `Backend/Backend/Controllers/PartyController.cs`
- [Destinations and routes](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/DestinationController.cs): `Backend/Backend/Controllers/DestinationController.cs`
- [Weather endpoint](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/Controllers/WeatherForecastController.cs): `Backend/Backend/Controllers/WeatherForecastController.cs`

### Backend and persistence

- [API client](https://github.com/ma813/carpoolmobileapp/blob/main/Frontend/Frontend/services/api.ts): `Frontend/Frontend/services/api.ts`
- [Data access context](https://github.com/ma813/carpoolmobileapp/blob/main/Backend/Backend/AppDbContext.cs): `Backend/Backend/AppDbContext.cs`
- **Application database**

### Other components

- **Employee**
- **Mapbox routing**

## Connections

- Employee → App entry: uses
- App entry → Navigation bar: renders (evidence: `Frontend/Frontend/app/index.tsx`)
- App entry → Navigation: uses routes
- Navigation bar → Local session storage: clears session (evidence: `Frontend/Frontend/app/components/NavBar.tsx`)
- Map screen → Navigation bar: renders (evidence: `Frontend/Frontend/app/pages/Map.tsx`)
- Map screen → Map controls: uses (evidence: `Frontend/Frontend/app/pages/Map.tsx`)
- Map screen → Selection popup: uses (evidence: `Frontend/Frontend/app/pages/Map.tsx`)
- Login and signup → Auth API: submits credentials
- Auth API → API client: uses (evidence: `Frontend/Frontend/services/authApi.ts`)
- Auth API → Local session storage: stores session (evidence: `Frontend/Frontend/services/authApi.ts`)
- API client → Local session storage: reads token (evidence: `Frontend/Frontend/services/api.ts`)
- API client → Authentication: HTTP requests
- Address settings → Addresses and matches: address requests
- Work schedule → Work schedule API: schedule requests
- Transport choice → Transport mode: mode requests
- Car selection → Car management: car requests
- Party screens → Party management: party requests
- Create party → Party management: creates party
- Map screen → Addresses and matches: finds colleagues
- Map screen → Destinations and routes: route requests
- Authentication → JWT generation: generates token (evidence: `Backend/Backend/Controllers/AuthController.cs`)
- Authentication → Data access context: reads and writes (evidence: `Backend/Backend/Controllers/AuthController.cs`)
- Addresses and matches → Data access context: queries and saves (evidence: `Backend/Backend/Controllers/UserAddressController.cs`)
- Party management → Data access context: queries and saves (evidence: `Backend/Backend/Controllers/PartyController.cs`)
- Destinations and routes → Data access context: queries and saves (evidence: `Backend/Backend/Controllers/DestinationController.cs`)
- Car management → Data access context: queries and saves (evidence: `Backend/Backend/Controllers/CarsController.cs`)
- Transport mode → Data access context: queries and saves (evidence: `Backend/Backend/Controllers/ModeOfTransportController.cs`)
- Work schedule API → Data access context: queries and saves (evidence: `Backend/Backend/Controllers/UserWorkTimeController.cs`)
- Weather endpoint → Data access context: reads forecast
- Data access context → Application database: maps entities (evidence: `Backend/Backend/AppDbContext.cs`)
- Addresses and matches → Mapbox routing: requests distances (evidence: `Backend/Backend/Controllers/UserAddressController.cs`)
- Party management → Mapbox routing: requests routing (evidence: `Backend/Backend/Controllers/PartyController.cs`)
- Destinations and routes → Mapbox routing: optimizes routes (evidence: `Backend/Backend/Controllers/DestinationController.cs`)
