# safa-kaware/multivendor architecture

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

- Interactive diagram: https://gitdiagram.com/safa-kaware/multivendor
- Repository: https://github.com/safa-kaware/multivendor

## Overview

MultiVendor is a PHP/MySQL marketplace for customers, vendors, and administrators. The customer journey runs from discovery and product details through cart, checkout/payment, and order tracking; parallel branches cover account/wishlist/address services, vendor catalog and order tools, and marketplace administration. Shared app configuration supplies session, database, helpers, and authentication; the REST API has a separate stateless token bootstrap. README-documented features are included where their exact implementation paths appear in the tree. Unsampled internals and most cross-page writes are not inferred.

Main entry points: [`config/app.php`](https://github.com/safa-kaware/multivendor/blob/main/config/app.php) (MySQL database), [`index.php`](https://github.com/safa-kaware/multivendor/blob/main/index.php) (Home & banners), [`checkout.php`](https://github.com/safa-kaware/multivendor/blob/main/checkout.php) (Checkout & payment), [`search.php`](https://github.com/safa-kaware/multivendor/blob/main/search.php) (Search catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront &amp; shopping"]
  node_home["Home &amp; banners<br/>[index.php]"]
  node_search["Search catalog<br/>[search.php]"]
  node_product["Product details<br/>[product.php]"]
  node_cart["Cart &amp; coupons<br/>[cart.php]"]
  node_checkout["Checkout &amp; payment<br/>[checkout.php]"]
  node_orders["Order tracking<br/>[order-details.php]"]
end

subgraph group_accounts["Identity &amp; customer"]
  node_wishlist["Wishlist<br/>[wishlist.php]"]
  node_addresses["Address book<br/>[addresses.php]"]
  node_profile["Customer profile<br/>[profile.php]"]
end

subgraph group_vendor["Vendor operations"]
  node_vendorcatalog["Vendor catalog tools"]
  node_vendororders["Vendor order tools"]
end

subgraph group_admin["Marketplace administration"]
  node_adminproducts["Product administration<br/>[product-edit.php]"]
  node_adminvendors["Vendor approvals<br/>[vendors.php]"]
  node_adminorders["Order administration<br/>[orders.php]"]
  node_adminreports["Reports &amp; analytics<br/>[reports.php]"]
  node_admincontrols["Marketplace controls<br/>[banners.php]"]
end

subgraph group_platform["Shared services &amp; API"]
  node_auth["Authentication &amp; roles<br/>[auth_functions.php]"]
  node_app["App bootstrap<br/>[app.php]"]
  node_webui["Storefront shell<br/>[header.php]"]
  node_api["REST API endpoints<br/>[products.php]"]
  node_apiboot["API token bootstrap<br/>[config.php]"]
  node_database[("MySQL database<br/>[app.php]")]
end

node_customer(("Customer"))
node_stripe["Stripe"]

node_customer -->|"browses"| node_home
node_customer -->|"filters products"| node_search
node_home -->|"links to"| node_search
node_search -->|"opens product"| node_product
node_customer -->|"views details"| node_product
node_customer -->|"manages cart"| node_cart
node_cart -->|"proceeds to"| node_checkout
node_checkout -.->|"creates order"| node_orders
node_checkout -.->|"optional card payment"| node_stripe
node_customer -->|"saves items"| node_wishlist
node_customer -->|"manages addresses"| node_addresses
node_customer -->|"manages account"| node_profile
node_customer -->|"registers or signs in"| node_auth
node_auth -->|"reads and writes users"| node_database
node_home -->|"loads bootstrap"| node_app
node_search -->|"loads bootstrap"| node_app
node_product -->|"loads bootstrap"| node_app
node_cart -->|"loads bootstrap"| node_app
node_checkout -->|"loads bootstrap"| node_app
node_addresses -->|"loads bootstrap"| node_app
node_app -->|"configures connection"| node_database
node_app -->|"loads auth helpers"| node_auth
node_home -->|"renders shell"| node_webui
node_vendorcatalog -.->|"manages catalog"| node_database
node_vendororders -.->|"reads vendor orders"| node_database
node_adminproducts -.->|"manages products"| node_database
node_adminvendors -.->|"approves vendors"| node_database
node_adminorders -.->|"manages orders"| node_database
node_adminreports -.->|"aggregates sales"| node_database
node_admincontrols -.->|"configures marketplace"| node_database
node_api -->|"loads token bootstrap"| node_apiboot
node_apiboot -->|"loads app config"| node_app
node_api -.->|"serves product data"| node_database

click node_home "https://github.com/safa-kaware/multivendor/blob/main/index.php"
click node_search "https://github.com/safa-kaware/multivendor/blob/main/search.php"
click node_product "https://github.com/safa-kaware/multivendor/blob/main/product.php"
click node_cart "https://github.com/safa-kaware/multivendor/blob/main/cart.php"
click node_checkout "https://github.com/safa-kaware/multivendor/blob/main/checkout.php"
click node_orders "https://github.com/safa-kaware/multivendor/blob/main/order-details.php"
click node_wishlist "https://github.com/safa-kaware/multivendor/blob/main/wishlist.php"
click node_addresses "https://github.com/safa-kaware/multivendor/blob/main/addresses.php"
click node_profile "https://github.com/safa-kaware/multivendor/blob/main/profile.php"
click node_auth "https://github.com/safa-kaware/multivendor/blob/main/functions/auth_functions.php"
click node_app "https://github.com/safa-kaware/multivendor/blob/main/config/app.php"
click node_webui "https://github.com/safa-kaware/multivendor/blob/main/includes/header.php"
click node_vendorcatalog "https://github.com/safa-kaware/multivendor/blob/main/vendor-registrations.php"
click node_vendororders "https://github.com/safa-kaware/multivendor/blob/main/vendor-registrations.php"
click node_adminproducts "https://github.com/safa-kaware/multivendor/blob/main/admin/product-edit.php"
click node_adminvendors "https://github.com/safa-kaware/multivendor/blob/main/admin/vendors.php"
click node_adminorders "https://github.com/safa-kaware/multivendor/blob/main/admin/orders.php"
click node_adminreports "https://github.com/safa-kaware/multivendor/blob/main/admin/reports.php"
click node_admincontrols "https://github.com/safa-kaware/multivendor/blob/main/admin/banners.php"
click node_api "https://github.com/safa-kaware/multivendor/blob/main/api/products.php"
click node_apiboot "https://github.com/safa-kaware/multivendor/blob/main/api/config.php"
click node_database "https://github.com/safa-kaware/multivendor/blob/main/config/app.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_home,node_search,node_product,node_cart,node_checkout,node_orders toneBlue
class node_wishlist,node_addresses,node_profile toneAmber
class node_vendorcatalog,node_vendororders toneMint
class node_adminproducts,node_adminvendors,node_adminorders,node_adminreports,node_admincontrols toneRose
class node_auth,node_app,node_webui,node_api,node_apiboot,node_database,node_customer,node_stripe toneIndigo
```

## Components

### Storefront & shopping

- [Home & banners](https://github.com/safa-kaware/multivendor/blob/main/index.php): `index.php`
- [Search catalog](https://github.com/safa-kaware/multivendor/blob/main/search.php): `search.php`
- [Product details](https://github.com/safa-kaware/multivendor/blob/main/product.php): `product.php`
- [Cart & coupons](https://github.com/safa-kaware/multivendor/blob/main/cart.php): `cart.php`
- [Checkout & payment](https://github.com/safa-kaware/multivendor/blob/main/checkout.php): `checkout.php`
- [Order tracking](https://github.com/safa-kaware/multivendor/blob/main/order-details.php): `order-details.php`

### Identity & customer

- [Wishlist](https://github.com/safa-kaware/multivendor/blob/main/wishlist.php): `wishlist.php`
- [Address book](https://github.com/safa-kaware/multivendor/blob/main/addresses.php): `addresses.php`
- [Customer profile](https://github.com/safa-kaware/multivendor/blob/main/profile.php): `profile.php`

### Vendor operations

- [Vendor catalog tools](https://github.com/safa-kaware/multivendor/blob/main/vendor-registrations.php): `vendor-registrations.php`
- [Vendor order tools](https://github.com/safa-kaware/multivendor/blob/main/vendor-registrations.php): `vendor-registrations.php`

### Marketplace administration

- [Product administration](https://github.com/safa-kaware/multivendor/blob/main/admin/product-edit.php): `admin/product-edit.php`
- [Vendor approvals](https://github.com/safa-kaware/multivendor/blob/main/admin/vendors.php): `admin/vendors.php`
- [Order administration](https://github.com/safa-kaware/multivendor/blob/main/admin/orders.php): `admin/orders.php`
- [Reports & analytics](https://github.com/safa-kaware/multivendor/blob/main/admin/reports.php): `admin/reports.php`
- [Marketplace controls](https://github.com/safa-kaware/multivendor/blob/main/admin/banners.php): `admin/banners.php`

### Shared services & API

- [Authentication & roles](https://github.com/safa-kaware/multivendor/blob/main/functions/auth_functions.php): `functions/auth_functions.php`
- [App bootstrap](https://github.com/safa-kaware/multivendor/blob/main/config/app.php): `config/app.php`
- [Storefront shell](https://github.com/safa-kaware/multivendor/blob/main/includes/header.php): `includes/header.php`
- [REST API endpoints](https://github.com/safa-kaware/multivendor/blob/main/api/products.php): `api/products.php`
- [API token bootstrap](https://github.com/safa-kaware/multivendor/blob/main/api/config.php): `api/config.php`
- [MySQL database](https://github.com/safa-kaware/multivendor/blob/main/config/app.php): `config/app.php`

### Other components

- **Customer**
- **Stripe**

## Connections

- Customer → Home & banners: browses
- Customer → Search catalog: filters products
- Home & banners → Search catalog: links to (evidence: `index.php`)
- Search catalog → Product details: opens product (evidence: `search.php`)
- Customer → Product details: views details
- Customer → Cart & coupons: manages cart
- Cart & coupons → Checkout & payment: proceeds to
- Checkout & payment → Order tracking: creates order
- Checkout & payment → Stripe: optional card payment
- Customer → Wishlist: saves items
- Customer → Address book: manages addresses
- Customer → Customer profile: manages account
- Customer → Authentication & roles: registers or signs in (evidence: `functions/auth_functions.php`)
- Authentication & roles → MySQL database: reads and writes users (evidence: `functions/auth_functions.php`)
- Home & banners → App bootstrap: loads bootstrap (evidence: `index.php`)
- Search catalog → App bootstrap: loads bootstrap (evidence: `search.php`)
- Product details → App bootstrap: loads bootstrap (evidence: `product.php`)
- Cart & coupons → App bootstrap: loads bootstrap (evidence: `cart.php`)
- Checkout & payment → App bootstrap: loads bootstrap (evidence: `checkout.php`)
- Address book → App bootstrap: loads bootstrap (evidence: `addresses.php`)
- App bootstrap → MySQL database: configures connection (evidence: `config/app.php`)
- App bootstrap → Authentication & roles: loads auth helpers (evidence: `config/app.php`)
- Home & banners → Storefront shell: renders shell (evidence: `index.php`)
- Vendor catalog tools → MySQL database: manages catalog
- Vendor order tools → MySQL database: reads vendor orders
- Product administration → MySQL database: manages products (evidence: `admin/product-edit.php`)
- Vendor approvals → MySQL database: approves vendors (evidence: `admin/vendors.php`)
- Order administration → MySQL database: manages orders
- Reports & analytics → MySQL database: aggregates sales
- Marketplace controls → MySQL database: configures marketplace (evidence: `admin/banners.php`)
- REST API endpoints → API token bootstrap: loads token bootstrap (evidence: `api/products.php`)
- API token bootstrap → App bootstrap: loads app config (evidence: `api/config.php`)
- REST API endpoints → MySQL database: serves product data
