# shamiulriyad/shilpohubbd architecture

> Architecture diagram of the GitHub repository shamiulriyad/shilpohubbd, 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/shamiulriyad/shilpohubbd
- Repository: https://github.com/shamiulriyad/shilpohubbd

## Overview

ShilpoHubBD is a marketplace and business platform connecting Bangladeshi heritage artisans with customers. The primary workflow is customers discovering artisan products and using marketplace and commerce features; producers also manage orders and business operations. The README documents learning, heritage, community, and tourism capabilities. Sampled source confirms controller-to-service calls for reviews and enrollments, plus database querying in product search; unsampled module wiring is intentionally not inferred.

Main entry points: [`frontend`](https://github.com/shamiulriyad/shilpohubbd/tree/main/frontend) (React app), [`backend/src/ShilpoHubBD.Api/Controllers/ReviewsController.cs`](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ReviewsController.cs) (Reviews), [`backend/src/ShilpoHubBD.Data/Repositories/ProductSearchQueryRepository.cs`](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Data/Repositories/ProductSearchQueryRepository.cs) (Product search), [`backend/src/ShilpoHubBD.Api/Controllers/EnrollmentsController.cs`](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/EnrollmentsController.cs) (Learning enrollment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Customer Experience"]
  node_frontend["React app"]
  node_reviews["Reviews"]
  node_community["Community features"]
end

subgraph group_commerce["Marketplace Commerce"]
  node_catalog["Product catalog"]
  node_search["Product search"]
  node_cart["Cart and orders<br/>[CartController.cs]"]
  node_payments["Payments"]
  node_reviewservice["Review service<br/>[ReviewService.cs]"]
end

subgraph group_producer["Producer Tools"]
  node_producerorders["Producer orders"]
  node_businessassistant["AI business tools"]
end

subgraph group_heritage["Heritage Learning"]
  node_courses["Learning enrollment"]
  node_enrollmentservice["Enrollment service"]
  node_apprenticeship["Apprenticeship"]
  node_heritage["Heritage and tourism"]
end

subgraph group_platform["Platform Services"]
  node_api["Web API<br/>[ShilpoHubBD.Api]"]
  node_auth["Authentication<br/>[AuthController.cs]"]
  node_realtime["Realtime messaging<br/>[MessagingHub.cs]"]
  node_database[("PostgreSQL")]
  node_storage[("Supabase Storage")]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_frontend
node_frontend -->|"API requests"| node_api
node_reviews -->|"calls"| node_reviewservice
node_courses -->|"calls"| node_enrollmentservice
node_search -->|"queries"| node_database

click node_frontend "https://github.com/shamiulriyad/shilpohubbd/tree/main/frontend"
click node_api "https://github.com/shamiulriyad/shilpohubbd/tree/main/backend/src/ShilpoHubBD.Api"
click node_auth "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/AuthController.cs"
click node_catalog "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ProductsController.cs"
click node_search "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Data/Repositories/ProductSearchQueryRepository.cs"
click node_cart "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/CartController.cs"
click node_payments "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/PaymentsController.cs"
click node_reviews "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ReviewsController.cs"
click node_reviewservice "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Application/Services/Reviews/ReviewService.cs"
click node_producerorders "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ProducerOrdersController.cs"
click node_businessassistant "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/AIBusinessAssistantController.cs"
click node_courses "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/EnrollmentsController.cs"
click node_enrollmentservice "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Application/Services/Learning/EnrollmentService.cs"
click node_apprenticeship "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ApprenticeEnrollmentsController.cs"
click node_heritage "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/HeritagePlacesController.cs"
click node_community "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/DiscussionsController.cs"
click node_realtime "https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Hubs/MessagingHub.cs"

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_frontend,node_reviews,node_community toneBlue
class node_catalog,node_search,node_cart,node_payments,node_reviewservice toneAmber
class node_producerorders,node_businessassistant toneMint
class node_courses,node_enrollmentservice,node_apprenticeship,node_heritage toneRose
class node_api,node_auth,node_realtime,node_database,node_storage,node_customer toneIndigo
```

## Components

### Customer Experience

- [React app](https://github.com/shamiulriyad/shilpohubbd/tree/main/frontend): `frontend`
- [Reviews](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ReviewsController.cs): `backend/src/ShilpoHubBD.Api/Controllers/ReviewsController.cs`
- [Community features](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/DiscussionsController.cs): `backend/src/ShilpoHubBD.Api/Controllers/DiscussionsController.cs`

### Marketplace Commerce

- [Product catalog](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ProductsController.cs): `backend/src/ShilpoHubBD.Api/Controllers/ProductsController.cs`
- [Product search](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Data/Repositories/ProductSearchQueryRepository.cs): `backend/src/ShilpoHubBD.Data/Repositories/ProductSearchQueryRepository.cs`
- [Cart and orders](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/CartController.cs): `backend/src/ShilpoHubBD.Api/Controllers/CartController.cs`
- [Payments](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/PaymentsController.cs): `backend/src/ShilpoHubBD.Api/Controllers/PaymentsController.cs`
- [Review service](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Application/Services/Reviews/ReviewService.cs): `backend/src/ShilpoHubBD.Application/Services/Reviews/ReviewService.cs`

### Producer Tools

- [Producer orders](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ProducerOrdersController.cs): `backend/src/ShilpoHubBD.Api/Controllers/ProducerOrdersController.cs`
- [AI business tools](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/AIBusinessAssistantController.cs): `backend/src/ShilpoHubBD.Api/Controllers/AIBusinessAssistantController.cs`

### Heritage Learning

- [Learning enrollment](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/EnrollmentsController.cs): `backend/src/ShilpoHubBD.Api/Controllers/EnrollmentsController.cs`
- [Enrollment service](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Application/Services/Learning/EnrollmentService.cs): `backend/src/ShilpoHubBD.Application/Services/Learning/EnrollmentService.cs`
- [Apprenticeship](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/ApprenticeEnrollmentsController.cs): `backend/src/ShilpoHubBD.Api/Controllers/ApprenticeEnrollmentsController.cs`
- [Heritage and tourism](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/HeritagePlacesController.cs): `backend/src/ShilpoHubBD.Api/Controllers/HeritagePlacesController.cs`

### Platform Services

- [Web API](https://github.com/shamiulriyad/shilpohubbd/tree/main/backend/src/ShilpoHubBD.Api): `backend/src/ShilpoHubBD.Api`
- [Authentication](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Controllers/AuthController.cs): `backend/src/ShilpoHubBD.Api/Controllers/AuthController.cs`
- [Realtime messaging](https://github.com/shamiulriyad/shilpohubbd/blob/main/backend/src/ShilpoHubBD.Api/Hubs/MessagingHub.cs): `backend/src/ShilpoHubBD.Api/Hubs/MessagingHub.cs`
- **PostgreSQL**
- **Supabase Storage**

### Other components

- **Customer**

## Connections

- Customer → React app: uses
- React app → Web API: API requests
- Reviews → Review service: calls
- Learning enrollment → Enrollment service: calls
- Product search → PostgreSQL: queries