# solomon-wilson/urban-mobility-management-system architecture

> Architecture diagram of the GitHub repository solomon-wilson/urban-mobility-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/solomon-wilson/urban-mobility-management-system
- Repository: https://github.com/solomon-wilson/urban-mobility-management-system

## Overview

This is a public-transport management web application with authentication, operator dashboards, compliance tracking, infrastructure mapping, and mobility analytics. The visible user-facing flow begins at the Next.js app shell, which provides authentication context around the page; the dashboard and domain modules represent operational views. The excerpts confirm AssetMapView selects and supplies assets to one of two map renderers. The README is empty, and unsampled page, dashboard, compliance, and data-access code limits conclusions about their wiring; the Supabase files establish integration support and domain types, not confirmed runtime reads or writes.

Main entry points: [`src/components/maps/AssetMapView.tsx`](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/maps/AssetMapView.tsx) (Asset mapping), [`src/app/layout.tsx`](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/app/layout.tsx) (Root layout), [`src/app/page.tsx`](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/app/page.tsx) (App page), [`src/components/auth/AuthContext.tsx`](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/auth/AuthContext.tsx) (Auth provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and access"]
  node_layout["Root layout<br/>[layout.tsx]"]
  node_page["App page<br/>[page.tsx]"]
  node_auth["Auth provider<br/>[AuthContext.tsx]"]
  node_login["Login form<br/>[LoginForm.tsx]"]
  node_profile["User profile<br/>[UserProfile.tsx]"]
end

subgraph group_operations["Operations dashboard"]
  node_dashboard["Dashboard layout"]
  node_overview["Operator overview"]
  node_mobility["Mobility analytics"]
end

subgraph group_domains["Transport domains"]
  node_compliance["Compliance module"]
  node_assets["Asset mapping<br/>[AssetMapView.tsx]"]
  node_interactive["Interactive map<br/>[InteractiveMap.tsx]"]
  node_googlemap["Google map<br/>[GoogleMapsView.tsx]"]
end

subgraph group_data["Data foundations"]
  node_supabase["Supabase client<br/>[supabase.ts]"]
  node_dbtypes["Database types<br/>[database.types.ts]"]
  node_supabasetypes["Supabase types<br/>[supabase.ts]"]
end

node_user(("User"))

node_user -->|"opens app"| node_page
node_layout -->|"wraps children"| node_auth
node_assets -->|"renders assets"| node_interactive
node_assets -->|"renders assets"| node_googlemap

click node_layout "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/app/layout.tsx"
click node_page "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/app/page.tsx"
click node_auth "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/auth/AuthContext.tsx"
click node_login "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/auth/LoginForm.tsx"
click node_profile "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/auth/UserProfile.tsx"
click node_dashboard "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/dashboard/DashboardLayout.tsx"
click node_overview "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/dashboard/OperatorOverview.tsx"
click node_mobility "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/dashboard/SmartMobilityPlatform.tsx"
click node_compliance "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/compliance/ComplianceModule.tsx"
click node_assets "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/maps/AssetMapView.tsx"
click node_interactive "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/maps/InteractiveMap.tsx"
click node_googlemap "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/maps/GoogleMapsView.tsx"
click node_supabase "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/lib/supabase.ts"
click node_dbtypes "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/types/database.types.ts"
click node_supabasetypes "https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/types/supabase.ts"

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_layout,node_page,node_auth,node_login,node_profile,node_user toneBlue
class node_dashboard,node_overview,node_mobility toneAmber
class node_compliance,node_assets,node_interactive,node_googlemap toneMint
class node_supabase,node_dbtypes,node_supabasetypes toneRose
```

## Components

### App and access

- [Root layout](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/app/layout.tsx): `src/app/layout.tsx`
- [App page](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Auth provider](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/auth/AuthContext.tsx): `src/components/auth/AuthContext.tsx`
- [Login form](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/auth/LoginForm.tsx): `src/components/auth/LoginForm.tsx`
- [User profile](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/auth/UserProfile.tsx): `src/components/auth/UserProfile.tsx`

### Operations dashboard

- [Dashboard layout](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/dashboard/DashboardLayout.tsx): `src/components/dashboard/DashboardLayout.tsx`
- [Operator overview](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/dashboard/OperatorOverview.tsx): `src/components/dashboard/OperatorOverview.tsx`
- [Mobility analytics](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/dashboard/SmartMobilityPlatform.tsx): `src/components/dashboard/SmartMobilityPlatform.tsx`

### Transport domains

- [Compliance module](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/compliance/ComplianceModule.tsx): `src/components/compliance/ComplianceModule.tsx`
- [Asset mapping](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/maps/AssetMapView.tsx): `src/components/maps/AssetMapView.tsx`
- [Interactive map](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/maps/InteractiveMap.tsx): `src/components/maps/InteractiveMap.tsx`
- [Google map](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/components/maps/GoogleMapsView.tsx): `src/components/maps/GoogleMapsView.tsx`

### Data foundations

- [Supabase client](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Database types](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/types/database.types.ts): `types/database.types.ts`
- [Supabase types](https://github.com/solomon-wilson/urban-mobility-management-system/blob/main/src/types/supabase.ts): `src/types/supabase.ts`

### Other components

- **User**

## Connections

- User → App page: opens app
- Root layout → Auth provider: wraps children
- Asset mapping → Interactive map: renders assets
- Asset mapping → Google map: renders assets