# ahmedshaker196/urbanix architecture

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

- Interactive diagram: https://gitdiagram.com/ahmedshaker196/urbanix
- Repository: https://github.com/ahmedshaker196/urbanix

## Overview

URBANIX is a small PHP storefront with account entry, product browsing and cart pages, contact messaging, and an administrative area. The visible account flow registers or authenticates users; a successful login creates or finds a cart and routes admins to the dashboard or users to the home page. Admin pages manage products and inspect clients, carts, and contact messages. The README names additional storefront pages, but their implementation was not sampled, so their internal flow is not inferred. Connections shown are limited to explicit imports, SQL connection setup, and page links in the excerpts.

Main entry points: [`admin.php`](https://github.com/ahmedshaker196/urbanix/blob/main/admin.php) (Admin dashboard), [`config/db.php`](https://github.com/ahmedshaker196/urbanix/blob/main/config/db.php) (DB connection), [`index.php`](https://github.com/ahmedshaker196/urbanix/blob/main/index.php) (Login), [`Register.php`](https://github.com/ahmedshaker196/urbanix/blob/main/Register.php) (Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts"]
  node_login["Login<br/>[index.php]"]
  node_registration["Registration<br/>[Register.php]"]
end

subgraph group_storefront["Storefront"]
  node_home["Home page<br/>[Home.html]"]
  node_product_catalog["Product catalog<br/>[products.php]"]
  node_cart_page["Customer cart<br/>[cart.php]"]
  node_contact_form["Contact form<br/>[contact.php]"]
  node_about_page["About page<br/>[about.php]"]
end

subgraph group_administration["Administration"]
  node_dashboard["Admin dashboard<br/>[admin.php]"]
  node_product_admin["Add product"]
  node_product_edit["Edit product<br/>[edit_product.php]"]
  node_product_delete["Delete product<br/>[delete_product.php]"]
  node_client_admin["Client overview<br/>[client.php]"]
  node_cart_admin["Cart overview<br/>[fetch_cart.php]"]
  node_message_admin["Message inbox<br/>[posts.php]"]
  node_message_delete["Delete message<br/>[delete_post.php]"]
end

subgraph group_persistence["Persistence"]
  node_db_config["DB connection<br/>[db.php]"]
  node_mysql[("MySQL database")]
end

node_visitor(("Visitor"))

node_visitor -->|"submits credentials"| node_login
node_visitor -->|"registers account"| node_registration
node_login -->|"loads connection"| node_db_config
node_registration -->|"loads connection"| node_db_config
node_login -->|"routes admin"| node_dashboard
node_login -->|"routes user"| node_home
node_contact_form -->|"loads connection"| node_db_config
node_dashboard -->|"loads connection"| node_db_config
node_dashboard -->|"links to"| node_product_admin
node_dashboard -->|"links to"| node_product_edit
node_dashboard -->|"links to"| node_product_delete
node_dashboard -->|"links to"| node_client_admin
node_dashboard -->|"links to"| node_cart_admin
node_dashboard -->|"links to"| node_message_admin
node_message_admin -->|"links to"| node_message_delete
node_db_config -->|"connects to"| node_mysql

click node_login "https://github.com/ahmedshaker196/urbanix/blob/main/index.php"
click node_registration "https://github.com/ahmedshaker196/urbanix/blob/main/Register.php"
click node_home "https://github.com/ahmedshaker196/urbanix/blob/main/Home.html"
click node_product_catalog "https://github.com/ahmedshaker196/urbanix/blob/main/products.php"
click node_cart_page "https://github.com/ahmedshaker196/urbanix/blob/main/cart.php"
click node_contact_form "https://github.com/ahmedshaker196/urbanix/blob/main/contact.php"
click node_about_page "https://github.com/ahmedshaker196/urbanix/blob/main/about.php"
click node_dashboard "https://github.com/ahmedshaker196/urbanix/blob/main/admin.php"
click node_product_admin "https://github.com/ahmedshaker196/urbanix/blob/main/addproduct_admin.php"
click node_product_edit "https://github.com/ahmedshaker196/urbanix/blob/main/edit_product.php"
click node_product_delete "https://github.com/ahmedshaker196/urbanix/blob/main/delete_product.php"
click node_client_admin "https://github.com/ahmedshaker196/urbanix/blob/main/client.php"
click node_cart_admin "https://github.com/ahmedshaker196/urbanix/blob/main/fetch_cart.php"
click node_message_admin "https://github.com/ahmedshaker196/urbanix/blob/main/posts.php"
click node_message_delete "https://github.com/ahmedshaker196/urbanix/blob/main/delete_post.php"
click node_db_config "https://github.com/ahmedshaker196/urbanix/blob/main/config/db.php"

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_login,node_registration toneBlue
class node_home,node_product_catalog,node_cart_page,node_contact_form,node_about_page toneAmber
class node_dashboard,node_product_admin,node_product_edit,node_product_delete,node_client_admin,node_cart_admin,node_message_admin,node_message_delete toneMint
class node_db_config,node_mysql toneRose
class node_visitor toneIndigo
```

## Components

### Accounts

- [Login](https://github.com/ahmedshaker196/urbanix/blob/main/index.php): `index.php`
- [Registration](https://github.com/ahmedshaker196/urbanix/blob/main/Register.php): `Register.php`

### Storefront

- [Home page](https://github.com/ahmedshaker196/urbanix/blob/main/Home.html): `Home.html`
- [Product catalog](https://github.com/ahmedshaker196/urbanix/blob/main/products.php): `products.php`
- [Customer cart](https://github.com/ahmedshaker196/urbanix/blob/main/cart.php): `cart.php`
- [Contact form](https://github.com/ahmedshaker196/urbanix/blob/main/contact.php): `contact.php`
- [About page](https://github.com/ahmedshaker196/urbanix/blob/main/about.php): `about.php`

### Administration

- [Admin dashboard](https://github.com/ahmedshaker196/urbanix/blob/main/admin.php): `admin.php`
- [Add product](https://github.com/ahmedshaker196/urbanix/blob/main/addproduct_admin.php): `addproduct_admin.php`
- [Edit product](https://github.com/ahmedshaker196/urbanix/blob/main/edit_product.php): `edit_product.php`
- [Delete product](https://github.com/ahmedshaker196/urbanix/blob/main/delete_product.php): `delete_product.php`
- [Client overview](https://github.com/ahmedshaker196/urbanix/blob/main/client.php): `client.php`
- [Cart overview](https://github.com/ahmedshaker196/urbanix/blob/main/fetch_cart.php): `fetch_cart.php`
- [Message inbox](https://github.com/ahmedshaker196/urbanix/blob/main/posts.php): `posts.php`
- [Delete message](https://github.com/ahmedshaker196/urbanix/blob/main/delete_post.php): `delete_post.php`

### Persistence

- [DB connection](https://github.com/ahmedshaker196/urbanix/blob/main/config/db.php): `config/db.php`
- **MySQL database**

### Other components

- **Visitor**

## Connections

- Visitor → Login: submits credentials (evidence: `index.php`)
- Visitor → Registration: registers account (evidence: `Register.php`)
- Login → DB connection: loads connection (evidence: `index.php`)
- Registration → DB connection: loads connection (evidence: `Register.php`)
- Login → Admin dashboard: routes admin (evidence: `index.php`)
- Login → Home page: routes user (evidence: `index.php`)
- Contact form → DB connection: loads connection (evidence: `contact.php`)
- Admin dashboard → DB connection: loads connection (evidence: `admin.php`)
- Admin dashboard → Add product: links to (evidence: `admin.php`)
- Admin dashboard → Edit product: links to (evidence: `admin.php`)
- Admin dashboard → Delete product: links to (evidence: `admin.php`)
- Admin dashboard → Client overview: links to (evidence: `admin.php`)
- Admin dashboard → Cart overview: links to (evidence: `admin.php`)
- Admin dashboard → Message inbox: links to (evidence: `admin.php`)
- Message inbox → Delete message: links to (evidence: `posts.php`)
- DB connection → MySQL database: connects to (evidence: `config/db.php`)
