# dxxdev/hamroh-platform architecture

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

- Interactive diagram: https://gitdiagram.com/dxxdev/hamroh-platform
- Repository: https://github.com/dxxdev/hamroh-platform

## Overview

Hamroh appears to be an early ride-mobility platform with passenger and driver mobile apps, an admin-web scaffold, and a NestJS backend. The visible passenger flow is choosing a destination in a local screen; the driver screen toggles online status and displays a static route. The backend currently exposes a health check, not ride-booking operations. The repository has no README, and sampled source does not show mobile-to-backend calls, persistence, or shared domain types, so those connections are omitted.

Main entry points: [`services/backend/src/app.module.ts`](https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/app.module.ts) (App module), [`services/backend/src/modules/health/health.module.ts`](https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/modules/health/health.module.ts) (Health module), [`services/backend/src/main.ts`](https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/main.ts) (API runtime), [`apps/passangers-app/App.tsx`](https://github.com/dxxdev/hamroh-platform/blob/main/apps/passangers-app/App.tsx) (Destination screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_passenger["Passenger app"]
  node_passenger_screen["Destination screen<br/>[App.tsx]"]
end

subgraph group_driver["Driver app"]
  node_driver_screen["Driver status<br/>[App.tsx]"]
end

subgraph group_platform["Platform services"]
  node_admin_home["Admin scaffold<br/>[page.tsx]"]
  node_api_runtime["API runtime<br/>[main.ts]"]
  node_app_module["App module<br/>[app.module.ts]"]
  node_health_module["Health module<br/>[health.module.ts]"]
  node_health_controller["Health endpoint"]
  node_shared_types["Shared types<br/>[index.ts]"]
end

node_passenger_user(("Passenger"))
node_driver_user(("Driver"))

node_passenger_user -->|"chooses destination"| node_passenger_screen
node_driver_user -->|"toggles availability"| node_driver_screen
node_api_runtime -->|"boots module"| node_app_module
node_app_module -->|"imports"| node_health_module
node_health_module -->|"registers route"| node_health_controller

click node_passenger_screen "https://github.com/dxxdev/hamroh-platform/blob/main/apps/passangers-app/App.tsx"
click node_driver_screen "https://github.com/dxxdev/hamroh-platform/blob/main/apps/driver-app/App.tsx"
click node_admin_home "https://github.com/dxxdev/hamroh-platform/blob/main/apps/admin-web/app/page.tsx"
click node_api_runtime "https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/main.ts"
click node_app_module "https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/app.module.ts"
click node_health_module "https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/modules/health/health.module.ts"
click node_health_controller "https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/modules/health/health.controller.ts"
click node_shared_types "https://github.com/dxxdev/hamroh-platform/blob/main/packages/shared-types/src/index.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_passenger_screen toneBlue
class node_driver_screen toneAmber
class node_admin_home,node_api_runtime,node_app_module,node_health_module,node_health_controller,node_shared_types toneMint
class node_passenger_user,node_driver_user toneIndigo
```

## Components

### Passenger app

- [Destination screen](https://github.com/dxxdev/hamroh-platform/blob/main/apps/passangers-app/App.tsx): `apps/passangers-app/App.tsx`

### Driver app

- [Driver status](https://github.com/dxxdev/hamroh-platform/blob/main/apps/driver-app/App.tsx): `apps/driver-app/App.tsx`

### Platform services

- [Admin scaffold](https://github.com/dxxdev/hamroh-platform/blob/main/apps/admin-web/app/page.tsx): `apps/admin-web/app/page.tsx`
- [API runtime](https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/main.ts): `services/backend/src/main.ts`
- [App module](https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/app.module.ts): `services/backend/src/app.module.ts`
- [Health module](https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/modules/health/health.module.ts): `services/backend/src/modules/health/health.module.ts`
- [Health endpoint](https://github.com/dxxdev/hamroh-platform/blob/main/services/backend/src/modules/health/health.controller.ts): `services/backend/src/modules/health/health.controller.ts`
- [Shared types](https://github.com/dxxdev/hamroh-platform/blob/main/packages/shared-types/src/index.ts): `packages/shared-types/src/index.ts`

### Other components

- **Passenger**
- **Driver**

## Connections

- Passenger → Destination screen: chooses destination
- Driver → Driver status: toggles availability
- API runtime → App module: boots module
- App module → Health module: imports
- Health module → Health endpoint: registers route