# mihneafeitan/pcbuilds---commercial-website architecture

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

- Interactive diagram: https://gitdiagram.com/mihneafeitan/pcbuilds---commercial-website
- Repository: https://github.com/mihneafeitan/pcbuilds---commercial-website

## Overview

PCBuilds is an Express/EJS storefront for desktop-computer components. A shopper browses the catalog, filters and sorts products, opens product details, and can compare two selected products; the server queries PostgreSQL and serves rendered pages. The README also describes offers, favorites, and a cart, but sampled code explicitly says checkout is not implemented, so these are not presented as verified runtime flows. The account/role classes form a separate user-management layer. Some templates and routes were not sampled, so their internal wiring is omitted.

Main entry points: [`index.js`](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/index.js) (Web application), [`clase/Utilizator.js`](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/Utilizator.js) (User accounts), [`clase/roluri.js`](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/roluri.js) (Role factory), [`views/pagini`](https://github.com/mihneafeitan/pcbuilds---commercial-website/tree/main/views/pagini) (Page templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_webapp["Web application<br/>[index.js]"]
  node_pageviews["Page templates"]
  node_fragments["Shared page fragments"]
end

subgraph group_catalog["Product catalog"]
  node_catalogview["Catalog page<br/>[produse.ejs]"]
  node_productview["Product detail<br/>[produs.ejs]"]
  node_compareview["Comparison page<br/>[comparare.ejs]"]
  node_database[("PostgreSQL products")]
end

subgraph group_browser["Browser features"]
  node_catalogui["Catalog filtering<br/>[produse.js]"]
  node_compareui["Compare selection<br/>[comparare.js]"]
  node_productui["Product interactions<br/>[produs.js]"]
  node_cookieui["Cookie preferences<br/>[cookies.js]"]
  node_themeui["Theme selection<br/>[tema.js]"]
end

subgraph group_accounts["Accounts and access"]
  node_userdomain["User accounts<br/>[Utilizator.js]"]
  node_dbaccess["Database access<br/>[AccesBD.js]"]
  node_roles["Role factory<br/>[roluri.js]"]
  node_permissions["Permission symbols<br/>[drepturi.js]"]
end

node_shopper(("Shopper"))

node_shopper -->|"uses storefront"| node_webapp
node_webapp -->|"queries products"| node_database
node_webapp -->|"renders pages"| node_pageviews
node_webapp -.->|"serves catalog"| node_catalogview
node_webapp -.->|"serves details"| node_productview
node_webapp -.->|"serves comparison"| node_compareview
node_webapp -.->|"uses shared layout"| node_fragments
node_shopper -->|"filters products"| node_catalogui
node_shopper -->|"selects products"| node_compareui
node_shopper -->|"sets consent"| node_cookieui
node_shopper -->|"chooses theme"| node_themeui
node_shopper -->|"uses product page"| node_productui
node_userdomain -->|"queries users"| node_dbaccess
node_userdomain -->|"uses role factory"| node_roles
node_roles -->|"assigns rights"| node_permissions

click node_webapp "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/index.js"
click node_pageviews "https://github.com/mihneafeitan/pcbuilds---commercial-website/tree/main/views/pagini"
click node_fragments "https://github.com/mihneafeitan/pcbuilds---commercial-website/tree/main/views/fragmente"
click node_catalogview "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/views/pagini/produse.ejs"
click node_productview "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/views/pagini/produs.ejs"
click node_compareview "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/views/pagini/comparare.ejs"
click node_catalogui "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/produse.js"
click node_compareui "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/comparare.js"
click node_productui "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/produs.js"
click node_cookieui "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/cookies.js"
click node_themeui "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/tema.js"
click node_userdomain "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/Utilizator.js"
click node_dbaccess "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/AccesBD.js"
click node_roles "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/roluri.js"
click node_permissions "https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/drepturi.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_webapp,node_pageviews,node_fragments toneBlue
class node_catalogview,node_productview,node_compareview,node_database toneAmber
class node_catalogui,node_compareui,node_productui,node_cookieui,node_themeui toneMint
class node_userdomain,node_dbaccess,node_roles,node_permissions toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [Web application](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/index.js): `index.js`
- [Page templates](https://github.com/mihneafeitan/pcbuilds---commercial-website/tree/main/views/pagini): `views/pagini`
- [Shared page fragments](https://github.com/mihneafeitan/pcbuilds---commercial-website/tree/main/views/fragmente): `views/fragmente`

### Product catalog

- [Catalog page](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/views/pagini/produse.ejs): `views/pagini/produse.ejs`
- [Product detail](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/views/pagini/produs.ejs): `views/pagini/produs.ejs`
- [Comparison page](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/views/pagini/comparare.ejs): `views/pagini/comparare.ejs`
- **PostgreSQL products**

### Browser features

- [Catalog filtering](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/produse.js): `resurse/js/produse.js`
- [Compare selection](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/comparare.js): `resurse/js/comparare.js`
- [Product interactions](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/produs.js): `resurse/js/produs.js`
- [Cookie preferences](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/cookies.js): `resurse/js/cookies.js`
- [Theme selection](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/resurse/js/tema.js): `resurse/js/tema.js`

### Accounts and access

- [User accounts](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/Utilizator.js): `clase/Utilizator.js`
- [Database access](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/AccesBD.js): `clase/AccesBD.js`
- [Role factory](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/roluri.js): `clase/roluri.js`
- [Permission symbols](https://github.com/mihneafeitan/pcbuilds---commercial-website/blob/main/clase/drepturi.js): `clase/drepturi.js`

### Other components

- **Shopper**

## Connections

- Shopper → Web application: uses storefront (evidence: `README.md`)
- Web application → PostgreSQL products: queries products (evidence: `index.js`)
- Web application → Page templates: renders pages (evidence: `index.js`)
- Web application → Catalog page: serves catalog
- Web application → Product detail: serves details
- Web application → Comparison page: serves comparison
- Web application → Shared page fragments: uses shared layout
- Shopper → Catalog filtering: filters products (evidence: `README.md`)
- Shopper → Compare selection: selects products (evidence: `README.md`)
- Shopper → Cookie preferences: sets consent (evidence: `resurse/js/cookies.js`)
- Shopper → Theme selection: chooses theme (evidence: `resurse/js/tema.js`)
- Shopper → Product interactions: uses product page (evidence: `resurse/js/produs.js`)
- User accounts → Database access: queries users (evidence: `clase/Utilizator.js`)
- User accounts → Role factory: uses role factory (evidence: `clase/Utilizator.js`)
- Role factory → Permission symbols: assigns rights (evidence: `clase/roluri.js`)
