# swymmm/product-review-and-rating-system architecture

> Architecture diagram of the GitHub repository swymmm/product-review-and-rating-system, 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/swymmm/product-review-and-rating-system
- Repository: https://github.com/swymmm/product-review-and-rating-system

## Overview

This PHP/MySQL product-rating app lets visitors browse products, inspect detail pages, submit one 1–5-star vote per product/IP, and see aggregate ratings. Administrators create an initial account, log in, review ratings, and manage products. The graph separates visitor-facing pages, rating submission, admin workflows, and database access. The README documents the key capabilities; sampled PHP shows the main queries, forms, and calls. JavaScript, schema, and several admin handlers were not inspected, so their internal relationships are not expanded.

Main entry points: [`config/db.php`](https://github.com/swymmm/product-review-and-rating-system/blob/main/config/db.php) (PDO connection), [`admin/dashboard.php`](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/dashboard.php) (Admin dashboard), [`public/index.php`](https://github.com/swymmm/product-review-and-rating-system/blob/main/public/index.php) (Product catalog), [`public/assets/js/app.js`](https://github.com/swymmm/product-review-and-rating-system/blob/main/public/assets/js/app.js) (Star rating UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_visitor["Visitor experience"]
  node_catalog["Product catalog<br/>[index.php]"]
  node_details["Product details<br/>[product.php]"]
  node_rating_ui["Star rating UI<br/>[app.js]"]
  node_styles["Responsive styling<br/>[styles.css]"]
end

subgraph group_rating["Rating workflow"]
  node_submission["Rating submission<br/>[rate.php]"]
end

subgraph group_admin["Admin operations"]
  node_setup["Admin setup<br/>[setup.php]"]
  node_login["Admin login<br/>[login.php]"]
  node_session_guard["Session guard<br/>[guard.php]"]
  node_dashboard["Admin dashboard<br/>[dashboard.php]"]
  node_product_create["Create product<br/>[product_create.php]"]
  node_product_edit["Edit product<br/>[edit_product.php]"]
  node_product_delete["Delete products<br/>[product_delete.php]"]
  node_product_delete_all["Delete all products"]
  node_rating_delete["Remove rating<br/>[delete_rating.php]"]
  node_logout["Admin logout<br/>[logout.php]"]
  node_uploads["Image uploads"]
end

subgraph group_data["Data access"]
  node_db_config["Database settings<br/>[config.php]"]
  node_db_access["PDO connection<br/>[db.php]"]
  node_mysql[("MySQL data<br/>[schema.sql]")]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"browses"| node_catalog
node_catalog -->|"opens details"| node_details
node_visitor -->|"selects stars"| node_rating_ui
node_details -->|"renders stars"| node_rating_ui
node_rating_ui -->|"posts rating"| node_submission
node_visitor -->|"submits vote"| node_submission
node_catalog -->|"queries products"| node_db_access
node_details -->|"queries product"| node_db_access
node_submission -->|"checks and saves"| node_db_access
node_catalog -->|"loads styles"| node_styles
node_catalog -->|"loads script"| node_rating_ui
node_admin_user -->|"creates account"| node_setup
node_admin_user -->|"signs in"| node_login
node_setup -->|"creates admin"| node_db_access
node_login -->|"checks credentials"| node_db_access
node_admin_user -->|"manages catalog"| node_dashboard
node_dashboard -->|"requires session"| node_session_guard
node_dashboard -->|"reads products and ratings"| node_db_access
node_dashboard -->|"posts new product"| node_product_create
node_dashboard -->|"opens editor"| node_product_edit
node_dashboard -->|"posts deletion"| node_product_delete
node_dashboard -->|"posts bulk deletion"| node_product_delete_all
node_dashboard -->|"posts rating removal"| node_rating_delete
node_product_create -->|"inserts product"| node_db_access
node_product_create -->|"saves image"| node_uploads
node_product_edit -->|"updates product"| node_db_access
node_product_edit -->|"replaces image"| node_uploads
node_product_delete -->|"deletes product"| node_db_access
node_product_delete -->|"removes image"| node_uploads
node_product_delete_all -->|"deletes products"| node_db_access
node_rating_delete -->|"deletes rating"| node_db_access
node_admin_user -->|"ends session"| node_logout
node_db_access -->|"loads settings"| node_db_config
node_db_access -->|"connects PDO"| node_mysql

click node_catalog "https://github.com/swymmm/product-review-and-rating-system/blob/main/public/index.php"
click node_details "https://github.com/swymmm/product-review-and-rating-system/blob/main/public/product.php"
click node_rating_ui "https://github.com/swymmm/product-review-and-rating-system/blob/main/public/assets/js/app.js"
click node_styles "https://github.com/swymmm/product-review-and-rating-system/blob/main/public/assets/css/styles.css"
click node_submission "https://github.com/swymmm/product-review-and-rating-system/blob/main/public/rate.php"
click node_setup "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/setup.php"
click node_login "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/login.php"
click node_session_guard "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/guard.php"
click node_dashboard "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/dashboard.php"
click node_product_create "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/product_create.php"
click node_product_edit "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/edit_product.php"
click node_product_delete "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/product_delete.php"
click node_product_delete_all "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/product_delete_all.php"
click node_rating_delete "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/delete_rating.php"
click node_logout "https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/logout.php"
click node_uploads "https://github.com/swymmm/product-review-and-rating-system/tree/main/public/assets/images/uploads"
click node_db_config "https://github.com/swymmm/product-review-and-rating-system/blob/main/config/config.php"
click node_db_access "https://github.com/swymmm/product-review-and-rating-system/blob/main/config/db.php"
click node_mysql "https://github.com/swymmm/product-review-and-rating-system/blob/main/sql/schema.sql"

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_catalog,node_details,node_rating_ui,node_styles toneBlue
class node_submission toneAmber
class node_setup,node_login,node_session_guard,node_dashboard,node_product_create,node_product_edit,node_product_delete,node_product_delete_all,node_rating_delete,node_logout,node_uploads toneMint
class node_db_config,node_db_access,node_mysql toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Visitor experience

- [Product catalog](https://github.com/swymmm/product-review-and-rating-system/blob/main/public/index.php): `public/index.php`
- [Product details](https://github.com/swymmm/product-review-and-rating-system/blob/main/public/product.php): `public/product.php`
- [Star rating UI](https://github.com/swymmm/product-review-and-rating-system/blob/main/public/assets/js/app.js): `public/assets/js/app.js`
- [Responsive styling](https://github.com/swymmm/product-review-and-rating-system/blob/main/public/assets/css/styles.css): `public/assets/css/styles.css`

### Rating workflow

- [Rating submission](https://github.com/swymmm/product-review-and-rating-system/blob/main/public/rate.php): `public/rate.php`

### Admin operations

- [Admin setup](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/setup.php): `admin/setup.php`
- [Admin login](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/login.php): `admin/login.php`
- [Session guard](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/guard.php): `admin/guard.php`
- [Admin dashboard](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/dashboard.php): `admin/dashboard.php`
- [Create product](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/product_create.php): `admin/product_create.php`
- [Edit product](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/edit_product.php): `admin/edit_product.php`
- [Delete products](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/product_delete.php): `admin/product_delete.php`
- [Delete all products](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/product_delete_all.php): `admin/product_delete_all.php`
- [Remove rating](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/delete_rating.php): `admin/delete_rating.php`
- [Admin logout](https://github.com/swymmm/product-review-and-rating-system/blob/main/admin/logout.php): `admin/logout.php`
- [Image uploads](https://github.com/swymmm/product-review-and-rating-system/tree/main/public/assets/images/uploads): `public/assets/images/uploads`

### Data access

- [Database settings](https://github.com/swymmm/product-review-and-rating-system/blob/main/config/config.php): `config/config.php`
- [PDO connection](https://github.com/swymmm/product-review-and-rating-system/blob/main/config/db.php): `config/db.php`
- [MySQL data](https://github.com/swymmm/product-review-and-rating-system/blob/main/sql/schema.sql): `sql/schema.sql`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Product catalog: browses (evidence: `README.md`)
- Product catalog → Product details: opens details (evidence: `public/index.php`)
- Visitor → Star rating UI: selects stars
- Product details → Star rating UI: renders stars (evidence: `public/product.php`)
- Star rating UI → Rating submission: posts rating
- Visitor → Rating submission: submits vote
- Product catalog → PDO connection: queries products (evidence: `public/index.php`)
- Product details → PDO connection: queries product (evidence: `public/product.php`)
- Rating submission → PDO connection: checks and saves (evidence: `public/rate.php`)
- Product catalog → Responsive styling: loads styles (evidence: `public/index.php`)
- Product catalog → Star rating UI: loads script (evidence: `public/index.php`)
- Administrator → Admin setup: creates account (evidence: `README.md`)
- Administrator → Admin login: signs in (evidence: `README.md`)
- Admin setup → PDO connection: creates admin (evidence: `admin/setup.php`)
- Admin login → PDO connection: checks credentials (evidence: `admin/login.php`)
- Administrator → Admin dashboard: manages catalog (evidence: `admin/dashboard.php`)
- Admin dashboard → Session guard: requires session (evidence: `admin/dashboard.php`)
- Admin dashboard → PDO connection: reads products and ratings (evidence: `admin/dashboard.php`)
- Admin dashboard → Create product: posts new product (evidence: `admin/dashboard.php`)
- Admin dashboard → Edit product: opens editor (evidence: `admin/dashboard.php`)
- Admin dashboard → Delete products: posts deletion (evidence: `admin/dashboard.php`)
- Admin dashboard → Delete all products: posts bulk deletion (evidence: `admin/dashboard.php`)
- Admin dashboard → Remove rating: posts rating removal (evidence: `admin/dashboard.php`)
- Create product → PDO connection: inserts product (evidence: `admin/product_create.php`)
- Create product → Image uploads: saves image (evidence: `admin/product_create.php`)
- Edit product → PDO connection: updates product (evidence: `admin/edit_product.php`)
- Edit product → Image uploads: replaces image (evidence: `admin/edit_product.php`)
- Delete products → PDO connection: deletes product (evidence: `admin/product_delete.php`)
- Delete products → Image uploads: removes image (evidence: `admin/product_delete.php`)
- Delete all products → PDO connection: deletes products (evidence: `admin/product_delete_all.php`)
- Remove rating → PDO connection: deletes rating (evidence: `admin/delete_rating.php`)
- Administrator → Admin logout: ends session
- PDO connection → Database settings: loads settings (evidence: `config/db.php`)
- PDO connection → MySQL data: connects PDO (evidence: `config/db.php`)
