# eltonverve/verve-ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/eltonverve/verve-ecommerce
- Repository: https://github.com/eltonverve/verve-ecommerce

## Overview

Rada Cart is a PHP/MySQL ecommerce application. Its principal customer journey spans product discovery, cart and checkout, order placement, and account/order access; the tree also shows reviews, wishlists, coupons, and customer login-code flows. A separate admin area supports catalog, submission, customer, and order operations, including dispatch, returns, and refund records. Sampled source confirms the review and product-submission action calls and review SQL access; other subsystem links are kept conservative because their implementations were not sampled. The README states payment processing is not connected.

Main entry points: [`verve/actions/admin`](https://github.com/eltonverve/verve-ecommerce/tree/main/verve/actions/admin) (Admin actions), [`verve/actions/add_review.php`](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/actions/add_review.php) (Submit review), [`verve/pages/search-suggestions.php`](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/pages/search-suggestions.php) (Search suggestions), [`verve/actions/place_order.php`](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/actions/place_order.php) (Place order)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_storefront_pages["Store pages"]
  node_header["Store navigation<br/>[header.php]"]
  node_suggestions["Search suggestions"]
  node_reviews_action["Submit review<br/>[add_review.php]"]
end

subgraph group_commerce["Commerce"]
  node_product_model["Product catalog<br/>[Product.php]"]
  node_cart_model["Cart<br/>[Cart.php]"]
  node_order_action["Place order<br/>[place_order.php]"]
  node_order_model["Order management<br/>[Order.php]"]
  node_review_model["Product reviews<br/>[Review.php]"]
  node_wishlist_model["Wishlist<br/>[Wishlist.php]"]
  node_coupon_model["Coupons<br/>[Coupon.php]"]
end

subgraph group_identity["Customer identity"]
  node_customer_actions["Customer actions"]
  node_customer_sessions["Persistent sessions"]
end

subgraph group_administration["Administration"]
  node_admin_pages["Admin screens"]
  node_admin_actions["Admin actions"]
  node_submission_model["Product submissions"]
  node_operations_model["Order operations"]
end

node_customer(("Customer"))
node_admin(("Admin staff"))
node_mysql[("MySQL database")]
node_payment_service["Payment processing"]

node_customer -->|"browses"| node_storefront_pages
node_customer -->|"submits"| node_customer_actions
node_admin -->|"manages"| node_admin_pages
node_admin_pages -->|"posts forms"| node_admin_actions
node_admin_actions -->|"reviews submission"| node_submission_model
node_reviews_action -->|"gets product"| node_product_model
node_reviews_action -->|"creates review"| node_review_model
node_review_model -->|"queries and inserts"| node_mysql
node_header -->|"requests suggestions"| node_suggestions
node_suggestions -->|"searches products"| node_product_model
node_customer_sessions -->|"reads and writes sessions"| node_mysql
node_admin_actions -->|"records operations"| node_operations_model
node_order_action --> node_order_model
node_order_model --> node_mysql
node_payment_service -.->|"not connected"| node_order_action

click node_storefront_pages "https://github.com/eltonverve/verve-ecommerce/tree/main/verve/pages"
click node_header "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/includes/header.php"
click node_suggestions "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/pages/search-suggestions.php"
click node_reviews_action "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/actions/add_review.php"
click node_product_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Product.php"
click node_cart_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Cart.php"
click node_order_action "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/actions/place_order.php"
click node_order_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Order.php"
click node_review_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Review.php"
click node_wishlist_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Wishlist.php"
click node_coupon_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Coupon.php"
click node_customer_actions "https://github.com/eltonverve/verve-ecommerce/tree/main/verve/actions"
click node_customer_sessions "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/CustomerSession.php"
click node_admin_pages "https://github.com/eltonverve/verve-ecommerce/tree/main/verve/pages/admin"
click node_admin_actions "https://github.com/eltonverve/verve-ecommerce/tree/main/verve/actions/admin"
click node_submission_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/ProductSubmission.php"
click node_operations_model "https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/OrderOperations.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_storefront_pages,node_header,node_suggestions,node_reviews_action toneBlue
class node_product_model,node_cart_model,node_order_action,node_order_model,node_review_model,node_wishlist_model,node_coupon_model,node_mysql toneAmber
class node_customer_actions,node_customer_sessions toneMint
class node_admin_pages,node_admin_actions,node_submission_model,node_operations_model toneRose
class node_customer,node_admin,node_payment_service toneIndigo
```

## Components

### Storefront

- [Store pages](https://github.com/eltonverve/verve-ecommerce/tree/main/verve/pages): `verve/pages`
- [Store navigation](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/includes/header.php): `verve/includes/header.php`
- [Search suggestions](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/pages/search-suggestions.php): `verve/pages/search-suggestions.php`
- [Submit review](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/actions/add_review.php): `verve/actions/add_review.php`

### Commerce

- [Product catalog](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Product.php): `verve/models/Product.php`
- [Cart](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Cart.php): `verve/models/Cart.php`
- [Place order](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/actions/place_order.php): `verve/actions/place_order.php`
- [Order management](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Order.php): `verve/models/Order.php`
- [Product reviews](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Review.php): `verve/models/Review.php`
- [Wishlist](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Wishlist.php): `verve/models/Wishlist.php`
- [Coupons](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/Coupon.php): `verve/models/Coupon.php`

### Customer identity

- [Customer actions](https://github.com/eltonverve/verve-ecommerce/tree/main/verve/actions): `verve/actions`
- [Persistent sessions](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/CustomerSession.php): `verve/models/CustomerSession.php`

### Administration

- [Admin screens](https://github.com/eltonverve/verve-ecommerce/tree/main/verve/pages/admin): `verve/pages/admin`
- [Admin actions](https://github.com/eltonverve/verve-ecommerce/tree/main/verve/actions/admin): `verve/actions/admin`
- [Product submissions](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/ProductSubmission.php): `verve/models/ProductSubmission.php`
- [Order operations](https://github.com/eltonverve/verve-ecommerce/blob/main/verve/models/OrderOperations.php): `verve/models/OrderOperations.php`

### Other components

- **Customer**
- **Admin staff**
- **MySQL database**
- **Payment processing**

## Connections

- Customer → Store pages: browses
- Customer → Customer actions: submits
- Admin staff → Admin screens: manages
- Admin screens → Admin actions: posts forms
- Admin actions → Product submissions: reviews submission
- Submit review → Product catalog: gets product
- Submit review → Product reviews: creates review
- Product reviews → MySQL database: queries and inserts
- Store navigation → Search suggestions: requests suggestions
- Search suggestions → Product catalog: searches products
- Persistent sessions → MySQL database: reads and writes sessions
- Admin actions → Order operations: records operations
- Place order → Order management
- Order management → MySQL database
- Payment processing → Place order: not connected