# bill-dev-it/msis207_web_application_project architecture

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

- Interactive diagram: https://gitdiagram.com/bill-dev-it/msis207_web_application_project
- Repository: https://github.com/bill-dev-it/msis207_web_application_project

## Overview

AeroRUL is a B2B aviation engine and parts marketplace with buyer, supplier, and admin workflows plus RUL analysis and replacement recommendations. The main path runs from marketplace browsing and fleet management through RUL-informed replacement, cart, and checkout; suppliers maintain listings and orders, while admins oversee marketplace and payment operations. The graph includes the backend service/repository layer and the separate inference service. Several capabilities are documented in the README but their implementation was not sampled, so those subsystem links rely on that documentation rather than inspected source.

Main entry points: [`frontend/src/app/App.jsx`](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/app/App.jsx) (React application), [`backend/src/server.js`](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/server.js) (REST API), [`frontend/src/screens/buyer/MyEngines.jsx`](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/buyer/MyEngines.jsx) (Buyer fleet views), [`backend/src/controllers/buyer/rul.controller.js`](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/buyer/rul.controller.js) (RUL analysis API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_webapp["React application<br/>[App.jsx]"]
  node_publicmarket["Public marketplace<br/>[Marketplace.jsx]"]
  node_buyerfleetui["Buyer fleet views<br/>[MyEngines.jsx]"]
  node_checkoutui["Buyer checkout"]
  node_supplierui["Supplier workspace<br/>[SupplierHome.jsx]"]
  node_adminui["Admin console"]
end

subgraph group_marketplace["Marketplace API"]
  node_backendapi["REST API<br/>[server.js]"]
  node_auth["Authentication"]
  node_products["Product catalog"]
  node_publiclistings["Public listings"]
  node_supplierops["Supplier listings and orders"]
  node_adminops["Admin operations"]
end

subgraph group_fleet["Fleet and RUL"]
  node_fleetapi["Buyer fleet API"]
  node_fleetservice["Fleet domain service<br/>[engines.service.js]"]
  node_fleetrepo["Fleet data repository"]
  node_rulapi["RUL analysis API<br/>[rul.controller.js]"]
  node_recommendations["Replacement recommendations"]
end

subgraph group_operations["Commerce operations"]
  node_commerce["Cart and checkout"]
  node_orders["Order management"]
  node_database[("PostgreSQL<br/>[db.js]")]
end

subgraph group_inference["RUL inference"]
  node_rulbackend["Inference integration"]
  node_rulservice["RUL inference API<br/>[api.py]"]
  node_preprocess["Sensor preprocessing<br/>[preprocessor.py]"]
  node_runner["Prediction runner<br/>[runner.py]"]
end

node_visitor(("Marketplace user"))

node_visitor -->|"uses"| node_webapp
node_webapp -->|"calls REST API"| node_backendapi
node_webapp -->|"renders"| node_publicmarket
node_webapp -->|"renders"| node_buyerfleetui
node_webapp -.->|"renders"| node_checkoutui
node_webapp -.->|"renders"| node_supplierui
node_webapp -.->|"renders"| node_adminui
node_publicmarket -.->|"requests catalog"| node_products
node_backendapi -.->|"routes requests"| node_auth
node_backendapi -->|"routes requests"| node_products
node_backendapi -->|"routes requests"| node_publiclistings
node_backendapi -->|"routes requests"| node_fleetapi
node_fleetapi -->|"calls"| node_fleetservice
node_fleetservice -->|"delegates"| node_fleetrepo
node_fleetrepo -->|"queries"| node_database
node_buyerfleetui -->|"loads fleet"| node_fleetapi
node_backendapi -.->|"routes RUL requests"| node_rulapi
node_rulapi -.->|"requests inference"| node_rulbackend
node_rulbackend -->|"calls inference"| node_rulservice
node_rulservice -->|"preprocesses sensors"| node_preprocess
node_rulservice -->|"runs prediction"| node_runner
node_runner -->|"uses preprocessing"| node_preprocess
node_rulapi -.->|"offers replacements"| node_recommendations
node_buyerfleetui -.->|"uses Replace and Buy"| node_recommendations
node_checkoutui -.->|"submits checkout"| node_commerce
node_commerce -.->|"creates orders"| node_orders
node_supplierui -.->|"manages listings"| node_supplierops
node_adminui -.->|"manages marketplace"| node_adminops
node_products -->|"queries catalog"| node_database

click node_webapp "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/app/App.jsx"
click node_publicmarket "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/public/Marketplace.jsx"
click node_buyerfleetui "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/buyer/MyEngines.jsx"
click node_checkoutui "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/buyer/CheckoutReviewPage.jsx"
click node_supplierui "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/supplier/SupplierHome.jsx"
click node_adminui "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/admin/AdminDashboardLive.jsx"
click node_backendapi "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/server.js"
click node_auth "https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/auth"
click node_products "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/product.controller.js"
click node_publiclistings "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/public-listing.controller.js"
click node_supplierops "https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/supplier"
click node_adminops "https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/admin"
click node_fleetapi "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/buyer/engines.controller.js"
click node_fleetservice "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/buyer/engines.service.js"
click node_fleetrepo "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/buyer/engines.repository.js"
click node_rulapi "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/buyer/rul.controller.js"
click node_recommendations "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/buyer/rul/replacement-recommendations.service.js"
click node_commerce "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/buyer/checkout.controller.js"
click node_orders "https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/buyer/orders"
click node_database "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/config/db.js"
click node_rulbackend "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/rul-inference.service.js"
click node_rulservice "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/rul-service/api.py"
click node_preprocess "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/rul-service/preprocessing/preprocessor.py"
click node_runner "https://github.com/bill-dev-it/msis207_web_application_project/blob/main/rul-service/inference/runner.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_webapp,node_publicmarket,node_buyerfleetui,node_checkoutui,node_supplierui,node_adminui,node_visitor toneBlue
class node_backendapi,node_auth,node_products,node_publiclistings,node_supplierops,node_adminops toneAmber
class node_fleetapi,node_fleetservice,node_fleetrepo,node_rulapi,node_recommendations toneMint
class node_commerce,node_orders,node_database toneRose
class node_rulbackend,node_rulservice,node_preprocess,node_runner toneIndigo
```

## Components

### Web experience

- [React application](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/app/App.jsx): `frontend/src/app/App.jsx`
- [Public marketplace](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/public/Marketplace.jsx): `frontend/src/screens/public/Marketplace.jsx`
- [Buyer fleet views](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/buyer/MyEngines.jsx): `frontend/src/screens/buyer/MyEngines.jsx`
- [Buyer checkout](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/buyer/CheckoutReviewPage.jsx): `frontend/src/screens/buyer/CheckoutReviewPage.jsx`
- [Supplier workspace](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/supplier/SupplierHome.jsx): `frontend/src/screens/supplier/SupplierHome.jsx`
- [Admin console](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/frontend/src/screens/admin/AdminDashboardLive.jsx): `frontend/src/screens/admin/AdminDashboardLive.jsx`

### Marketplace API

- [REST API](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/server.js): `backend/src/server.js`
- [Authentication](https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/auth): `backend/src/controllers/auth`
- [Product catalog](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/product.controller.js): `backend/src/controllers/product.controller.js`
- [Public listings](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/public-listing.controller.js): `backend/src/controllers/public-listing.controller.js`
- [Supplier listings and orders](https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/supplier): `backend/src/controllers/supplier`
- [Admin operations](https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/admin): `backend/src/controllers/admin`

### Fleet and RUL

- [Buyer fleet API](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/buyer/engines.controller.js): `backend/src/controllers/buyer/engines.controller.js`
- [Fleet domain service](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/buyer/engines.service.js): `backend/src/services/buyer/engines.service.js`
- [Fleet data repository](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/buyer/engines.repository.js): `backend/src/services/buyer/engines.repository.js`
- [RUL analysis API](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/buyer/rul.controller.js): `backend/src/controllers/buyer/rul.controller.js`
- [Replacement recommendations](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/buyer/rul/replacement-recommendations.service.js): `backend/src/services/buyer/rul/replacement-recommendations.service.js`

### Commerce operations

- [Cart and checkout](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/controllers/buyer/checkout.controller.js): `backend/src/controllers/buyer/checkout.controller.js`
- [Order management](https://github.com/bill-dev-it/msis207_web_application_project/tree/main/backend/src/controllers/buyer/orders): `backend/src/controllers/buyer/orders`
- [PostgreSQL](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/config/db.js): `backend/src/config/db.js`

### RUL inference

- [Inference integration](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/backend/src/services/rul-inference.service.js): `backend/src/services/rul-inference.service.js`
- [RUL inference API](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/rul-service/api.py): `rul-service/api.py`
- [Sensor preprocessing](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/rul-service/preprocessing/preprocessor.py): `rul-service/preprocessing/preprocessor.py`
- [Prediction runner](https://github.com/bill-dev-it/msis207_web_application_project/blob/main/rul-service/inference/runner.py): `rul-service/inference/runner.py`

### Other components

- **Marketplace user**

## Connections

- Marketplace user → React application: uses (evidence: `README.md`)
- React application → REST API: calls REST API (evidence: `README.md`)
- React application → Public marketplace: renders
- React application → Buyer fleet views: renders
- React application → Buyer checkout: renders
- React application → Supplier workspace: renders
- React application → Admin console: renders
- Public marketplace → Product catalog: requests catalog
- REST API → Authentication: routes requests
- REST API → Product catalog: routes requests
- REST API → Public listings: routes requests
- REST API → Buyer fleet API: routes requests
- Buyer fleet API → Fleet domain service: calls (evidence: `backend/src/controllers/buyer/engines.controller.js`)
- Fleet domain service → Fleet data repository: delegates (evidence: `backend/src/services/buyer/engines.service.js`)
- Fleet data repository → PostgreSQL: queries (evidence: `backend/src/services/buyer/engines.repository.js`)
- Buyer fleet views → Buyer fleet API: loads fleet
- REST API → RUL analysis API: routes RUL requests
- RUL analysis API → Inference integration: requests inference
- Inference integration → RUL inference API: calls inference (evidence: `README.md`)
- RUL inference API → Sensor preprocessing: preprocesses sensors (evidence: `rul-service/api.py`)
- RUL inference API → Prediction runner: runs prediction (evidence: `rul-service/api.py`)
- Prediction runner → Sensor preprocessing: uses preprocessing (evidence: `rul-service/inference/runner.py`)
- RUL analysis API → Replacement recommendations: offers replacements
- Buyer fleet views → Replacement recommendations: uses Replace and Buy
- Buyer checkout → Cart and checkout: submits checkout
- Cart and checkout → Order management: creates orders
- Supplier workspace → Supplier listings and orders: manages listings
- Admin console → Admin operations: manages marketplace
- Product catalog → PostgreSQL: queries catalog
