# wijdanebassiry/lab2 architecture

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

- Interactive diagram: https://gitdiagram.com/wijdanebassiry/lab2
- Repository: https://github.com/wijdanebassiry/lab2

## Overview

MSOA Shop is a microservice-backed storefront. A customer browses products, manages a cart, signs in, checks out, and follows orders and shipments; the frontend routes those experiences and calls service APIs. Backend services separate identity, catalog, stock, orders, payments, and shipment lifecycle. The sampled sources show frontend authentication and API plumbing, inventory and payment route delegation, and shipping orchestration. Several page and service implementations were not sampled, so their internal calls and some cross-service links are omitted or marked unverified.

Main entry points: [`front/src/App.jsx`](https://github.com/wijdanebassiry/lab2/blob/main/front/src/App.jsx) (App Routes), [`front/src/services/apiClient.js`](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/apiClient.js) (API Client), [`front/src/services/orderService.js`](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/orderService.js) (Order Client), [`msoa-backend/payments-service/app/routes.py`](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/routes.py) (Payment Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["App Routes<br/>[App.jsx]"]
  node_products["Product Browse<br/>[Products.jsx]"]
  node_cart["Cart<br/>[Cart.jsx]"]
  node_checkout["Checkout<br/>[Checkout.jsx]"]
  node_orderspage["Order History<br/>[Orders.jsx]"]
  node_account["Account<br/>[Account.jsx]"]
  node_authpage["Sign In<br/>[Login.jsx]"]
end

subgraph group_frontend["Frontend Services"]
  node_authstate["Auth State<br/>[AuthContext.jsx]"]
  node_cartstate["Cart State<br/>[CartContext.jsx]"]
  node_authclient["Auth Client<br/>[authService.js]"]
  node_api["API Client<br/>[apiClient.js]"]
  node_endpoints["Backend Endpoints<br/>[backend.js]"]
  node_catalogclient["Catalog Client<br/>[catalogService.js]"]
  node_inventoryclient["Inventory Client"]
  node_orderclient["Order Client<br/>[orderService.js]"]
  node_paymentclient["Payment Client<br/>[paymentService.js]"]
  node_shippingclient["Shipping Client<br/>[shippingService.js]"]
end

subgraph group_commerce["Commerce Services"]
  node_catalogbackend["Catalog API<br/>[server.js]"]
  node_inventoryroutes["Inventory Routes<br/>[routes.py]"]
  node_inventorylogic["Stock Logic<br/>[service.py]"]
  node_inventorydb[("Inventory Store<br/>[database.py]")]
  node_ordersbackend["Orders API<br/>[server.js]"]
  node_paymentroutes["Payment Routes<br/>[routes.py]"]
  node_paymentlogic["Payment Logic<br/>[service.py]"]
  node_paymentdb[("Payment Store<br/>[database.py]")]
  node_gateway["Simulated Gateway<br/>[simulated.py]"]
end

subgraph group_fulfillment["Fulfillment Services"]
  node_shipmentcontroller["Shipment API"]
  node_shipmentlogic["Shipment Logic"]
  node_shipmentrepo[("Shipment Store")]
  node_orderverify["Order Client<br/>[OrderClient.java]"]
end

subgraph group_identity["Identity"]
  node_authbackend["Accounts API<br/>[views.py]"]
  node_authverify["Token Client<br/>[AuthClient.java]"]
  node_authfilter["JWT Filter"]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_app
node_app -->|"routes"| node_products
node_app -->|"routes"| node_cart
node_app -->|"routes"| node_checkout
node_app -->|"routes"| node_orderspage
node_app -->|"routes"| node_authpage
node_app -->|"routes"| node_account
node_authstate -->|"calls"| node_authclient
node_authclient -->|"calls"| node_api
node_authclient -->|"reads URLs"| node_endpoints
node_catalogclient -->|"calls"| node_api
node_inventoryclient -->|"calls"| node_api
node_inventoryclient -->|"reads URLs"| node_endpoints
node_orderclient -->|"calls"| node_api
node_orderclient -->|"calls"| node_inventoryclient
node_orderclient -->|"calls"| node_shippingclient
node_shippingclient -->|"calls"| node_api
node_paymentclient -.->|"calls"| node_api
node_inventoryroutes -->|"delegates"| node_inventorylogic
node_inventoryroutes -->|"queries"| node_inventorydb
node_paymentroutes -->|"delegates"| node_paymentlogic
node_paymentroutes -->|"queries"| node_paymentdb
node_paymentroutes -->|"passes gateway"| node_gateway
node_shipmentcontroller -->|"calls"| node_shipmentlogic
node_shipmentlogic -->|"reads and writes"| node_shipmentrepo
node_shipmentlogic -->|"verifies orders"| node_orderverify
node_authfilter -->|"verifies token"| node_authverify
node_shipmentcontroller -->|"gets authorization"| node_authfilter
node_orderverify -.->|"HTTP checks"| node_ordersbackend
node_authverify -.->|"HTTP verifies"| node_authbackend
node_checkout -.->|"submits order"| node_orderclient
node_checkout -.->|"requests payment"| node_paymentclient
node_orderspage -.->|"loads tracking"| node_shippingclient

click node_app "https://github.com/wijdanebassiry/lab2/blob/main/front/src/App.jsx"
click node_products "https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Products.jsx"
click node_cart "https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Cart.jsx"
click node_checkout "https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Checkout.jsx"
click node_orderspage "https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Orders.jsx"
click node_account "https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Account.jsx"
click node_authpage "https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Login.jsx"
click node_authstate "https://github.com/wijdanebassiry/lab2/blob/main/front/src/context/AuthContext.jsx"
click node_cartstate "https://github.com/wijdanebassiry/lab2/blob/main/front/src/context/CartContext.jsx"
click node_authclient "https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/authService.js"
click node_api "https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/apiClient.js"
click node_endpoints "https://github.com/wijdanebassiry/lab2/blob/main/front/src/config/backend.js"
click node_catalogclient "https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/catalogService.js"
click node_inventoryclient "https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/inventoryService.js"
click node_orderclient "https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/orderService.js"
click node_paymentclient "https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/paymentService.js"
click node_shippingclient "https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/shippingService.js"
click node_authbackend "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/auth-service/accounts/views.py"
click node_catalogbackend "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/catalog-service/server.js"
click node_inventoryroutes "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/inventory-service/app/routes.py"
click node_inventorylogic "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/inventory-service/app/service.py"
click node_inventorydb "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/inventory-service/app/database.py"
click node_ordersbackend "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/orders-service/server.js"
click node_paymentroutes "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/routes.py"
click node_paymentlogic "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/service.py"
click node_paymentdb "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/database.py"
click node_gateway "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/gateway/simulated.py"
click node_shipmentcontroller "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/controller/ShipmentController.java"
click node_shipmentlogic "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/service/ShipmentService.java"
click node_shipmentrepo "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/repository/ShipmentRepository.java"
click node_orderverify "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/client/OrderClient.java"
click node_authverify "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/client/AuthClient.java"
click node_authfilter "https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/security/JwtAuthenticationFilter.java"

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_products,node_cart,node_checkout,node_orderspage,node_account,node_authpage toneBlue
class node_authstate,node_cartstate,node_authclient,node_api,node_endpoints,node_catalogclient,node_inventoryclient,node_orderclient,node_paymentclient,node_shippingclient toneAmber
class node_catalogbackend,node_inventoryroutes,node_inventorylogic,node_inventorydb,node_ordersbackend,node_paymentroutes,node_paymentlogic,node_paymentdb,node_gateway toneMint
class node_shipmentcontroller,node_shipmentlogic,node_shipmentrepo,node_orderverify toneRose
class node_authbackend,node_authverify,node_authfilter,node_customer toneIndigo
```

## Components

### Storefront

- [App Routes](https://github.com/wijdanebassiry/lab2/blob/main/front/src/App.jsx): `front/src/App.jsx`
- [Product Browse](https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Products.jsx): `front/src/pages/Products.jsx`
- [Cart](https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Cart.jsx): `front/src/pages/Cart.jsx`
- [Checkout](https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Checkout.jsx): `front/src/pages/Checkout.jsx`
- [Order History](https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Orders.jsx): `front/src/pages/Orders.jsx`
- [Account](https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Account.jsx): `front/src/pages/Account.jsx`
- [Sign In](https://github.com/wijdanebassiry/lab2/blob/main/front/src/pages/Login.jsx): `front/src/pages/Login.jsx`

### Frontend Services

- [Auth State](https://github.com/wijdanebassiry/lab2/blob/main/front/src/context/AuthContext.jsx): `front/src/context/AuthContext.jsx`
- [Cart State](https://github.com/wijdanebassiry/lab2/blob/main/front/src/context/CartContext.jsx): `front/src/context/CartContext.jsx`
- [Auth Client](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/authService.js): `front/src/services/authService.js`
- [API Client](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/apiClient.js): `front/src/services/apiClient.js`
- [Backend Endpoints](https://github.com/wijdanebassiry/lab2/blob/main/front/src/config/backend.js): `front/src/config/backend.js`
- [Catalog Client](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/catalogService.js): `front/src/services/catalogService.js`
- [Inventory Client](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/inventoryService.js): `front/src/services/inventoryService.js`
- [Order Client](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/orderService.js): `front/src/services/orderService.js`
- [Payment Client](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/paymentService.js): `front/src/services/paymentService.js`
- [Shipping Client](https://github.com/wijdanebassiry/lab2/blob/main/front/src/services/shippingService.js): `front/src/services/shippingService.js`

### Commerce Services

- [Catalog API](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/catalog-service/server.js): `msoa-backend/catalog-service/server.js`
- [Inventory Routes](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/inventory-service/app/routes.py): `msoa-backend/inventory-service/app/routes.py`
- [Stock Logic](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/inventory-service/app/service.py): `msoa-backend/inventory-service/app/service.py`
- [Inventory Store](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/inventory-service/app/database.py): `msoa-backend/inventory-service/app/database.py`
- [Orders API](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/orders-service/server.js): `msoa-backend/orders-service/server.js`
- [Payment Routes](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/routes.py): `msoa-backend/payments-service/app/routes.py`
- [Payment Logic](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/service.py): `msoa-backend/payments-service/app/service.py`
- [Payment Store](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/database.py): `msoa-backend/payments-service/app/database.py`
- [Simulated Gateway](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/payments-service/app/gateway/simulated.py): `msoa-backend/payments-service/app/gateway/simulated.py`

### Fulfillment Services

- [Shipment API](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/controller/ShipmentController.java): `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/controller/ShipmentController.java`
- [Shipment Logic](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/service/ShipmentService.java): `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/service/ShipmentService.java`
- [Shipment Store](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/repository/ShipmentRepository.java): `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/repository/ShipmentRepository.java`
- [Order Client](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/client/OrderClient.java): `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/client/OrderClient.java`

### Identity

- [Accounts API](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/auth-service/accounts/views.py): `msoa-backend/auth-service/accounts/views.py`
- [Token Client](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/client/AuthClient.java): `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/client/AuthClient.java`
- [JWT Filter](https://github.com/wijdanebassiry/lab2/blob/main/msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/security/JwtAuthenticationFilter.java): `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/security/JwtAuthenticationFilter.java`

### Other components

- **Customer**

## Connections

- Customer → App Routes: uses
- App Routes → Product Browse: routes (evidence: `front/src/App.jsx`)
- App Routes → Cart: routes (evidence: `front/src/App.jsx`)
- App Routes → Checkout: routes (evidence: `front/src/App.jsx`)
- App Routes → Order History: routes (evidence: `front/src/App.jsx`)
- App Routes → Sign In: routes (evidence: `front/src/App.jsx`)
- App Routes → Account: routes (evidence: `front/src/App.jsx`)
- Auth State → Auth Client: calls (evidence: `front/src/context/AuthContext.jsx`)
- Auth Client → API Client: calls (evidence: `front/src/services/authService.js`)
- Auth Client → Backend Endpoints: reads URLs (evidence: `front/src/services/authService.js`)
- Catalog Client → API Client: calls
- Inventory Client → API Client: calls (evidence: `front/src/services/inventoryService.js`)
- Inventory Client → Backend Endpoints: reads URLs (evidence: `front/src/services/inventoryService.js`)
- Order Client → API Client: calls (evidence: `front/src/services/orderService.js`)
- Order Client → Inventory Client: calls (evidence: `front/src/services/orderService.js`)
- Order Client → Shipping Client: calls (evidence: `front/src/services/orderService.js`)
- Shipping Client → API Client: calls (evidence: `front/src/services/shippingService.js`)
- Payment Client → API Client: calls
- Inventory Routes → Stock Logic: delegates (evidence: `msoa-backend/inventory-service/app/routes.py`)
- Inventory Routes → Inventory Store: queries (evidence: `msoa-backend/inventory-service/app/routes.py`)
- Payment Routes → Payment Logic: delegates (evidence: `msoa-backend/payments-service/app/routes.py`)
- Payment Routes → Payment Store: queries (evidence: `msoa-backend/payments-service/app/routes.py`)
- Payment Routes → Simulated Gateway: passes gateway (evidence: `msoa-backend/payments-service/app/routes.py`)
- Shipment API → Shipment Logic: calls (evidence: `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/controller/ShipmentController.java`)
- Shipment Logic → Shipment Store: reads and writes (evidence: `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/service/ShipmentService.java`)
- Shipment Logic → Order Client: verifies orders (evidence: `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/service/ShipmentService.java`)
- JWT Filter → Token Client: verifies token (evidence: `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/security/JwtAuthenticationFilter.java`)
- Shipment API → JWT Filter: gets authorization (evidence: `msoa-backend/shipping-service/src/main/java/com/msoa/shipping_service/controller/ShipmentController.java`)
- Order Client → Orders API: HTTP checks
- Token Client → Accounts API: HTTP verifies
- Checkout → Order Client: submits order
- Checkout → Payment Client: requests payment
- Order History → Shipping Client: loads tracking
