# manav-sharma-paudel/ku-food-hunt architecture

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

- Interactive diagram: https://gitdiagram.com/manav-sharma-paudel/ku-food-hunt
- Repository: https://github.com/manav-sharma-paudel/ku-food-hunt

## Overview

KU Food Hunt is a Kathmandu University food-discovery application: diners discover places, inspect menus and reviews, and navigate to restaurants; owners can submit listings, while admins moderate and maintain the catalog. The graph preserves the documented map, search, SEO, review, admin, and partner-onboarding capabilities. Some branches are represented at directory level because their implementation was not sampled; dashed edges mark relationships not verified in the excerpts.

Main entry points: [`apps/api/src/app.ts`](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/app.ts) (API application), [`apps/web/src/api/client.ts`](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/api/client.ts) (API client), [`apps/web/src/router.tsx`](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/router.tsx) (Web application), [`apps/api/src/modules/restaurants/restaurants.service.ts`](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/restaurants/restaurants.service.ts) (Restaurant catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Diner experience"]
  node_webapp["Web application<br/>[router.tsx]"]
  node_explore["Explore and search<br/>[Explore.tsx]"]
  node_mapui["Restaurant map<br/>[Map.tsx]"]
  node_detail["Restaurant detail"]
  node_reviewui["Review submission"]
  node_webclient["API client<br/>[client.ts]"]
end

subgraph group_api["Discovery API"]
  node_apiapp["API application<br/>[app.ts]"]
  node_restaurantapi["Restaurant catalog"]
  node_searchapi["Search suggestions<br/>[search.service.ts]"]
  node_mapapi["Map listings<br/>[map.service.ts]"]
  node_discovery["Home and categories"]
  node_seo["SEO and sitemap<br/>[seo.routes.ts]"]
end

subgraph group_contrib["Reviews and partners"]
  node_reviews["Review handling<br/>[reviews.service.ts]"]
  node_partners["Partner submissions<br/>[partners.routes.ts]"]
  node_partnerui["Partner form"]
end

subgraph group_admin["Admin console"]
  node_adminui["Admin dashboard<br/>[AdminHomepage.tsx]"]
  node_adminapi["Admin catalog service"]
end

subgraph group_shared["Shared contracts"]
  node_sharedschemas["Shared validation schemas"]
end

node_visitor(("Diner"))
node_database[("PostgreSQL")]

node_visitor -->|"browses"| node_webapp
node_webapp -->|"routes to"| node_explore
node_webapp -->|"routes to"| node_mapui
node_webapp -->|"routes to"| node_detail
node_explore -.->|"requests data"| node_webclient
node_mapui -.->|"requests data"| node_webclient
node_detail -.->|"requests data"| node_webclient
node_reviewui -->|"posts review"| node_webclient
node_webclient -.->|"calls API"| node_apiapp
node_apiapp -->|"routes catalog requests"| node_restaurantapi
node_apiapp -->|"routes search requests"| node_searchapi
node_apiapp -->|"routes map requests"| node_mapapi
node_apiapp -->|"routes home and category requests"| node_discovery
node_apiapp -->|"routes SEO requests"| node_seo
node_apiapp -->|"routes review requests"| node_reviews
node_restaurantapi -->|"reads catalog"| node_database
node_searchapi -->|"queries suggestions"| node_database
node_searchapi -->|"uses publication filter"| node_restaurantapi
node_reviews -->|"writes reviews and ratings"| node_database
node_partnerui -.->|"submits listing"| node_partners
node_apiapp -->|"routes submissions"| node_partners
node_adminui -.->|"manages listings"| node_adminapi
node_adminapi -->|"updates catalog"| node_database
node_adminapi -.->|"approves or rejects"| node_partners
node_restaurantapi -->|"uses shared types"| node_sharedschemas
node_reviews -->|"uses review types"| node_sharedschemas
node_partners -->|"validates submission"| node_sharedschemas

click node_webapp "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/router.tsx"
click node_explore "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/pages/Explore.tsx"
click node_mapui "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/pages/Map.tsx"
click node_detail "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/pages/RestaurantDetail.tsx"
click node_reviewui "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/components/review/WriteReviewDialog.tsx"
click node_webclient "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/api/client.ts"
click node_apiapp "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/app.ts"
click node_restaurantapi "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/restaurants/restaurants.service.ts"
click node_searchapi "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/search/search.service.ts"
click node_mapapi "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/map/map.service.ts"
click node_discovery "https://github.com/manav-sharma-paudel/ku-food-hunt/tree/main/apps/api/src/modules"
click node_seo "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/seo/seo.routes.ts"
click node_reviews "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/reviews/reviews.service.ts"
click node_partners "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/partners/partners.routes.ts"
click node_partnerui "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/partners/PartnerSubmitPage.tsx"
click node_adminui "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/admin/pages/AdminHomepage.tsx"
click node_adminapi "https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/admin/admin-restaurants.service.ts"
click node_sharedschemas "https://github.com/manav-sharma-paudel/ku-food-hunt/tree/main/packages/shared/src/schemas"

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_webapp,node_explore,node_mapui,node_detail,node_reviewui,node_webclient toneBlue
class node_apiapp,node_restaurantapi,node_searchapi,node_mapapi,node_discovery,node_seo,node_database toneAmber
class node_reviews,node_partners,node_partnerui toneMint
class node_adminui,node_adminapi toneRose
class node_sharedschemas,node_visitor toneIndigo
```

## Components

### Diner experience

- [Web application](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/router.tsx): `apps/web/src/router.tsx`
- [Explore and search](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/pages/Explore.tsx): `apps/web/src/pages/Explore.tsx`
- [Restaurant map](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/pages/Map.tsx): `apps/web/src/pages/Map.tsx`
- [Restaurant detail](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/pages/RestaurantDetail.tsx): `apps/web/src/pages/RestaurantDetail.tsx`
- [Review submission](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/components/review/WriteReviewDialog.tsx): `apps/web/src/components/review/WriteReviewDialog.tsx`
- [API client](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/api/client.ts): `apps/web/src/api/client.ts`

### Discovery API

- [API application](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Restaurant catalog](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/restaurants/restaurants.service.ts): `apps/api/src/modules/restaurants/restaurants.service.ts`
- [Search suggestions](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/search/search.service.ts): `apps/api/src/modules/search/search.service.ts`
- [Map listings](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/map/map.service.ts): `apps/api/src/modules/map/map.service.ts`
- [Home and categories](https://github.com/manav-sharma-paudel/ku-food-hunt/tree/main/apps/api/src/modules): `apps/api/src/modules`
- [SEO and sitemap](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/seo/seo.routes.ts): `apps/api/src/modules/seo/seo.routes.ts`

### Reviews and partners

- [Review handling](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/reviews/reviews.service.ts): `apps/api/src/modules/reviews/reviews.service.ts`
- [Partner submissions](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/partners/partners.routes.ts): `apps/api/src/modules/partners/partners.routes.ts`
- [Partner form](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/partners/PartnerSubmitPage.tsx): `apps/web/src/partners/PartnerSubmitPage.tsx`

### Admin console

- [Admin dashboard](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/web/src/admin/pages/AdminHomepage.tsx): `apps/web/src/admin/pages/AdminHomepage.tsx`
- [Admin catalog service](https://github.com/manav-sharma-paudel/ku-food-hunt/blob/main/apps/api/src/modules/admin/admin-restaurants.service.ts): `apps/api/src/modules/admin/admin-restaurants.service.ts`

### Shared contracts

- [Shared validation schemas](https://github.com/manav-sharma-paudel/ku-food-hunt/tree/main/packages/shared/src/schemas): `packages/shared/src/schemas`

### Other components

- **Diner**
- **PostgreSQL**

## Connections

- Diner → Web application: browses (evidence: `apps/web/src/router.tsx`)
- Web application → Explore and search: routes to (evidence: `apps/web/src/router.tsx`)
- Web application → Restaurant map: routes to (evidence: `apps/web/src/router.tsx`)
- Web application → Restaurant detail: routes to (evidence: `apps/web/src/router.tsx`)
- Explore and search → API client: requests data
- Restaurant map → API client: requests data
- Restaurant detail → API client: requests data
- Review submission → API client: posts review (evidence: `apps/web/src/components/review/WriteReviewDialog.tsx`)
- API client → API application: calls API
- API application → Restaurant catalog: routes catalog requests (evidence: `apps/api/src/app.ts`)
- API application → Search suggestions: routes search requests (evidence: `apps/api/src/app.ts`)
- API application → Map listings: routes map requests (evidence: `apps/api/src/app.ts`)
- API application → Home and categories: routes home and category requests (evidence: `apps/api/src/app.ts`)
- API application → SEO and sitemap: routes SEO requests (evidence: `apps/api/src/app.ts`)
- API application → Review handling: routes review requests (evidence: `apps/api/src/app.ts`)
- Restaurant catalog → PostgreSQL: reads catalog (evidence: `apps/api/src/modules/restaurants/restaurants.service.ts`)
- Search suggestions → PostgreSQL: queries suggestions (evidence: `apps/api/src/modules/search/search.service.ts`)
- Search suggestions → Restaurant catalog: uses publication filter (evidence: `apps/api/src/modules/search/search.service.ts`)
- Review handling → PostgreSQL: writes reviews and ratings (evidence: `apps/api/src/modules/reviews/reviews.service.ts`)
- Partner form → Partner submissions: submits listing
- API application → Partner submissions: routes submissions (evidence: `apps/api/src/app.ts`)
- Admin dashboard → Admin catalog service: manages listings
- Admin catalog service → PostgreSQL: updates catalog (evidence: `apps/api/src/modules/admin/admin-restaurants.service.ts`)
- Admin catalog service → Partner submissions: approves or rejects
- Restaurant catalog → Shared validation schemas: uses shared types (evidence: `apps/api/src/modules/restaurants/restaurants.service.ts`)
- Review handling → Shared validation schemas: uses review types (evidence: `apps/api/src/modules/reviews/reviews.service.ts`)
- Partner submissions → Shared validation schemas: validates submission (evidence: `apps/api/src/modules/partners/partners.routes.ts`)
