# angelicaorgel9-source/frontend-salestracking architecture

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

- Interactive diagram: https://gitdiagram.com/angelicaorgel9-source/frontend-salestracking
- Repository: https://github.com/angelicaorgel9-source/frontend-salestracking

## Overview

MJ Prints Sales Tracking is a multi-portal sales and print-order application: customers browse products and submit orders, while employees and administrators handle order operations; the portals also expose customer, payroll, inventory, analytics, and account features. The React frontend routes portal screens and uses a shared API client to reach a Django REST backend. The README documents MongoDB-backed address and notification features and SMS-dependent verification. Some admin and employee screens use demo data; backend endpoint wiring and several screens were not sampled, so those relationships are shown only where documented or evidenced.

Main entry points: [`src/utils/api.js`](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/utils/api.js) (API client), [`backend/accounts/views.py`](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/views.py) (Account endpoints), [`src/App.jsx`](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/App.jsx) (Portal routing), [`backend/orders/views.py`](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/orders/views.py) (Order endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Portal frontend"]
  node_app["Portal routing<br/>[App.jsx]"]
  node_customer_catalog["Product browsing"]
  node_customer_order["Order entry<br/>[NewOrderModal.jsx]"]
  node_customer_profile["Customer profile"]
  node_employee_orders["Employee orders<br/>[Orders.jsx]"]
  node_admin_orders["Admin orders<br/>[Orders.jsx]"]
  node_admin_payroll["Admin payroll<br/>[Payroll.jsx]"]
  node_employee_payroll["Employee payroll<br/>[Payroll.jsx]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_orders["Order and catalog"]
  node_order_api["Order endpoints<br/>[views.py]"]
  node_order_data[("Order models<br/>[models.py]")]
  node_order_serializers["Order serializers<br/>[serializers.py]"]
  node_product_api["Product endpoints<br/>[views.py]"]
  node_product_data[("Product models<br/>[models.py]")]
end

subgraph group_identity["Accounts and branches"]
  node_account_api["Account endpoints<br/>[views.py]"]
  node_account_data[("Account models<br/>[models.py]")]
  node_account_access["Account permissions<br/>[permissions.py]"]
  node_account_serializers["Account serializers<br/>[serializers.py]"]
  node_branch_api["Branch endpoints<br/>[views.py]"]
end

subgraph group_operations["Business operations"]
  node_payroll_api["Payroll endpoints<br/>[views.py]"]
  node_mongo[("MongoDB features<br/>[mongodb.py]")]
  node_sms["SMS verification<br/>[sms.py]"]
end

node_customer(("Customer"))
node_employee(("Employee"))
node_administrator(("Administrator"))

node_customer -->|"opens portal"| node_app
node_employee -->|"opens portal"| node_app
node_administrator -->|"opens portal"| node_app
node_app -->|"routes to"| node_customer_catalog
node_app -->|"routes to"| node_employee_orders
node_app -->|"routes to"| node_admin_orders
node_customer_catalog -->|"opens order"| node_customer_order
node_customer_catalog -->|"creates order"| node_api
node_customer_profile -->|"loads profile"| node_api
node_employee_orders -->|"submits orders"| node_api
node_admin_orders -->|"loads records"| node_api
node_api -->|"HTTP requests"| node_order_api
node_api -->|"HTTP requests"| node_account_api
node_api -->|"HTTP requests"| node_product_api
node_api -.->|"HTTP requests"| node_payroll_api
node_order_api -->|"uses models"| node_order_data
node_order_api -->|"uses serializers"| node_order_serializers
node_order_data -->|"references products"| node_product_data
node_account_api -->|"uses models"| node_account_data
node_account_api -->|"checks permissions"| node_account_access
node_account_api -->|"uses serializers"| node_account_serializers
node_order_api -->|"uses account data"| node_account_data
node_order_api -->|"uses MongoDB"| node_mongo
node_account_api -->|"uses MongoDB"| node_mongo
node_account_api -->|"sends verification"| node_sms
node_payroll_api -.->|"serves employee view"| node_employee_payroll

click node_app "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/App.jsx"
click node_customer_catalog "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/customer/ProductsServices.jsx"
click node_customer_order "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/components/customer/modals/NewOrderModal.jsx"
click node_customer_profile "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/context/CustomerProfileContext.jsx"
click node_employee_orders "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/employee/Orders.jsx"
click node_admin_orders "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/admin/Orders.jsx"
click node_admin_payroll "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/admin/Payroll.jsx"
click node_employee_payroll "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/employee/Payroll.jsx"
click node_api "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/utils/api.js"
click node_account_api "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/views.py"
click node_account_data "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/models.py"
click node_account_access "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/permissions.py"
click node_account_serializers "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/serializers.py"
click node_branch_api "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/branches/views.py"
click node_order_api "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/orders/views.py"
click node_order_data "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/orders/models.py"
click node_order_serializers "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/orders/serializers.py"
click node_product_api "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/products/views.py"
click node_product_data "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/products/models.py"
click node_payroll_api "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/payroll/views.py"
click node_mongo "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/config/mongodb.py"
click node_sms "https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/sms.py"

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,node_customer_catalog,node_customer_order,node_customer_profile,node_employee_orders,node_admin_orders,node_admin_payroll,node_employee_payroll,node_api toneBlue
class node_order_api,node_order_data,node_order_serializers,node_product_api,node_product_data toneAmber
class node_account_api,node_account_data,node_account_access,node_account_serializers,node_branch_api toneMint
class node_payroll_api,node_mongo,node_sms toneRose
class node_customer,node_employee,node_administrator toneIndigo
```

## Components

### Portal frontend

- [Portal routing](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/App.jsx): `src/App.jsx`
- [Product browsing](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/customer/ProductsServices.jsx): `src/pages/customer/ProductsServices.jsx`
- [Order entry](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/components/customer/modals/NewOrderModal.jsx): `src/components/customer/modals/NewOrderModal.jsx`
- [Customer profile](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/context/CustomerProfileContext.jsx): `src/context/CustomerProfileContext.jsx`
- [Employee orders](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/employee/Orders.jsx): `src/pages/employee/Orders.jsx`
- [Admin orders](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/admin/Orders.jsx): `src/pages/admin/Orders.jsx`
- [Admin payroll](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/admin/Payroll.jsx): `src/pages/admin/Payroll.jsx`
- [Employee payroll](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/pages/employee/Payroll.jsx): `src/pages/employee/Payroll.jsx`
- [API client](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/src/utils/api.js): `src/utils/api.js`

### Order and catalog

- [Order endpoints](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/orders/views.py): `backend/orders/views.py`
- [Order models](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/orders/models.py): `backend/orders/models.py`
- [Order serializers](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/orders/serializers.py): `backend/orders/serializers.py`
- [Product endpoints](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/products/views.py): `backend/products/views.py`
- [Product models](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/products/models.py): `backend/products/models.py`

### Accounts and branches

- [Account endpoints](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/views.py): `backend/accounts/views.py`
- [Account models](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/models.py): `backend/accounts/models.py`
- [Account permissions](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/permissions.py): `backend/accounts/permissions.py`
- [Account serializers](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/serializers.py): `backend/accounts/serializers.py`
- [Branch endpoints](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/branches/views.py): `backend/branches/views.py`

### Business operations

- [Payroll endpoints](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/payroll/views.py): `backend/payroll/views.py`
- [MongoDB features](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/config/mongodb.py): `backend/config/mongodb.py`
- [SMS verification](https://github.com/angelicaorgel9-source/frontend-salestracking/blob/main/backend/accounts/sms.py): `backend/accounts/sms.py`

### Other components

- **Customer**
- **Employee**
- **Administrator**

## Connections

- Customer → Portal routing: opens portal (evidence: `src/App.jsx`)
- Employee → Portal routing: opens portal (evidence: `src/App.jsx`)
- Administrator → Portal routing: opens portal (evidence: `src/App.jsx`)
- Portal routing → Product browsing: routes to (evidence: `src/App.jsx`)
- Portal routing → Employee orders: routes to (evidence: `src/App.jsx`)
- Portal routing → Admin orders: routes to (evidence: `src/App.jsx`)
- Product browsing → Order entry: opens order (evidence: `src/pages/customer/ProductsServices.jsx`)
- Product browsing → API client: creates order (evidence: `src/pages/customer/ProductsServices.jsx`)
- Customer profile → API client: loads profile (evidence: `src/context/CustomerProfileContext.jsx`)
- Employee orders → API client: submits orders (evidence: `src/pages/employee/Orders.jsx`)
- Admin orders → API client: loads records (evidence: `src/pages/admin/Orders.jsx`)
- API client → Order endpoints: HTTP requests (evidence: `README.md`)
- API client → Account endpoints: HTTP requests (evidence: `README.md`)
- API client → Product endpoints: HTTP requests (evidence: `README.md`)
- API client → Payroll endpoints: HTTP requests (evidence: `README.md`)
- Order endpoints → Order models: uses models (evidence: `backend/orders/views.py`)
- Order endpoints → Order serializers: uses serializers (evidence: `backend/orders/views.py`)
- Order models → Product models: references products (evidence: `backend/orders/models.py`)
- Account endpoints → Account models: uses models (evidence: `backend/accounts/views.py`)
- Account endpoints → Account permissions: checks permissions (evidence: `backend/accounts/views.py`)
- Account endpoints → Account serializers: uses serializers (evidence: `backend/accounts/views.py`)
- Order endpoints → Account models: uses account data (evidence: `backend/orders/views.py`)
- Order endpoints → MongoDB features: uses MongoDB (evidence: `backend/orders/views.py`)
- Account endpoints → MongoDB features: uses MongoDB (evidence: `backend/accounts/views.py`)
- Account endpoints → SMS verification: sends verification (evidence: `backend/accounts/views.py`)
- Payroll endpoints → Employee payroll: serves employee view (evidence: `README.md`)
