# pipaliyameet/stockwise-insights architecture

> Architecture diagram of the GitHub repository pipaliyameet/stockwise-insights, 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/pipaliyameet/stockwise-insights
- Repository: https://github.com/pipaliyameet/stockwise-insights

## Overview

StockWise is a stock-market analysis and prediction application. Users explore stock data and analytical views or request a next-day forecast; the prediction workflow fetches historical prices, prepares features, trains price and direction models, and returns results with history and evaluation metrics. The repository contains both a Python ML service behind an Express API and a frontend-side API handler with a JavaScript prediction engine. The README documents dashboard capabilities, but unsampled route and service code limits which frontend-to-API connections can be verified.

Main entry points: [`ml-service/prediction_service.py`](https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/prediction_service.py) (Prediction orchestration), [`backEnd/controllers/predictionController.js`](https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/controllers/predictionController.js) (Prediction controller), [`frontEnd/src/lib/api-handler.ts`](https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/lib/api-handler.ts) (Frontend API handler), [`frontEnd/src/lib/ml-engine.ts`](https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/lib/ml-engine.ts) (JavaScript ML engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_pages["Analysis pages"]
  node_router["Route setup<br/>[router.tsx]"]
  node_browser_api["Frontend API handler<br/>[api-handler.ts]"]
  node_js_engine["JavaScript ML engine<br/>[ml-engine.ts]"]
  node_web_server["Frontend server<br/>[server.ts]"]
end

subgraph group_api["API and persistence"]
  node_express["Express server<br/>[server.js]"]
  node_routes["Prediction routes"]
  node_controller["Prediction controller"]
  node_db_config["Database connection<br/>[db.js]"]
  node_record[("Prediction records<br/>[predictionModel.js]")]
end

subgraph group_ml["Prediction pipeline"]
  node_ml_server["Python ML server<br/>[ml_server.py]"]
  node_pipeline["Prediction orchestration"]
  node_data_loader["Market data loading<br/>[data_loader.py]"]
  node_preprocess["Data preprocessing<br/>[preprocessing.py]"]
  node_linear["Linear regression"]
  node_knn["KNN classification<br/>[knn_classifier.py]"]
end

node_user(("StockWise user"))
node_market_data[("Yahoo market data")]
node_mongo[("MongoDB")]

node_router -->|"loads routes"| node_pages
node_user -.->|"explores"| node_pages
node_web_server -->|"dispatches API"| node_browser_api
node_browser_api -->|"runs fallback"| node_js_engine
node_js_engine -->|"fetches prices"| node_market_data
node_express -->|"mounts routes"| node_routes
node_routes -->|"routes requests"| node_controller
node_controller -->|"requests predictions"| node_ml_server
node_controller -->|"connects database"| node_db_config
node_controller -->|"saves and queries"| node_record
node_db_config -->|"connects"| node_mongo
node_ml_server -->|"runs pipeline"| node_pipeline
node_pipeline -->|"loads history"| node_data_loader
node_pipeline -->|"prepares features"| node_preprocess
node_pipeline -->|"trains and predicts"| node_linear
node_pipeline -->|"classifies direction"| node_knn
node_data_loader -.->|"fetches prices"| node_market_data

click node_pages "https://github.com/pipaliyameet/stockwise-insights/tree/main/frontEnd/src/routes"
click node_router "https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/router.tsx"
click node_browser_api "https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/lib/api-handler.ts"
click node_js_engine "https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/lib/ml-engine.ts"
click node_web_server "https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/server.ts"
click node_express "https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/server.js"
click node_routes "https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/routes/predictionRoutes.js"
click node_controller "https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/controllers/predictionController.js"
click node_db_config "https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/config/db.js"
click node_record "https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/models/predictionModel.js"
click node_ml_server "https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/ml_server.py"
click node_pipeline "https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/prediction_service.py"
click node_data_loader "https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/data_loader.py"
click node_preprocess "https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/preprocessing.py"
click node_linear "https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/linear_regression.py"
click node_knn "https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/knn_classifier.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_pages,node_router,node_browser_api,node_js_engine,node_web_server,node_user toneBlue
class node_express,node_routes,node_controller,node_db_config,node_record,node_market_data,node_mongo toneAmber
class node_ml_server,node_pipeline,node_data_loader,node_preprocess,node_linear,node_knn toneMint
```

## Components

### Frontend experience

- [Analysis pages](https://github.com/pipaliyameet/stockwise-insights/tree/main/frontEnd/src/routes): `frontEnd/src/routes`
- [Route setup](https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/router.tsx): `frontEnd/src/router.tsx`
- [Frontend API handler](https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/lib/api-handler.ts): `frontEnd/src/lib/api-handler.ts`
- [JavaScript ML engine](https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/lib/ml-engine.ts): `frontEnd/src/lib/ml-engine.ts`
- [Frontend server](https://github.com/pipaliyameet/stockwise-insights/blob/main/frontEnd/src/server.ts): `frontEnd/src/server.ts`

### API and persistence

- [Express server](https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/server.js): `backEnd/server.js`
- [Prediction routes](https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/routes/predictionRoutes.js): `backEnd/routes/predictionRoutes.js`
- [Prediction controller](https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/controllers/predictionController.js): `backEnd/controllers/predictionController.js`
- [Database connection](https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/config/db.js): `backEnd/config/db.js`
- [Prediction records](https://github.com/pipaliyameet/stockwise-insights/blob/main/backEnd/models/predictionModel.js): `backEnd/models/predictionModel.js`

### Prediction pipeline

- [Python ML server](https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/ml_server.py): `ml-service/ml_server.py`
- [Prediction orchestration](https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/prediction_service.py): `ml-service/prediction_service.py`
- [Market data loading](https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/data_loader.py): `ml-service/data_loader.py`
- [Data preprocessing](https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/preprocessing.py): `ml-service/preprocessing.py`
- [Linear regression](https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/linear_regression.py): `ml-service/linear_regression.py`
- [KNN classification](https://github.com/pipaliyameet/stockwise-insights/blob/main/ml-service/knn_classifier.py): `ml-service/knn_classifier.py`

### Other components

- **StockWise user**
- **Yahoo market data**
- **MongoDB**

## Connections

- Route setup → Analysis pages: loads routes (evidence: `frontEnd/src/router.tsx`)
- StockWise user → Analysis pages: explores
- Frontend server → Frontend API handler: dispatches API (evidence: `frontEnd/src/server.ts`)
- Frontend API handler → JavaScript ML engine: runs fallback (evidence: `frontEnd/src/lib/api-handler.ts`)
- JavaScript ML engine → Yahoo market data: fetches prices (evidence: `frontEnd/src/lib/ml-engine.ts`)
- Express server → Prediction routes: mounts routes (evidence: `backEnd/server.js`)
- Prediction routes → Prediction controller: routes requests (evidence: `backEnd/routes/predictionRoutes.js`)
- Prediction controller → Python ML server: requests predictions (evidence: `backEnd/controllers/predictionController.js`)
- Prediction controller → Database connection: connects database (evidence: `backEnd/controllers/predictionController.js`)
- Prediction controller → Prediction records: saves and queries (evidence: `backEnd/controllers/predictionController.js`)
- Database connection → MongoDB: connects (evidence: `backEnd/config/db.js`)
- Python ML server → Prediction orchestration: runs pipeline (evidence: `ml-service/ml_server.py`)
- Prediction orchestration → Market data loading: loads history (evidence: `ml-service/prediction_service.py`)
- Prediction orchestration → Data preprocessing: prepares features (evidence: `ml-service/prediction_service.py`)
- Prediction orchestration → Linear regression: trains and predicts (evidence: `ml-service/prediction_service.py`)
- Prediction orchestration → KNN classification: classifies direction (evidence: `ml-service/prediction_service.py`)
- Market data loading → Yahoo market data: fetches prices
