# shawnmm010101/rigginie architecture

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

- Interactive diagram: https://gitdiagram.com/shawnmm010101/rigginie
- Repository: https://github.com/shawnmm010101/rigginie

## Overview

Rigginie is a PC-parts e-commerce application with user, merchant, and admin experiences, backed by a Django REST API. The main user journey runs from product discovery and search through cart and order operations; account access, merchant inventory/sales, administration, surveys, and product recommendations are distinct capabilities. The React entry point routes to role-specific apps, while the shared API client makes backend requests. Some backend capabilities are represented by their exact directories because their implementation files were not excerpted; the README provides no additional product detail.

Main entry points: [`brigginie/src/Appusers.jsx`](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/Appusers.jsx) (Shopper app), [`brigginie/src/App.jsx`](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/App.jsx) (Role router), [`brigginie/src/services/api.js`](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/services/api.js) (API client), [`backendd/backendd/urls.py`](https://github.com/shawnmm010101/rigginie/blob/main/backendd/backendd/urls.py) (Django API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_app_router["Role router<br/>[App.jsx]"]
  node_shopper_app["Shopper app<br/>[Appusers.jsx]"]
  node_search_ui["Product search<br/>[searchbar.jsx]"]
  node_results_ui["Search results<br/>[SearchResults.jsx]"]
  node_product_detail["Product detail<br/>[ProductDetail.jsx]"]
  node_recommendation_ui["AI build<br/>[aibuild.jsx]"]
  node_account_ui["Account<br/>[account.jsx]"]
  node_cart_ui["Cart and checkout<br/>[cart.jsx]"]
  node_merchant_ui["Merchant dashboard<br/>[dashboard.jsx]"]
  node_admin_ui["Admin dashboard<br/>[dashboard.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_commerce["Commerce backend"]
  node_api_server["Django API<br/>[urls.py]"]
  node_commerce_views["Catalog and orders<br/>[views.py]"]
  node_merchant_views["Merchant operations<br/>[merchant_views.py]"]
  node_commerce_models[("Products and carts<br/>[models.py]")]
end

subgraph group_identity["Identity and analytics"]
  node_user_views["Account services<br/>[views.py]"]
  node_user_models[("User records<br/>[models.py]")]
  node_permissions["Role permissions<br/>[permissions.py]"]
  node_ml_views["Recommendations and forecasts<br/>[views.py]"]
  node_ml_models["ML algorithms<br/>[prediction.py]"]
  node_clustering["Product clustering<br/>[clustering.py]"]
end

subgraph group_operations["Operations"]
  node_survey["Survey capability"]
  node_payments["Payment capability"]
end

node_shopper(("Shopper"))
node_merchant(("Merchant"))
node_admin(("Administrator"))
node_external_api(("HTTP API"))

node_shopper -->|"opens shop"| node_app_router
node_merchant -->|"opens merchant"| node_app_router
node_admin -->|"opens admin"| node_app_router
node_app_router -->|"routes users"| node_shopper_app
node_app_router -->|"routes merchants"| node_merchant_ui
node_app_router -->|"routes admins"| node_admin_ui
node_shopper_app -->|"renders"| node_search_ui
node_shopper_app -->|"renders"| node_results_ui
node_shopper_app -->|"renders"| node_product_detail
node_shopper_app -->|"renders"| node_recommendation_ui
node_shopper_app -->|"renders"| node_account_ui
node_shopper_app -->|"renders"| node_cart_ui
node_search_ui -->|"loads products"| node_api_client
node_results_ui -->|"loads products"| node_api_client
node_api_client -->|"sends requests"| node_external_api
node_external_api -.->|"routes API calls"| node_api_server
node_api_server -->|"routes auth"| node_user_views
node_merchant_ui -->|"uses API"| node_api_client
node_admin_ui -->|"uses API"| node_api_client
node_commerce_views -->|"reads and writes"| node_commerce_models
node_merchant_views -->|"reads and writes"| node_commerce_models
node_merchant_views -->|"checks roles"| node_permissions
node_user_views -->|"manages accounts"| node_user_models
node_ml_views -->|"calls algorithms"| node_ml_models
node_ml_views -->|"calls clustering"| node_clustering
node_ml_models -->|"reads sales data"| node_commerce_models
node_survey -.->|"API integration"| node_api_server
node_payments -.->|"API integration"| node_api_server

click node_app_router "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/App.jsx"
click node_shopper_app "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/Appusers.jsx"
click node_search_ui "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/searchbar.jsx"
click node_results_ui "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/SearchResults.jsx"
click node_product_detail "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/ProductDetail.jsx"
click node_recommendation_ui "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/aibuild.jsx"
click node_account_ui "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/account.jsx"
click node_cart_ui "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/cart.jsx"
click node_merchant_ui "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/merchantpages/dashboard.jsx"
click node_admin_ui "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/adminpages/dashboard.jsx"
click node_api_client "https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/services/api.js"
click node_api_server "https://github.com/shawnmm010101/rigginie/blob/main/backendd/backendd/urls.py"
click node_commerce_views "https://github.com/shawnmm010101/rigginie/blob/main/backendd/cart/views.py"
click node_merchant_views "https://github.com/shawnmm010101/rigginie/blob/main/backendd/cart/merchant_views.py"
click node_commerce_models "https://github.com/shawnmm010101/rigginie/blob/main/backendd/cart/models.py"
click node_user_views "https://github.com/shawnmm010101/rigginie/blob/main/backendd/databaseusers/views.py"
click node_user_models "https://github.com/shawnmm010101/rigginie/blob/main/backendd/databaseusers/models.py"
click node_permissions "https://github.com/shawnmm010101/rigginie/blob/main/backendd/databaseusers/permissions.py"
click node_ml_views "https://github.com/shawnmm010101/rigginie/blob/main/backendd/machinelearning/views.py"
click node_ml_models "https://github.com/shawnmm010101/rigginie/blob/main/backendd/machinelearning/prediction.py"
click node_clustering "https://github.com/shawnmm010101/rigginie/blob/main/backendd/machinelearning/clustering.py"
click node_survey "https://github.com/shawnmm010101/rigginie/tree/main/backendd/survey"
click node_payments "https://github.com/shawnmm010101/rigginie/tree/main/backendd/payment"

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_app_router,node_shopper_app,node_search_ui,node_results_ui,node_product_detail,node_recommendation_ui,node_account_ui,node_cart_ui,node_merchant_ui,node_admin_ui,node_api_client toneBlue
class node_api_server,node_commerce_views,node_merchant_views,node_commerce_models toneAmber
class node_user_views,node_user_models,node_permissions,node_ml_views,node_ml_models,node_clustering,node_external_api toneMint
class node_survey,node_payments toneRose
class node_shopper,node_merchant,node_admin toneIndigo
```

## Components

### Web experience

- [Role router](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/App.jsx): `brigginie/src/App.jsx`
- [Shopper app](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/Appusers.jsx): `brigginie/src/Appusers.jsx`
- [Product search](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/searchbar.jsx): `brigginie/src/components/userspages/interactive/searchbar.jsx`
- [Search results](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/SearchResults.jsx): `brigginie/src/components/userspages/interactive/SearchResults.jsx`
- [Product detail](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/ProductDetail.jsx): `brigginie/src/components/userspages/interactive/ProductDetail.jsx`
- [AI build](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/aibuild.jsx): `brigginie/src/components/userspages/interactive/aibuild.jsx`
- [Account](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/account.jsx): `brigginie/src/components/userspages/interactive/account.jsx`
- [Cart and checkout](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/userspages/interactive/cart.jsx): `brigginie/src/components/userspages/interactive/cart.jsx`
- [Merchant dashboard](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/merchantpages/dashboard.jsx): `brigginie/src/components/merchantpages/dashboard.jsx`
- [Admin dashboard](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/components/adminpages/dashboard.jsx): `brigginie/src/components/adminpages/dashboard.jsx`
- [API client](https://github.com/shawnmm010101/rigginie/blob/main/brigginie/src/services/api.js): `brigginie/src/services/api.js`

### Commerce backend

- [Django API](https://github.com/shawnmm010101/rigginie/blob/main/backendd/backendd/urls.py): `backendd/backendd/urls.py`
- [Catalog and orders](https://github.com/shawnmm010101/rigginie/blob/main/backendd/cart/views.py): `backendd/cart/views.py`
- [Merchant operations](https://github.com/shawnmm010101/rigginie/blob/main/backendd/cart/merchant_views.py): `backendd/cart/merchant_views.py`
- [Products and carts](https://github.com/shawnmm010101/rigginie/blob/main/backendd/cart/models.py): `backendd/cart/models.py`

### Identity and analytics

- [Account services](https://github.com/shawnmm010101/rigginie/blob/main/backendd/databaseusers/views.py): `backendd/databaseusers/views.py`
- [User records](https://github.com/shawnmm010101/rigginie/blob/main/backendd/databaseusers/models.py): `backendd/databaseusers/models.py`
- [Role permissions](https://github.com/shawnmm010101/rigginie/blob/main/backendd/databaseusers/permissions.py): `backendd/databaseusers/permissions.py`
- [Recommendations and forecasts](https://github.com/shawnmm010101/rigginie/blob/main/backendd/machinelearning/views.py): `backendd/machinelearning/views.py`
- [ML algorithms](https://github.com/shawnmm010101/rigginie/blob/main/backendd/machinelearning/prediction.py): `backendd/machinelearning/prediction.py`
- [Product clustering](https://github.com/shawnmm010101/rigginie/blob/main/backendd/machinelearning/clustering.py): `backendd/machinelearning/clustering.py`

### Operations

- [Survey capability](https://github.com/shawnmm010101/rigginie/tree/main/backendd/survey): `backendd/survey`
- [Payment capability](https://github.com/shawnmm010101/rigginie/tree/main/backendd/payment): `backendd/payment`

### Other components

- **Shopper**
- **Merchant**
- **Administrator**
- **HTTP API**

## Connections

- Shopper → Role router: opens shop (evidence: `brigginie/src/App.jsx`)
- Merchant → Role router: opens merchant (evidence: `brigginie/src/App.jsx`)
- Administrator → Role router: opens admin (evidence: `brigginie/src/App.jsx`)
- Role router → Shopper app: routes users (evidence: `brigginie/src/App.jsx`)
- Role router → Merchant dashboard: routes merchants (evidence: `brigginie/src/App.jsx`)
- Role router → Admin dashboard: routes admins (evidence: `brigginie/src/App.jsx`)
- Shopper app → Product search: renders (evidence: `brigginie/src/Appusers.jsx`)
- Shopper app → Search results: renders (evidence: `brigginie/src/Appusers.jsx`)
- Shopper app → Product detail: renders (evidence: `brigginie/src/Appusers.jsx`)
- Shopper app → AI build: renders (evidence: `brigginie/src/Appusers.jsx`)
- Shopper app → Account: renders (evidence: `brigginie/src/Appusers.jsx`)
- Shopper app → Cart and checkout: renders (evidence: `brigginie/src/Appusers.jsx`)
- Product search → API client: loads products (evidence: `brigginie/src/components/userspages/interactive/searchbar.jsx`)
- Search results → API client: loads products (evidence: `brigginie/src/components/userspages/interactive/SearchResults.jsx`)
- API client → HTTP API: sends requests (evidence: `brigginie/src/services/api.js`)
- HTTP API → Django API: routes API calls
- Django API → Account services: routes auth (evidence: `backendd/backendd/urls.py`)
- Merchant dashboard → API client: uses API (evidence: `brigginie/src/components/merchantpages/dashboard.jsx`)
- Admin dashboard → API client: uses API (evidence: `brigginie/src/Appadmin.jsx`)
- Catalog and orders → Products and carts: reads and writes (evidence: `backendd/cart/views.py`)
- Merchant operations → Products and carts: reads and writes (evidence: `backendd/cart/merchant_views.py`)
- Merchant operations → Role permissions: checks roles (evidence: `backendd/cart/merchant_views.py`)
- Account services → User records: manages accounts (evidence: `backendd/databaseusers/views.py`)
- Recommendations and forecasts → ML algorithms: calls algorithms (evidence: `backendd/machinelearning/views.py`)
- Recommendations and forecasts → Product clustering: calls clustering (evidence: `backendd/machinelearning/views.py`)
- ML algorithms → Products and carts: reads sales data (evidence: `backendd/machinelearning/prediction.py`)
- Survey capability → Django API: API integration
- Payment capability → Django API: API integration
