# nopparuj-an/devpool-restaurants architecture

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

- Interactive diagram: https://gitdiagram.com/nopparuj-an/devpool-restaurants
- Repository: https://github.com/nopparuj-an/devpool-restaurants

## Overview

Restaurants is a reservation and review community: people discover restaurants, inspect availability, book or manage reservations, and leave reviews; owners manage listings and bookings, while admins moderate users and restaurants. The frontend uses shared query/API clients to reach the Go HTTP API, whose domain modules apply booking rules and persist data in PostgreSQL; image handling uses S3-compatible storage. The README documents these capabilities, but many backend wiring details and page implementations were not excerpted, so unverified links are omitted. The design gallery is a documented frontend capability and is represented separately.

Main entry points: [`backend/internal/server/server.go`](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/server/server.go) (HTTP server), [`frontend/lib/queries.ts`](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/queries.ts) (Query hooks), [`frontend/app/design/page.tsx`](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/page.tsx) (Design routes), [`frontend/app/design/gallery.tsx`](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/gallery.tsx) (Components gallery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webpages["App routes"]
  node_screens["Product screens<br/>[screens.tsx]"]
  node_pagecomponents["Page components<br/>[pages.tsx]"]
  node_restaurantform["Restaurant editor"]
  node_queries["Query hooks<br/>[queries.ts]"]
  node_apiclient["API client<br/>[api-client.ts]"]
  node_types["API data types<br/>[types.ts]"]
end

subgraph group_domain["Restaurant domain"]
  node_restaurants["Restaurant listings"]
  node_bookingrules["Booking rules"]
  node_reservations["Reservations"]
  node_reviews["Reviews<br/>[review_service.go]"]
  node_imageproc["Image processing<br/>[imageproc.go]"]
end

subgraph group_identity["Identity and moderation"]
  node_authform["Login and signup<br/>[auth-form.tsx]"]
  node_auth["Authentication<br/>[auth_service.go]"]
  node_googleauth["Google login<br/>[google_handler.go]"]
  node_admin["Admin moderation<br/>[admin_service.go]"]
  node_profile["Public profiles"]
end

subgraph group_runtime["API runtime and persistence"]
  node_storage["Image object storage<br/>[storage.go]"]
  node_server["HTTP server<br/>[server.go]"]
  node_postgres[("PostgreSQL<br/>[database.go]")]
end

subgraph group_design["Design gallery"]
  node_galleryroute["Design routes<br/>[page.tsx]"]
  node_designnav["Gallery navigation<br/>[nav.tsx]"]
  node_gallery["Components gallery<br/>[gallery.tsx]"]
  node_registry["Screen registry<br/>[registry.tsx]"]
  node_screenlist["Gallery screen list<br/>[screen-list.ts]"]
  node_mockdata["Preview mock data<br/>[mock.ts]"]
  node_designframe["Responsive frame<br/>[frame.tsx]"]
end

node_people(("Diners, owners, admins"))
node_s3[("Garage S3 storage")]

node_people -->|"uses"| node_webpages
node_webpages -.->|"renders"| node_screens
node_screens -.->|"uses"| node_pagecomponents
node_screens -.->|"reads through"| node_queries
node_pagecomponents -.->|"reads through"| node_queries
node_restaurantform -.->|"submits through"| node_queries
node_authform -.->|"submits through"| node_queries
node_queries -->|"fetches with"| node_apiclient
node_apiclient -->|"HTTP requests"| node_server
node_people -->|"signs in"| node_authform
node_server -.->|"routes requests"| node_auth
node_server -.->|"routes requests"| node_admin
node_server -.->|"routes requests"| node_profile
node_server -.->|"routes requests"| node_restaurants
node_server -.->|"routes requests"| node_reservations
node_server -.->|"routes requests"| node_reviews
node_googleauth -.->|"supports login"| node_auth
node_people -->|"discovers listings"| node_restaurants
node_people -->|"books tables"| node_reservations
node_people -->|"writes reviews"| node_reviews
node_people -->|"moderates"| node_admin
node_reservations -.->|"applies rules"| node_bookingrules
node_restaurants -.->|"processes images"| node_imageproc
node_imageproc -.->|"stores images"| node_storage
node_storage -.->|"S3 operations"| node_s3
node_server -.->|"database access"| node_postgres
node_galleryroute -->|"renders"| node_designnav
node_galleryroute -->|"renders"| node_gallery
node_galleryroute -->|"lists screens"| node_screenlist
node_galleryroute -->|"frames previews"| node_designframe
node_gallery -->|"uses previews"| node_mockdata
node_gallery -.->|"shows components"| node_registry
node_registry -.->|"renders mock data"| node_mockdata
node_registry -->|"renders screens"| node_screens
node_designnav -->|"reads sections"| node_screenlist
node_gallery -.->|"uses data shapes"| node_types

click node_webpages "https://github.com/nopparuj-an/devpool-restaurants/tree/main/frontend/app"
click node_screens "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/screens/screens.tsx"
click node_pagecomponents "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/pages/pages.tsx"
click node_restaurantform "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/app/restaurant-form.tsx"
click node_queries "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/queries.ts"
click node_apiclient "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/api-client.ts"
click node_types "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/types.ts"
click node_authform "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/app/auth-form.tsx"
click node_auth "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/auth/service/auth_service.go"
click node_googleauth "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/auth/google_handler.go"
click node_admin "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/admin/service/admin_service.go"
click node_profile "https://github.com/nopparuj-an/devpool-restaurants/tree/main/backend/internal/profile"
click node_restaurants "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/restaurant/service/restaurant_service.go"
click node_bookingrules "https://github.com/nopparuj-an/devpool-restaurants/tree/main/backend/internal/booking"
click node_reservations "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/reservation/service/reservation_service.go"
click node_reviews "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/review/service/review_service.go"
click node_imageproc "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/platform/imageproc/imageproc.go"
click node_storage "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/platform/storage/storage.go"
click node_server "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/server/server.go"
click node_postgres "https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/platform/database/database.go"
click node_galleryroute "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/page.tsx"
click node_designnav "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/nav.tsx"
click node_gallery "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/gallery.tsx"
click node_registry "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/registry.tsx"
click node_screenlist "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/screen-list.ts"
click node_mockdata "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/mock.ts"
click node_designframe "https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/frame.tsx"

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_webpages,node_screens,node_pagecomponents,node_restaurantform,node_queries,node_apiclient,node_types toneBlue
class node_restaurants,node_bookingrules,node_reservations,node_reviews,node_imageproc,node_s3 toneAmber
class node_authform,node_auth,node_googleauth,node_admin,node_profile toneMint
class node_storage,node_server,node_postgres toneRose
class node_galleryroute,node_designnav,node_gallery,node_registry,node_screenlist,node_mockdata,node_designframe,node_people toneIndigo
```

## Components

### Web application

- [App routes](https://github.com/nopparuj-an/devpool-restaurants/tree/main/frontend/app): `frontend/app`
- [Product screens](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/screens/screens.tsx): `frontend/components/screens/screens.tsx`
- [Page components](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/pages/pages.tsx): `frontend/components/pages/pages.tsx`
- [Restaurant editor](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/app/restaurant-form.tsx): `frontend/components/app/restaurant-form.tsx`
- [Query hooks](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/queries.ts): `frontend/lib/queries.ts`
- [API client](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/api-client.ts): `frontend/lib/api-client.ts`
- [API data types](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/types.ts): `frontend/lib/types.ts`

### Restaurant domain

- [Restaurant listings](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/restaurant/service/restaurant_service.go): `backend/internal/restaurant/service/restaurant_service.go`
- [Booking rules](https://github.com/nopparuj-an/devpool-restaurants/tree/main/backend/internal/booking): `backend/internal/booking`
- [Reservations](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/reservation/service/reservation_service.go): `backend/internal/reservation/service/reservation_service.go`
- [Reviews](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/review/service/review_service.go): `backend/internal/review/service/review_service.go`
- [Image processing](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/platform/imageproc/imageproc.go): `backend/internal/platform/imageproc/imageproc.go`

### Identity and moderation

- [Login and signup](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/components/app/auth-form.tsx): `frontend/components/app/auth-form.tsx`
- [Authentication](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/auth/service/auth_service.go): `backend/internal/auth/service/auth_service.go`
- [Google login](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/auth/google_handler.go): `backend/internal/auth/google_handler.go`
- [Admin moderation](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/admin/service/admin_service.go): `backend/internal/admin/service/admin_service.go`
- [Public profiles](https://github.com/nopparuj-an/devpool-restaurants/tree/main/backend/internal/profile): `backend/internal/profile`

### API runtime and persistence

- [Image object storage](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/platform/storage/storage.go): `backend/internal/platform/storage/storage.go`
- [HTTP server](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/server/server.go): `backend/internal/server/server.go`
- [PostgreSQL](https://github.com/nopparuj-an/devpool-restaurants/blob/main/backend/internal/platform/database/database.go): `backend/internal/platform/database/database.go`

### Design gallery

- [Design routes](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/page.tsx): `frontend/app/design/page.tsx`
- [Gallery navigation](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/nav.tsx): `frontend/app/design/nav.tsx`
- [Components gallery](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/gallery.tsx): `frontend/app/design/gallery.tsx`
- [Screen registry](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/registry.tsx): `frontend/app/design/registry.tsx`
- [Gallery screen list](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/screen-list.ts): `frontend/app/design/screen-list.ts`
- [Preview mock data](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/lib/mock.ts): `frontend/lib/mock.ts`
- [Responsive frame](https://github.com/nopparuj-an/devpool-restaurants/blob/main/frontend/app/design/frame.tsx): `frontend/app/design/frame.tsx`

### Other components

- **Diners, owners, admins**
- **Garage S3 storage**

## Connections

- Diners, owners, admins → App routes: uses
- App routes → Product screens: renders
- Product screens → Page components: uses
- Product screens → Query hooks: reads through
- Page components → Query hooks: reads through
- Restaurant editor → Query hooks: submits through
- Login and signup → Query hooks: submits through
- Query hooks → API client: fetches with (evidence: `frontend/lib/queries.ts`)
- API client → HTTP server: HTTP requests (evidence: `frontend/lib/api-client.ts`)
- Diners, owners, admins → Login and signup: signs in
- HTTP server → Authentication: routes requests
- HTTP server → Admin moderation: routes requests
- HTTP server → Public profiles: routes requests
- HTTP server → Restaurant listings: routes requests
- HTTP server → Reservations: routes requests
- HTTP server → Reviews: routes requests
- Google login → Authentication: supports login
- Diners, owners, admins → Restaurant listings: discovers listings
- Diners, owners, admins → Reservations: books tables
- Diners, owners, admins → Reviews: writes reviews
- Diners, owners, admins → Admin moderation: moderates
- Reservations → Booking rules: applies rules
- Restaurant listings → Image processing: processes images
- Image processing → Image object storage: stores images
- Image object storage → Garage S3 storage: S3 operations
- HTTP server → PostgreSQL: database access
- Design routes → Gallery navigation: renders (evidence: `frontend/app/design/page.tsx`)
- Design routes → Components gallery: renders (evidence: `frontend/app/design/page.tsx`)
- Design routes → Gallery screen list: lists screens (evidence: `frontend/app/design/page.tsx`)
- Design routes → Responsive frame: frames previews (evidence: `frontend/app/design/page.tsx`)
- Components gallery → Preview mock data: uses previews (evidence: `frontend/app/design/gallery.tsx`)
- Components gallery → Screen registry: shows components (evidence: `frontend/app/design/gallery.tsx`)
- Screen registry → Preview mock data: renders mock data
- Screen registry → Product screens: renders screens (evidence: `frontend/app/design/registry.tsx`)
- Gallery navigation → Gallery screen list: reads sections (evidence: `frontend/app/design/nav.tsx`)
- Components gallery → API data types: uses data shapes
