# shubhamprogr/stock-analysis architecture

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

- Interactive diagram: https://gitdiagram.com/shubhamprogr/stock-analysis
- Repository: https://github.com/shubhamprogr/stock-analysis

## Overview

The product is an Indian-equities analysis platform: scheduled Python jobs collect market and news data, derive sentiment and predictions, and persist results for a Next.js dashboard. Users explore ticker analysis, comparisons, screening, model accuracy, and trading strategies; reports can also be published to Instagram. The graph preserves documented engine stages and dashboard capabilities. Python internals and most route-to-query connections were not excerpted, so those links rely on the README rather than claims of inspected code.

Main entry points: [`Website/src/components/Dashboard.tsx`](https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/components/Dashboard.tsx) (Dashboard shell), [`Website/src/lib/queries.ts`](https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/lib/queries.ts) (Data queries), [`Stock Analysis/News_Extractor.py`](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/News_Extractor.py) (News extraction), [`Stock Analysis/Instagram_Publisher.py`](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Instagram_Publisher.py) (Report publishing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Data ingestion"]
  node_daily["Daily market data"]
  node_history["Historical market data<br/>[Stock_Data_5Y.py]"]
  node_news["News extraction<br/>[News_Extractor.py]"]
  node_company["Company data<br/>[Company_Data.py]"]
end

subgraph group_analysis["Analysis engine"]
  node_sentiment["Article sentiment"]
  node_engine["Analysis and prediction<br/>[Final_Analysis.py]"]
  node_validation["Prediction evaluation"]
end

subgraph group_webdata["Web data access"]
  node_database[("PostgreSQL")]
  node_queries["Data queries<br/>[queries.ts]"]
  node_signals["Strategy signals<br/>[signals.ts]"]
  node_api["Dashboard API"]
end

subgraph group_dashboard["Dashboard"]
  node_dashboard["Dashboard shell<br/>[Dashboard.tsx]"]
  node_visuals["Analysis views"]
  node_comparison["Comparison view<br/>[CompareView.tsx]"]
end

subgraph group_publishing["Publishing"]
  node_publishing["Report publishing"]
  node_reports["Daily reports<br/>[Reports.py]"]
end

node_user(("Investor"))
node_marketdata(("Market data sources"))
node_newsources(("Financial news sources"))
node_instagram(("Instagram Graph API"))
node_cloudinary(("Cloudinary"))

node_marketdata -->|"supplies prices"| node_daily
node_marketdata -->|"supplies history"| node_history
node_newsources -->|"supplies articles"| node_news
node_news -->|"scores articles"| node_sentiment
node_daily -->|"stores market data"| node_database
node_history -->|"stores history"| node_database
node_news -->|"stores news"| node_database
node_sentiment -->|"stores aggregates"| node_database
node_company -->|"stores fundamentals"| node_database
node_engine -->|"stores predictions"| node_database
node_database -.->|"provides actuals"| node_validation
node_engine -->|"evaluates forecasts"| node_validation
node_database -->|"reads data"| node_queries
node_queries -->|"builds strategies"| node_signals
node_user -->|"explores analysis"| node_dashboard
node_dashboard -.->|"requests data"| node_api
node_api -->|"loads results"| node_queries
node_queries -->|"queries"| node_database
node_dashboard -->|"renders views"| node_visuals
node_dashboard -.->|"renders comparison"| node_comparison
node_reports -->|"prepares reports"| node_publishing
node_publishing -->|"uploads images"| node_cloudinary
node_publishing -->|"publishes reports"| node_instagram

click node_daily "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Stock_Data_Daily.py"
click node_history "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Stock_Data_5Y.py"
click node_news "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/News_Extractor.py"
click node_sentiment "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Sentiment_Analyzer.py"
click node_company "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Company_Data.py"
click node_engine "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Final_Analysis.py"
click node_validation "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Actual_vs_Prediction.py"
click node_queries "https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/lib/queries.ts"
click node_signals "https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/lib/signals.ts"
click node_api "https://github.com/shubhamprogr/stock-analysis/tree/main/Website/src/app/api"
click node_dashboard "https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/components/Dashboard.tsx"
click node_visuals "https://github.com/shubhamprogr/stock-analysis/tree/main/Website/src/components"
click node_comparison "https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/components/CompareView.tsx"
click node_publishing "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Instagram_Publisher.py"
click node_reports "https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Reports.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_daily,node_history,node_news,node_company toneBlue
class node_sentiment,node_engine,node_validation toneAmber
class node_database,node_queries,node_signals,node_api,node_instagram toneMint
class node_dashboard,node_visuals,node_comparison toneRose
class node_publishing,node_reports,node_user,node_marketdata,node_newsources,node_cloudinary toneIndigo
```

## Components

### Data ingestion

- [Daily market data](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Stock_Data_Daily.py): `Stock Analysis/Stock_Data_Daily.py`
- [Historical market data](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Stock_Data_5Y.py): `Stock Analysis/Stock_Data_5Y.py`
- [News extraction](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/News_Extractor.py): `Stock Analysis/News_Extractor.py`
- [Company data](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Company_Data.py): `Stock Analysis/Company_Data.py`

### Analysis engine

- [Article sentiment](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Sentiment_Analyzer.py): `Stock Analysis/Sentiment_Analyzer.py`
- [Analysis and prediction](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Final_Analysis.py): `Stock Analysis/Final_Analysis.py`
- [Prediction evaluation](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Actual_vs_Prediction.py): `Stock Analysis/Actual_vs_Prediction.py`

### Web data access

- **PostgreSQL**
- [Data queries](https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/lib/queries.ts): `Website/src/lib/queries.ts`
- [Strategy signals](https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/lib/signals.ts): `Website/src/lib/signals.ts`
- [Dashboard API](https://github.com/shubhamprogr/stock-analysis/tree/main/Website/src/app/api): `Website/src/app/api`

### Dashboard

- [Dashboard shell](https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/components/Dashboard.tsx): `Website/src/components/Dashboard.tsx`
- [Analysis views](https://github.com/shubhamprogr/stock-analysis/tree/main/Website/src/components): `Website/src/components`
- [Comparison view](https://github.com/shubhamprogr/stock-analysis/blob/main/Website/src/components/CompareView.tsx): `Website/src/components/CompareView.tsx`

### Publishing

- [Report publishing](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Instagram_Publisher.py): `Stock Analysis/Instagram_Publisher.py`
- [Daily reports](https://github.com/shubhamprogr/stock-analysis/blob/main/Stock%20Analysis/Reports.py): `Stock Analysis/Reports.py`

### Other components

- **Investor**
- **Market data sources**
- **Financial news sources**
- **Instagram Graph API**
- **Cloudinary**

## Connections

- Market data sources → Daily market data: supplies prices
- Market data sources → Historical market data: supplies history
- Financial news sources → News extraction: supplies articles
- News extraction → Article sentiment: scores articles
- Daily market data → PostgreSQL: stores market data
- Historical market data → PostgreSQL: stores history
- News extraction → PostgreSQL: stores news
- Article sentiment → PostgreSQL: stores aggregates
- Company data → PostgreSQL: stores fundamentals
- Analysis and prediction → PostgreSQL: stores predictions
- PostgreSQL → Prediction evaluation: provides actuals
- Analysis and prediction → Prediction evaluation: evaluates forecasts
- PostgreSQL → Data queries: reads data
- Data queries → Strategy signals: builds strategies (evidence: `Website/src/lib/queries.ts`)
- Investor → Dashboard shell: explores analysis
- Dashboard shell → Dashboard API: requests data
- Dashboard API → Data queries: loads results (evidence: `Website/src/app/api/compare/route.ts`)
- Data queries → PostgreSQL: queries (evidence: `Website/src/lib/queries.ts`)
- Dashboard shell → Analysis views: renders views (evidence: `Website/src/components/Dashboard.tsx`)
- Dashboard shell → Comparison view: renders comparison (evidence: `Website/src/components/Dashboard.tsx`)
- Daily reports → Report publishing: prepares reports
- Report publishing → Cloudinary: uploads images
- Report publishing → Instagram Graph API: publishes reports
