# adhavan13/hackitfintech architecture

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

- Interactive diagram: https://gitdiagram.com/adhavan13/hackitfintech
- Repository: https://github.com/adhavan13/hackitfintech

## Overview

Growth Guardian is a financial education and planning application. Users enter through the web app and navigate to a dashboard, learning modules, calculators, investment tools, and scam-prevention features; asset forecasting also requests predictions from a Python backend. The graph preserves the major frontend capabilities listed in the source index. Backend internals and several frontend modules were not excerpted, so their implementation-level connections are omitted unless the shown routing or requests establish them.

Main entry points: [`frontend/src/App.jsx`](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/App.jsx) (Web App Router), [`frontend/src/AssetForecast/AssetReturnForecast.jsx`](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/AssetForecast/AssetReturnForecast.jsx) (Asset Forecast), [`frontend/src/StockBot/stockbot.jsx`](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/StockBot/stockbot.jsx) (Stock Bot), [`frontend/src/FloatingChatbot/Floating.jsx`](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/FloatingChatbot/Floating.jsx) (Floating Chatbot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_webapp["Web App Router<br/>[App.jsx]"]
  node_landing["Landing Page<br/>[LandingPage.jsx]"]
  node_login["Login Page<br/>[LoginPage.jsx]"]
end

subgraph group_finance["Planning And Investing"]
  node_dashboard["Finance Dashboard<br/>[dashboards.jsx]"]
  node_budget["Budget Planner<br/>[BudgetPlanner.jsx]"]
  node_investdebt["Invest Or Repay"]
  node_retirement["Retirement Planner"]
  node_stockanalysis["Stock Analysis<br/>[stockanalysis.jsx]"]
  node_stockchart["Stock Chart<br/>[stockchart.jsx]"]
  node_forecast["Asset Forecast"]
end

subgraph group_education["Learning And Safety"]
  node_learning["Learning Modules"]
  node_scamcheck["Scam Prevention<br/>[scamprevention.jsx]"]
  node_scamarticle["Scam Articles"]
  node_stockbot["Stock Bot<br/>[stockbot.jsx]"]
  node_chatbot["Floating Chatbot<br/>[Floating.jsx]"]
end

subgraph group_services["Forecast Services"]
  node_backendapp["Prediction API<br/>[app.py]"]
  node_backendlogic["Backend Logic<br/>[backend.py]"]
  node_datafetch["Market Data Fetch<br/>[data_fetch.py]"]
  node_modeltrain["Model Training<br/>[model_train.py]"]
  node_marketfiles["Market Data Files"]
  node_model["Trained Model<br/>[AAPL_model.pkl]"]
end

node_user(("User"))
node_fundservice["Fund Analyzer API"]
node_chatservice["Chat API"]
node_scamservice["Scam Detector API"]

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_landing
node_webapp -.->|"routes to"| node_login
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_budget
node_webapp -->|"routes to"| node_learning
node_webapp -->|"routes to"| node_investdebt
node_webapp -->|"routes to"| node_retirement
node_webapp -->|"routes to"| node_scamcheck
node_webapp -->|"routes to"| node_scamarticle
node_webapp -.->|"routes to"| node_stockanalysis
node_webapp -.->|"routes to"| node_stockchart
node_webapp -.->|"routes to"| node_forecast
node_webapp -.->|"routes to"| node_stockbot
node_webapp -.->|"routes to"| node_chatbot
node_forecast -->|"requests prediction"| node_backendapp
node_forecast -.->|"requests analysis"| node_fundservice
node_chatbot -->|"sends chat"| node_chatservice
node_stockbot -->|"submits files"| node_scamservice

click node_webapp "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/App.jsx"
click node_landing "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/LandingPage/LandingPage.jsx"
click node_login "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/LoginPage/LoginPage.jsx"
click node_dashboard "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/Dashboard/dashboards.jsx"
click node_budget "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/CalculationTools/BudgetPlanner.jsx"
click node_investdebt "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/CalculationTools/InvestmentVsDebtRepayment.jsx"
click node_retirement "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/CalculationTools/RetirementPlanner.jsx"
click node_stockanalysis "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/StocksAnalysis/stockanalysis.jsx"
click node_stockchart "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/StocksAnalysis/stockchart.jsx"
click node_forecast "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/AssetForecast/AssetReturnForecast.jsx"
click node_learning "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/LearningModules/LearningModulesNew.jsx"
click node_scamcheck "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/ScamPreventionBot/scamprevention.jsx"
click node_scamarticle "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/ScamPreventionBot/scampreventionarticle.jsx"
click node_stockbot "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/StockBot/stockbot.jsx"
click node_chatbot "https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/FloatingChatbot/Floating.jsx"
click node_backendapp "https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/app.py"
click node_backendlogic "https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/backend.py"
click node_datafetch "https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/data_fetch.py"
click node_modeltrain "https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/model_train.py"
click node_marketfiles "https://github.com/adhavan13/hackitfintech/tree/main/asset-backend"
click node_model "https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/AAPL_model.pkl"

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_landing,node_login,node_user toneBlue
class node_dashboard,node_budget,node_investdebt,node_retirement,node_stockanalysis,node_stockchart,node_forecast toneAmber
class node_learning,node_scamcheck,node_scamarticle,node_stockbot,node_chatbot,node_fundservice,node_chatservice,node_scamservice toneMint
class node_backendapp,node_backendlogic,node_datafetch,node_modeltrain,node_marketfiles,node_model toneRose
```

## Components

### Application

- [Web App Router](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Landing Page](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/LandingPage/LandingPage.jsx): `frontend/src/LandingPage/LandingPage.jsx`
- [Login Page](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/LoginPage/LoginPage.jsx): `frontend/src/LoginPage/LoginPage.jsx`

### Planning And Investing

- [Finance Dashboard](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/Dashboard/dashboards.jsx): `frontend/src/Dashboard/dashboards.jsx`
- [Budget Planner](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/CalculationTools/BudgetPlanner.jsx): `frontend/src/CalculationTools/BudgetPlanner.jsx`
- [Invest Or Repay](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/CalculationTools/InvestmentVsDebtRepayment.jsx): `frontend/src/CalculationTools/InvestmentVsDebtRepayment.jsx`
- [Retirement Planner](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/CalculationTools/RetirementPlanner.jsx): `frontend/src/CalculationTools/RetirementPlanner.jsx`
- [Stock Analysis](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/StocksAnalysis/stockanalysis.jsx): `frontend/src/StocksAnalysis/stockanalysis.jsx`
- [Stock Chart](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/StocksAnalysis/stockchart.jsx): `frontend/src/StocksAnalysis/stockchart.jsx`
- [Asset Forecast](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/AssetForecast/AssetReturnForecast.jsx): `frontend/src/AssetForecast/AssetReturnForecast.jsx`

### Learning And Safety

- [Learning Modules](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/LearningModules/LearningModulesNew.jsx): `frontend/src/LearningModules/LearningModulesNew.jsx`
- [Scam Prevention](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/ScamPreventionBot/scamprevention.jsx): `frontend/src/ScamPreventionBot/scamprevention.jsx`
- [Scam Articles](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/ScamPreventionBot/scampreventionarticle.jsx): `frontend/src/ScamPreventionBot/scampreventionarticle.jsx`
- [Stock Bot](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/StockBot/stockbot.jsx): `frontend/src/StockBot/stockbot.jsx`
- [Floating Chatbot](https://github.com/adhavan13/hackitfintech/blob/main/frontend/src/FloatingChatbot/Floating.jsx): `frontend/src/FloatingChatbot/Floating.jsx`

### Forecast Services

- [Prediction API](https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/app.py): `asset-backend/app.py`
- [Backend Logic](https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/backend.py): `asset-backend/backend.py`
- [Market Data Fetch](https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/data_fetch.py): `asset-backend/data_fetch.py`
- [Model Training](https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/model_train.py): `asset-backend/model_train.py`
- [Market Data Files](https://github.com/adhavan13/hackitfintech/tree/main/asset-backend): `asset-backend`
- [Trained Model](https://github.com/adhavan13/hackitfintech/blob/main/asset-backend/AAPL_model.pkl): `asset-backend/AAPL_model.pkl`

### Other components

- **User**
- **Fund Analyzer API**
- **Chat API**
- **Scam Detector API**

## Connections

- User → Web App Router: uses
- Web App Router → Landing Page: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Login Page: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Finance Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Budget Planner: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Learning Modules: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Invest Or Repay: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Retirement Planner: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Scam Prevention: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Scam Articles: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Stock Analysis: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Stock Chart: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Asset Forecast: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Stock Bot: routes to (evidence: `frontend/src/App.jsx`)
- Web App Router → Floating Chatbot: routes to (evidence: `frontend/src/App.jsx`)
- Asset Forecast → Prediction API: requests prediction (evidence: `frontend/src/AssetForecast/AssetReturnForecast.jsx`)
- Asset Forecast → Fund Analyzer API: requests analysis (evidence: `frontend/src/AssetForecast/AssetReturnForecast.jsx`)
- Floating Chatbot → Chat API: sends chat (evidence: `frontend/src/FloatingChatbot/Floating.jsx`)
- Stock Bot → Scam Detector API: submits files (evidence: `frontend/src/StockBot/stockbot.jsx`)
