# shakibul-islam-dev/trustpass_client architecture

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

- Interactive diagram: https://gitdiagram.com/shakibul-islam-dev/trustpass_client
- Repository: https://github.com/shakibul-islam-dev/trustpass_client

## Overview

TrustPass is a web client for discovering businesses and products, inspecting business trust information, and supporting customer, moderator, and administrator workflows. The visible business search and detail pages use local catalog data; authentication has a Better Auth server handler. The tree documents report, verification, trust-rule, and user-management screens, but sampled source does not establish their data services or most page-to-component wiring, so those connections are not inferred.

Main entry points: [`components/marketplace/SearchHero.tsx`](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/marketplace/SearchHero.tsx) (Search filters), [`lib/auth.ts`](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/lib/auth.ts) (Auth configuration), [`app/businessesExplore/page.tsx`](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/businessesExplore/page.tsx) (Business search), [`app/products/page.tsx`](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/products/page.tsx) (Product catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Marketplace"]
  node_business_search["Business search<br/>[page.tsx]"]
  node_business_detail["Business profile<br/>[page.tsx]"]
  node_search_hero["Search filters<br/>[SearchHero.tsx]"]
  node_products["Product catalog<br/>[page.tsx]"]
  node_product_detail["Product detail<br/>[page.tsx]"]
end

subgraph group_identity["Authentication"]
  node_login["Login page<br/>[page.tsx]"]
  node_register["Registration page<br/>[page.tsx]"]
  node_login_form["Login form<br/>[LoginForm.tsx]"]
  node_registration_form["Registration form"]
end

subgraph group_customer["Customer tools"]
  node_customer_dashboard["Customer dashboard<br/>[page.tsx]"]
  node_customer_reports["Customer reports<br/>[page.tsx]"]
  node_customer_notifications["Notifications<br/>[page.tsx]"]
  node_notification_hook["Notification state"]
end

subgraph group_operations["Trust operations"]
  node_moderator_dashboard["Moderator dashboard<br/>[page.tsx]"]
  node_moderator_reports["Report review<br/>[page.tsx]"]
  node_verification_queue["Verification queue<br/>[page.tsx]"]
  node_trust_rules["Trust rules<br/>[page.tsx]"]
  node_score_breakdown["Score breakdown"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_businesses["Business management<br/>[page.tsx]"]
  node_admin_reports["Report oversight<br/>[page.tsx]"]
  node_admin_users["User management<br/>[page.tsx]"]
  node_admin_verification["Verification oversight<br/>[page.tsx]"]
  node_admin_rules["Rule management<br/>[page.tsx]"]
end

subgraph group_foundation["Auth runtime"]
  node_auth_api["Auth endpoint<br/>[route.ts]"]
  node_auth_config["Auth configuration<br/>[auth.ts]"]
  node_auth_client["Auth client<br/>[auth-client.ts]"]
end

node_visitor(("Visitor"))
node_customer_actor(("Customer"))
node_moderator_actor(("Moderator"))
node_admin_actor(("Administrator"))
node_better_auth["Better Auth"]
node_categories_api["Category API"]
node_social_providers["Google / Facebook"]

node_visitor -->|"opens directory"| node_business_search
node_business_search -->|"opens profile"| node_business_detail
node_visitor -->|"searches businesses"| node_search_hero
node_search_hero -->|"routes filters"| node_business_search
node_search_hero -->|"fetches categories"| node_categories_api
node_visitor -->|"browses catalog"| node_products
node_products -->|"opens product"| node_product_detail
node_visitor -->|"opens sign-in"| node_login
node_visitor -->|"opens registration"| node_register
node_login -->|"renders form"| node_login_form
node_register -->|"renders form"| node_registration_form
node_customer_actor -->|"opens dashboard"| node_customer_dashboard
node_customer_actor -->|"views reports"| node_customer_reports
node_customer_actor -->|"views notifications"| node_customer_notifications
node_customer_notifications -->|"uses notification state"| node_notification_hook
node_moderator_actor -->|"opens dashboard"| node_moderator_dashboard
node_moderator_actor -->|"reviews reports"| node_moderator_reports
node_moderator_actor -->|"reviews verification"| node_verification_queue
node_moderator_actor -->|"manages rules"| node_trust_rules
node_trust_rules -->|"opens score details"| node_score_breakdown
node_admin_actor -->|"opens dashboard"| node_admin_dashboard
node_admin_actor -->|"manages businesses"| node_admin_businesses
node_admin_actor -->|"oversees reports"| node_admin_reports
node_admin_actor -->|"manages users"| node_admin_users
node_admin_actor -->|"oversees verification"| node_admin_verification
node_admin_actor -->|"manages rules"| node_admin_rules
node_auth_api -->|"dispatches handlers"| node_auth_config
node_auth_config -->|"configures runtime"| node_better_auth
node_auth_client -->|"creates client"| node_better_auth
node_auth_config -.->|"supports sign-in"| node_social_providers

click node_business_search "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/businessesExplore/page.tsx"
click node_business_detail "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/businesses/%5Bid%5D/page.tsx"
click node_search_hero "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/marketplace/SearchHero.tsx"
click node_products "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/products/page.tsx"
click node_product_detail "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/products/%5Bslug%5D/page.tsx"
click node_login "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/auth/login/page.tsx"
click node_register "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/auth/register/page.tsx"
click node_login_form "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/auth/LoginForm.tsx"
click node_registration_form "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/auth/RegistrationForm.tsx"
click node_customer_dashboard "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/customer/page.tsx"
click node_customer_reports "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/customer/reports/page.tsx"
click node_customer_notifications "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/customer/notifications/page.tsx"
click node_notification_hook "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/hooks/useNotifications.ts"
click node_moderator_dashboard "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/page.tsx"
click node_moderator_reports "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/reports/page.tsx"
click node_verification_queue "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/verification-queue/page.tsx"
click node_trust_rules "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/trust-rules/page.tsx"
click node_score_breakdown "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/moderator/ScoreBreakdownModal.tsx"
click node_admin_dashboard "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/page.tsx"
click node_admin_businesses "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/businesses/page.tsx"
click node_admin_reports "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/reports/page.tsx"
click node_admin_users "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/user-management/page.tsx"
click node_admin_verification "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/verification-queue/page.tsx"
click node_admin_rules "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/trust-rules/page.tsx"
click node_auth_api "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/api/auth/%5B...all%5D/route.ts"
click node_auth_config "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/lib/auth.ts"
click node_auth_client "https://github.com/shakibul-islam-dev/trustpass_client/blob/main/lib/auth-client.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_business_search,node_business_detail,node_search_hero,node_products,node_product_detail toneBlue
class node_login,node_register,node_login_form,node_registration_form toneAmber
class node_customer_dashboard,node_customer_reports,node_customer_notifications,node_notification_hook,node_categories_api toneMint
class node_moderator_dashboard,node_moderator_reports,node_verification_queue,node_trust_rules,node_score_breakdown,node_admin_dashboard,node_admin_businesses,node_admin_reports,node_admin_users,node_admin_verification,node_admin_rules toneRose
class node_auth_api,node_auth_config,node_auth_client,node_visitor,node_customer_actor,node_moderator_actor,node_admin_actor,node_better_auth,node_social_providers toneIndigo
```

## Components

### Marketplace

- [Business search](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/businessesExplore/page.tsx): `app/businessesExplore/page.tsx`
- [Business profile](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/businesses/%5Bid%5D/page.tsx): `app/businesses/[id]/page.tsx`
- [Search filters](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/marketplace/SearchHero.tsx): `components/marketplace/SearchHero.tsx`
- [Product catalog](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/products/page.tsx): `app/products/page.tsx`
- [Product detail](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/products/%5Bslug%5D/page.tsx): `app/products/[slug]/page.tsx`

### Authentication

- [Login page](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/auth/login/page.tsx): `app/auth/login/page.tsx`
- [Registration page](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/auth/register/page.tsx): `app/auth/register/page.tsx`
- [Login form](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/auth/LoginForm.tsx): `components/auth/LoginForm.tsx`
- [Registration form](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/auth/RegistrationForm.tsx): `components/auth/RegistrationForm.tsx`

### Customer tools

- [Customer dashboard](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/customer/page.tsx): `app/dashboard/customer/page.tsx`
- [Customer reports](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/customer/reports/page.tsx): `app/dashboard/customer/reports/page.tsx`
- [Notifications](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/customer/notifications/page.tsx): `app/dashboard/customer/notifications/page.tsx`
- [Notification state](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/hooks/useNotifications.ts): `hooks/useNotifications.ts`

### Trust operations

- [Moderator dashboard](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/page.tsx): `app/dashboard/moderator/page.tsx`
- [Report review](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/reports/page.tsx): `app/dashboard/moderator/reports/page.tsx`
- [Verification queue](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/verification-queue/page.tsx): `app/dashboard/moderator/verification-queue/page.tsx`
- [Trust rules](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/moderator/trust-rules/page.tsx): `app/dashboard/moderator/trust-rules/page.tsx`
- [Score breakdown](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/components/moderator/ScoreBreakdownModal.tsx): `components/moderator/ScoreBreakdownModal.tsx`
- [Admin dashboard](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/page.tsx): `app/dashboard/admin/page.tsx`
- [Business management](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/businesses/page.tsx): `app/dashboard/admin/businesses/page.tsx`
- [Report oversight](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/reports/page.tsx): `app/dashboard/admin/reports/page.tsx`
- [User management](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/user-management/page.tsx): `app/dashboard/admin/user-management/page.tsx`
- [Verification oversight](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/verification-queue/page.tsx): `app/dashboard/admin/verification-queue/page.tsx`
- [Rule management](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/dashboard/admin/trust-rules/page.tsx): `app/dashboard/admin/trust-rules/page.tsx`

### Auth runtime

- [Auth endpoint](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/app/api/auth/%5B...all%5D/route.ts): `app/api/auth/[...all]/route.ts`
- [Auth configuration](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/lib/auth.ts): `lib/auth.ts`
- [Auth client](https://github.com/shakibul-islam-dev/trustpass_client/blob/main/lib/auth-client.ts): `lib/auth-client.ts`

### Other components

- **Visitor**
- **Customer**
- **Moderator**
- **Administrator**
- **Better Auth**
- **Category API**
- **Google / Facebook**

## Connections

- Visitor → Business search: opens directory
- Business search → Business profile: opens profile
- Visitor → Search filters: searches businesses
- Search filters → Business search: routes filters
- Search filters → Category API: fetches categories
- Visitor → Product catalog: browses catalog
- Product catalog → Product detail: opens product
- Visitor → Login page: opens sign-in
- Visitor → Registration page: opens registration
- Login page → Login form: renders form
- Registration page → Registration form: renders form
- Customer → Customer dashboard: opens dashboard
- Customer → Customer reports: views reports
- Customer → Notifications: views notifications
- Notifications → Notification state: uses notification state
- Moderator → Moderator dashboard: opens dashboard
- Moderator → Report review: reviews reports
- Moderator → Verification queue: reviews verification
- Moderator → Trust rules: manages rules
- Trust rules → Score breakdown: opens score details
- Administrator → Admin dashboard: opens dashboard
- Administrator → Business management: manages businesses
- Administrator → Report oversight: oversees reports
- Administrator → User management: manages users
- Administrator → Verification oversight: oversees verification
- Administrator → Rule management: manages rules
- Auth endpoint → Auth configuration: dispatches handlers
- Auth configuration → Better Auth: configures runtime
- Auth client → Better Auth: creates client
- Auth configuration → Google / Facebook: supports sign-in