# someone1305/buildy architecture

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

- Interactive diagram: https://gitdiagram.com/someone1305/buildy
- Repository: https://github.com/someone1305/buildy

## Overview

Qurilish-uz is a multi-portal construction marketplace: clients discover products and workers, place orders or request jobs, suppliers manage catalog and fulfillment, and administrators oversee users and verification. The server exposes domain APIs for these workflows, with authentication and role-based access across them. Separate product, order, delivery, and worker/job stages are retained rather than collapsed into one marketplace node; chat, ratings, and administration are additional capabilities. The README is empty, and most source excerpts are partial, so frontend-to-endpoint and service-to-storage links are not asserted where wiring was not shown.

Main entry points: [`apps/client/app`](https://github.com/someone1305/buildy/tree/main/apps/client/app) (Client marketplace), [`server/src/database/database.module.ts`](https://github.com/someone1305/buildy/blob/main/server/src/database/database.module.ts) (Application database), [`apps/supplier/app`](https://github.com/someone1305/buildy/tree/main/apps/supplier/app) (Supplier portal), [`server/src/modules/products/products.controller.ts`](https://github.com/someone1305/buildy/blob/main/server/src/modules/products/products.controller.ts) (Product catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["User portals"]
  node_client["Client marketplace"]
  node_supplier["Supplier portal"]
  node_admin["Admin console"]
end

subgraph group_commerce["Product commerce"]
  node_catalog["Product catalog"]
  node_categories["Product categories"]
  node_cart["Cart and favorites<br/>[cart.controller.ts]"]
  node_orders["Order management"]
  node_ratings["Reviews and ratings"]
end

subgraph group_fulfillment["Fulfillment"]
  node_delivery["Delivery operations"]
  node_supplier_domain["Supplier accounts"]
end

subgraph group_work["Worker services"]
  node_worker_domain["Worker directory"]
  node_job_requests["Job requests"]
  node_chat["Chat and messaging<br/>[chat.controller.ts]"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_verification["Verification review"]
  node_users["User profiles"]
  node_storage["File storage<br/>[storage.service.ts]"]
  node_database[("Application database<br/>[database.module.ts]")]
end

node_clients(("Clients"))
node_suppliers(("Suppliers"))
node_workers(("Workers"))
node_admins(("Administrators"))

node_clients -->|"browse and order"| node_client
node_suppliers -->|"manage business"| node_supplier
node_admins -->|"administer marketplace"| node_admin
node_workers -->|"find and request work"| node_client
node_supplier -->|"manage orders"| node_orders
node_client -->|"browse catalog"| node_catalog
node_client -->|"browse categories"| node_categories
node_client -->|"manage cart"| node_cart
node_client -->|"place orders"| node_orders
node_client -->|"browse workers"| node_worker_domain
node_client -->|"request work"| node_job_requests
node_client -->|"review services"| node_ratings
node_supplier -->|"manage products"| node_catalog
node_supplier -->|"manage delivery"| node_delivery
node_workers -->|"respond to requests"| node_job_requests
node_workers -->|"submit documents"| node_verification
node_admins -->|"review submissions"| node_verification
node_admins -->|"manage users"| node_users
node_admins -->|"maintain categories"| node_categories
node_catalog -->|"reads and writes"| node_database
node_categories -->|"reads and writes"| node_database
node_orders -->|"reads and writes"| node_database
node_delivery -->|"reads and writes"| node_database
node_job_requests -->|"reads and writes"| node_database
node_chat -->|"reads and writes"| node_database
node_verification -->|"uploads documents"| node_storage
node_chat -->|"handles attachments"| node_storage
node_auth -->|"uses account data"| node_database
node_users -->|"uses profile data"| node_database
node_ratings -->|"reads and writes"| node_database

click node_client "https://github.com/someone1305/buildy/tree/main/apps/client/app"
click node_supplier "https://github.com/someone1305/buildy/tree/main/apps/supplier/app"
click node_admin "https://github.com/someone1305/buildy/tree/main/apps/admin/src"
click node_catalog "https://github.com/someone1305/buildy/blob/main/server/src/modules/products/products.controller.ts"
click node_categories "https://github.com/someone1305/buildy/blob/main/server/src/modules/categories/categories.controller.ts"
click node_cart "https://github.com/someone1305/buildy/blob/main/server/src/modules/cart/cart.controller.ts"
click node_orders "https://github.com/someone1305/buildy/blob/main/server/src/modules/orders/orders.controller.ts"
click node_ratings "https://github.com/someone1305/buildy/blob/main/server/src/modules/ratings/ratings.controller.ts"
click node_delivery "https://github.com/someone1305/buildy/blob/main/server/src/modules/delivery/delivery.controller.ts"
click node_supplier_domain "https://github.com/someone1305/buildy/blob/main/server/src/modules/suppliers/suppliers.controller.ts"
click node_worker_domain "https://github.com/someone1305/buildy/blob/main/server/src/modules/workers/workers.controller.ts"
click node_job_requests "https://github.com/someone1305/buildy/blob/main/server/src/modules/job-requests/job-requests.controller.ts"
click node_chat "https://github.com/someone1305/buildy/blob/main/server/src/modules/chat/chat.controller.ts"
click node_auth "https://github.com/someone1305/buildy/blob/main/server/src/modules/auth/auth.service.ts"
click node_verification "https://github.com/someone1305/buildy/blob/main/server/src/modules/verifications/verifications.controller.ts"
click node_users "https://github.com/someone1305/buildy/blob/main/server/src/modules/users/users.controller.ts"
click node_storage "https://github.com/someone1305/buildy/blob/main/server/src/providers/storage/storage.service.ts"
click node_database "https://github.com/someone1305/buildy/blob/main/server/src/database/database.module.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_client,node_supplier,node_admin,node_clients toneBlue
class node_catalog,node_categories,node_cart,node_orders,node_ratings toneAmber
class node_delivery,node_supplier_domain toneMint
class node_worker_domain,node_job_requests,node_chat,node_workers toneRose
class node_auth,node_verification,node_users,node_storage,node_database,node_suppliers,node_admins toneIndigo
```

## Components

### User portals

- [Client marketplace](https://github.com/someone1305/buildy/tree/main/apps/client/app): `apps/client/app`
- [Supplier portal](https://github.com/someone1305/buildy/tree/main/apps/supplier/app): `apps/supplier/app`
- [Admin console](https://github.com/someone1305/buildy/tree/main/apps/admin/src): `apps/admin/src`

### Product commerce

- [Product catalog](https://github.com/someone1305/buildy/blob/main/server/src/modules/products/products.controller.ts): `server/src/modules/products/products.controller.ts`
- [Product categories](https://github.com/someone1305/buildy/blob/main/server/src/modules/categories/categories.controller.ts): `server/src/modules/categories/categories.controller.ts`
- [Cart and favorites](https://github.com/someone1305/buildy/blob/main/server/src/modules/cart/cart.controller.ts): `server/src/modules/cart/cart.controller.ts`
- [Order management](https://github.com/someone1305/buildy/blob/main/server/src/modules/orders/orders.controller.ts): `server/src/modules/orders/orders.controller.ts`
- [Reviews and ratings](https://github.com/someone1305/buildy/blob/main/server/src/modules/ratings/ratings.controller.ts): `server/src/modules/ratings/ratings.controller.ts`

### Fulfillment

- [Delivery operations](https://github.com/someone1305/buildy/blob/main/server/src/modules/delivery/delivery.controller.ts): `server/src/modules/delivery/delivery.controller.ts`
- [Supplier accounts](https://github.com/someone1305/buildy/blob/main/server/src/modules/suppliers/suppliers.controller.ts): `server/src/modules/suppliers/suppliers.controller.ts`

### Worker services

- [Worker directory](https://github.com/someone1305/buildy/blob/main/server/src/modules/workers/workers.controller.ts): `server/src/modules/workers/workers.controller.ts`
- [Job requests](https://github.com/someone1305/buildy/blob/main/server/src/modules/job-requests/job-requests.controller.ts): `server/src/modules/job-requests/job-requests.controller.ts`
- [Chat and messaging](https://github.com/someone1305/buildy/blob/main/server/src/modules/chat/chat.controller.ts): `server/src/modules/chat/chat.controller.ts`

### Platform services

- [Authentication](https://github.com/someone1305/buildy/blob/main/server/src/modules/auth/auth.service.ts): `server/src/modules/auth/auth.service.ts`
- [Verification review](https://github.com/someone1305/buildy/blob/main/server/src/modules/verifications/verifications.controller.ts): `server/src/modules/verifications/verifications.controller.ts`
- [User profiles](https://github.com/someone1305/buildy/blob/main/server/src/modules/users/users.controller.ts): `server/src/modules/users/users.controller.ts`
- [File storage](https://github.com/someone1305/buildy/blob/main/server/src/providers/storage/storage.service.ts): `server/src/providers/storage/storage.service.ts`
- [Application database](https://github.com/someone1305/buildy/blob/main/server/src/database/database.module.ts): `server/src/database/database.module.ts`

### Other components

- **Clients**
- **Suppliers**
- **Workers**
- **Administrators**

## Connections

- Clients → Client marketplace: browse and order
- Suppliers → Supplier portal: manage business
- Administrators → Admin console: administer marketplace
- Workers → Client marketplace: find and request work
- Supplier portal → Order management: manage orders
- Client marketplace → Product catalog: browse catalog
- Client marketplace → Product categories: browse categories
- Client marketplace → Cart and favorites: manage cart
- Client marketplace → Order management: place orders
- Client marketplace → Worker directory: browse workers
- Client marketplace → Job requests: request work
- Client marketplace → Reviews and ratings: review services
- Supplier portal → Product catalog: manage products
- Supplier portal → Delivery operations: manage delivery
- Workers → Job requests: respond to requests
- Workers → Verification review: submit documents
- Administrators → Verification review: review submissions
- Administrators → User profiles: manage users
- Administrators → Product categories: maintain categories
- Product catalog → Application database: reads and writes
- Product categories → Application database: reads and writes
- Order management → Application database: reads and writes
- Delivery operations → Application database: reads and writes
- Job requests → Application database: reads and writes
- Chat and messaging → Application database: reads and writes
- Verification review → File storage: uploads documents
- Chat and messaging → File storage: handles attachments
- Authentication → Application database: uses account data
- User profiles → Application database: uses profile data
- Reviews and ratings → Application database: reads and writes