# basilbarakat15/pc-builder-websit- architecture

> Architecture diagram of the GitHub repository basilbarakat15/pc-builder-websit-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/basilbarakat15/pc-builder-websit-
- Repository: https://github.com/basilbarakat15/pc-builder-websit-

## Overview

PC Architect is a web-based custom PC configurator with component selection, compatibility guidance, AI assistance, and commerce/account features. The main user path is selecting hardware, checking compatibility, managing a cart, and placing an order. The graph also preserves documented AI, catalog, and administration capabilities. Several frontend/API connections and the Node server’s runtime wiring are not shown in the supplied excerpts, so those links are omitted rather than inferred.

Main entry points: [`PC-Builder-websit-FIXED-v3/api/helpers.php`](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/helpers.php) (API helpers), [`PC-Builder-websit-FIXED-v3/Js/Build.js`](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/Build.js) (Build workspace), [`PC-Builder-websit-FIXED-v3/api/config.php`](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/config.php) (Database config), [`PC-Builder-websit-FIXED-v3/api/products`](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/products) (Product API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["PC building"]
  node_build_ui["Build workspace<br/>[Build.js]"]
  node_parts["Component selectors"]
  node_compat_ui["Compatibility checker<br/>[compatibility.js]"]
  node_ai_ui["AI assistant<br/>[ai-chat.js]"]
  node_recommend_ui["AI recommendations<br/>[ai-recommend.js]"]
end

subgraph group_commerce["Shopping and orders"]
  node_cart_ui["Cart<br/>[Cart.js]"]
  node_checkout_ui["Checkout<br/>[checkout.js]"]
  node_product_sync["Product sync<br/>[products-sync.js]"]
end

subgraph group_accounts["Accounts and administration"]
  node_account_ui["Account flows<br/>[login.js]"]
  node_profile_ui["Profile<br/>[profile.js]"]
  node_admin_ui["Admin console<br/>[admin.js]"]
end

subgraph group_services["Backend services"]
  node_catalog_api["Product API"]
  node_compat_api["Compatibility API<br/>[compatibility.php]"]
  node_ai_api["AI endpoints"]
  node_auth_api["Authentication API"]
  node_orders_api["Order API<br/>[place.php]"]
  node_wishlist_api["Wishlist API"]
  node_coupons_api["Coupon API"]
  node_admin_api["Admin APIs"]
  node_helpers["API helpers<br/>[helpers.php]"]
  node_config[("Database config<br/>[config.php]")]
  node_node_server["Node AI server<br/>[server.js]"]
end

node_user(("PC builder"))

node_user -->|"configures PC"| node_build_ui
node_build_ui -->|"selects parts"| node_parts
node_user -->|"checks fit"| node_compat_ui
node_user -->|"asks advice"| node_ai_ui
node_user -->|"requests suggestions"| node_recommend_ui
node_user -->|"shops"| node_cart_ui
node_user -->|"places order"| node_checkout_ui
node_user -->|"signs in"| node_account_ui
node_user -->|"updates profile"| node_profile_ui
node_user -->|"administers store"| node_admin_ui
node_helpers -->|"loads config"| node_config
node_orders_api -->|"reads and writes"| node_config
node_catalog_api -->|"uses helpers"| node_helpers
node_auth_api -->|"uses helpers"| node_helpers
node_wishlist_api -->|"uses helpers"| node_helpers
node_coupons_api -->|"uses helpers"| node_helpers
node_admin_api -->|"uses helpers"| node_helpers

click node_build_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/Build.js"
click node_parts "https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/Js"
click node_compat_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/compatibility.js"
click node_ai_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/ai-chat.js"
click node_recommend_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/ai-recommend.js"
click node_cart_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/Cart.js"
click node_checkout_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/checkout.js"
click node_product_sync "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/products-sync.js"
click node_account_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/login.js"
click node_profile_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/profile.js"
click node_admin_ui "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/admin/admin.js"
click node_catalog_api "https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/products"
click node_compat_api "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/compatibility.php"
click node_ai_api "https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api"
click node_auth_api "https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/auth"
click node_orders_api "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/orders/place.php"
click node_wishlist_api "https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/wishlist"
click node_coupons_api "https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/coupons"
click node_admin_api "https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/users"
click node_helpers "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/helpers.php"
click node_config "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/config.php"
click node_node_server "https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/server/server.js"

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_build_ui,node_parts,node_compat_ui,node_ai_ui,node_recommend_ui toneBlue
class node_cart_ui,node_checkout_ui,node_product_sync toneAmber
class node_account_ui,node_profile_ui,node_admin_ui toneMint
class node_catalog_api,node_compat_api,node_ai_api,node_auth_api,node_orders_api,node_wishlist_api,node_coupons_api,node_admin_api,node_helpers,node_config,node_node_server toneRose
class node_user toneIndigo
```

## Components

### PC building

- [Build workspace](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/Build.js): `PC-Builder-websit-FIXED-v3/Js/Build.js`
- [Component selectors](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/Js): `PC-Builder-websit-FIXED-v3/Js`
- [Compatibility checker](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/compatibility.js): `PC-Builder-websit-FIXED-v3/Js/compatibility.js`
- [AI assistant](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/ai-chat.js): `PC-Builder-websit-FIXED-v3/Js/ai-chat.js`
- [AI recommendations](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/ai-recommend.js): `PC-Builder-websit-FIXED-v3/Js/ai-recommend.js`

### Shopping and orders

- [Cart](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/Cart.js): `PC-Builder-websit-FIXED-v3/Js/Cart.js`
- [Checkout](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/checkout.js): `PC-Builder-websit-FIXED-v3/Js/checkout.js`
- [Product sync](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/products-sync.js): `PC-Builder-websit-FIXED-v3/Js/products-sync.js`

### Accounts and administration

- [Account flows](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/login.js): `PC-Builder-websit-FIXED-v3/Js/login.js`
- [Profile](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/Js/profile.js): `PC-Builder-websit-FIXED-v3/Js/profile.js`
- [Admin console](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/admin/admin.js): `PC-Builder-websit-FIXED-v3/admin/admin.js`

### Backend services

- [Product API](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/products): `PC-Builder-websit-FIXED-v3/api/products`
- [Compatibility API](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/compatibility.php): `PC-Builder-websit-FIXED-v3/api/compatibility.php`
- [AI endpoints](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api): `PC-Builder-websit-FIXED-v3/api`
- [Authentication API](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/auth): `PC-Builder-websit-FIXED-v3/api/auth`
- [Order API](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/orders/place.php): `PC-Builder-websit-FIXED-v3/api/orders/place.php`
- [Wishlist API](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/wishlist): `PC-Builder-websit-FIXED-v3/api/wishlist`
- [Coupon API](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/coupons): `PC-Builder-websit-FIXED-v3/api/coupons`
- [Admin APIs](https://github.com/basilbarakat15/pc-builder-websit-/tree/main/PC-Builder-websit-FIXED-v3/api/users): `PC-Builder-websit-FIXED-v3/api/users`
- [API helpers](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/helpers.php): `PC-Builder-websit-FIXED-v3/api/helpers.php`
- [Database config](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/api/config.php): `PC-Builder-websit-FIXED-v3/api/config.php`
- [Node AI server](https://github.com/basilbarakat15/pc-builder-websit-/blob/main/PC-Builder-websit-FIXED-v3/server/server.js): `PC-Builder-websit-FIXED-v3/server/server.js`

### Other components

- **PC builder**

## Connections

- PC builder → Build workspace: configures PC
- Build workspace → Component selectors: selects parts
- PC builder → Compatibility checker: checks fit
- PC builder → AI assistant: asks advice
- PC builder → AI recommendations: requests suggestions
- PC builder → Cart: shops
- PC builder → Checkout: places order
- PC builder → Account flows: signs in
- PC builder → Profile: updates profile
- PC builder → Admin console: administers store
- API helpers → Database config: loads config (evidence: `PC-Builder-websit-FIXED-v3/api/helpers.php`)
- Order API → Database config: reads and writes (evidence: `PC-Builder-websit-FIXED-v3/api/orders/place.php`)
- Product API → API helpers: uses helpers (evidence: `PC-Builder-websit-FIXED-v3/api/products/add.php`)
- Authentication API → API helpers: uses helpers (evidence: `PC-Builder-websit-FIXED-v3/api/auth/login.php`)
- Wishlist API → API helpers: uses helpers (evidence: `PC-Builder-websit-FIXED-v3/api/wishlist/add.php`)
- Coupon API → API helpers: uses helpers (evidence: `PC-Builder-websit-FIXED-v3/api/coupons/add.php`)
- Admin APIs → API helpers: uses helpers (evidence: `PC-Builder-websit-FIXED-v3/api/users/delete.php`)
