# aritradeb2000/atbot architecture

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

- Interactive diagram: https://gitdiagram.com/aritradeb2000/atbot
- Repository: https://github.com/aritradeb2000/atbot

## Overview

ATBot is a browser-based Indian-equity research and decision-support app, not a trading system. Users explore market/news, screen stocks, or request stock analysis; the backend gathers data, scores signals, and serves results. Learning tracks outcomes and adaptive weights, while optimizer and scheduled paper allocation support portfolio research. The graph reflects README capabilities and sampled module references; some scheduler and provider wiring is not fully shown, so uncertain links are omitted.

Main entry points: [`backend/api/routes`](https://github.com/aritradeb2000/atbot/tree/master/backend/api/routes) (API routes), [`backend/data/scheduler.py`](https://github.com/aritradeb2000/atbot/blob/master/backend/data/scheduler.py) (Refresh scheduler), [`backend/models/database.py`](https://github.com/aritradeb2000/atbot/blob/master/backend/models/database.py) (Application database), [`backend/engines/outcome_tracker.py`](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/outcome_tracker.py) (Outcome tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser app"]
  node_pages["Research pages"]
end

subgraph group_api["API surface"]
  node_api_routes["API routes"]
  node_ws["Live cache socket<br/>[websocket.py]"]
end

subgraph group_research["Research pipeline"]
  node_technical["Technical scoring"]
  node_fundamental_engine["Fundamental scoring"]
  node_sentiment["Sentiment scoring"]
  node_ensemble["Signal ensemble<br/>[ensemble_scorer.py]"]
end

subgraph group_portfolio["Portfolio and learning"]
  node_optimizer["Allocation optimizer"]
  node_portfolio_manager["Paper allocation"]
  node_outcomes["Outcome tracking<br/>[outcome_tracker.py]"]
  node_learner["Adaptive learner<br/>[meta_learner.py]"]
  node_reports["PDF reports"]
end

subgraph group_platform["Data and persistence"]
  node_market_data["Price history<br/>[market_data.py]"]
  node_nse_live["NSE live data<br/>[nse_live.py]"]
  node_universe["NSE universe<br/>[nse_universe.py]"]
  node_fundamentals["Fundamental data<br/>[fundamentals.py]"]
  node_news_feed["News feeds<br/>[news_feed.py]"]
  node_scheduler["Refresh scheduler<br/>[scheduler.py]"]
  node_db[("Application database<br/>[database.py]")]
  node_schemas["Stored records<br/>[schemas.py]"]
end

node_user(("Investor"))
node_providers{{"Market and news providers"}}

node_user -->|"explores"| node_pages
node_pages -->|"requests data"| node_api_routes
node_api_routes -->|"fetches prices"| node_market_data
node_api_routes -->|"fetches metrics"| node_fundamentals
node_api_routes -->|"fetches articles"| node_news_feed
node_api_routes -->|"gets live data"| node_nse_live
node_api_routes -->|"computes indicators"| node_technical
node_api_routes -->|"scores fundamentals"| node_fundamental_engine
node_api_routes -->|"scores sentiment"| node_sentiment
node_api_routes -->|"combines scores"| node_ensemble
node_api_routes -->|"screens symbols"| node_universe
node_api_routes -->|"requests allocation"| node_optimizer
node_api_routes -->|"reads and writes"| node_db
node_scheduler -->|"refreshes prices"| node_market_data
node_scheduler -->|"refreshes market"| node_nse_live
node_scheduler -->|"refreshes news"| node_news_feed
node_scheduler -->|"refreshes metrics"| node_fundamentals
node_scheduler -->|"checks outcomes"| node_outcomes
node_scheduler -->|"runs allocation"| node_portfolio_manager
node_outcomes -->|"records results"| node_db
node_learner -->|"loads and saves weights"| node_db
node_api_routes -->|"serves learning"| node_outcomes
node_api_routes -->|"loads adaptive weights"| node_learner
node_api_routes -->|"generates reports"| node_reports
node_api_routes -->|"queries records"| node_db
node_api_routes -->|"reads cached data"| node_scheduler
node_ws -->|"streams cache"| node_scheduler
node_market_data -.->|"fetches market history"| node_providers
node_nse_live -.->|"fetches NSE data"| node_providers
node_news_feed -.->|"fetches news"| node_providers
node_db -->|"creates tables"| node_schemas

click node_pages "https://github.com/aritradeb2000/atbot/tree/master/frontend/src/app"
click node_api_routes "https://github.com/aritradeb2000/atbot/tree/master/backend/api/routes"
click node_ws "https://github.com/aritradeb2000/atbot/blob/master/backend/api/websocket.py"
click node_market_data "https://github.com/aritradeb2000/atbot/blob/master/backend/data/market_data.py"
click node_nse_live "https://github.com/aritradeb2000/atbot/blob/master/backend/data/nse_live.py"
click node_universe "https://github.com/aritradeb2000/atbot/blob/master/backend/data/nse_universe.py"
click node_fundamentals "https://github.com/aritradeb2000/atbot/blob/master/backend/data/fundamentals.py"
click node_news_feed "https://github.com/aritradeb2000/atbot/blob/master/backend/data/news_feed.py"
click node_technical "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/technical_engine.py"
click node_fundamental_engine "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/fundamental_engine.py"
click node_sentiment "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/sentiment_engine.py"
click node_ensemble "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/ensemble_scorer.py"
click node_optimizer "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/portfolio_optimizer.py"
click node_portfolio_manager "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/portfolio_manager.py"
click node_scheduler "https://github.com/aritradeb2000/atbot/blob/master/backend/data/scheduler.py"
click node_outcomes "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/outcome_tracker.py"
click node_learner "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/meta_learner.py"
click node_reports "https://github.com/aritradeb2000/atbot/blob/master/backend/engines/report_generator.py"
click node_db "https://github.com/aritradeb2000/atbot/blob/master/backend/models/database.py"
click node_schemas "https://github.com/aritradeb2000/atbot/blob/master/backend/models/schemas.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 toneBlue
class node_api_routes,node_ws toneAmber
class node_technical,node_fundamental_engine,node_sentiment,node_ensemble toneMint
class node_optimizer,node_portfolio_manager,node_outcomes,node_learner,node_reports toneRose
class node_market_data,node_nse_live,node_universe,node_fundamentals,node_news_feed,node_scheduler,node_db,node_schemas,node_user,node_providers toneIndigo
```

## Components

### Browser app

- [Research pages](https://github.com/aritradeb2000/atbot/tree/master/frontend/src/app): `frontend/src/app`

### API surface

- [API routes](https://github.com/aritradeb2000/atbot/tree/master/backend/api/routes): `backend/api/routes`
- [Live cache socket](https://github.com/aritradeb2000/atbot/blob/master/backend/api/websocket.py): `backend/api/websocket.py`

### Research pipeline

- [Technical scoring](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/technical_engine.py): `backend/engines/technical_engine.py`
- [Fundamental scoring](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/fundamental_engine.py): `backend/engines/fundamental_engine.py`
- [Sentiment scoring](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/sentiment_engine.py): `backend/engines/sentiment_engine.py`
- [Signal ensemble](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/ensemble_scorer.py): `backend/engines/ensemble_scorer.py`

### Portfolio and learning

- [Allocation optimizer](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/portfolio_optimizer.py): `backend/engines/portfolio_optimizer.py`
- [Paper allocation](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/portfolio_manager.py): `backend/engines/portfolio_manager.py`
- [Outcome tracking](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/outcome_tracker.py): `backend/engines/outcome_tracker.py`
- [Adaptive learner](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/meta_learner.py): `backend/engines/meta_learner.py`
- [PDF reports](https://github.com/aritradeb2000/atbot/blob/master/backend/engines/report_generator.py): `backend/engines/report_generator.py`

### Data and persistence

- [Price history](https://github.com/aritradeb2000/atbot/blob/master/backend/data/market_data.py): `backend/data/market_data.py`
- [NSE live data](https://github.com/aritradeb2000/atbot/blob/master/backend/data/nse_live.py): `backend/data/nse_live.py`
- [NSE universe](https://github.com/aritradeb2000/atbot/blob/master/backend/data/nse_universe.py): `backend/data/nse_universe.py`
- [Fundamental data](https://github.com/aritradeb2000/atbot/blob/master/backend/data/fundamentals.py): `backend/data/fundamentals.py`
- [News feeds](https://github.com/aritradeb2000/atbot/blob/master/backend/data/news_feed.py): `backend/data/news_feed.py`
- [Refresh scheduler](https://github.com/aritradeb2000/atbot/blob/master/backend/data/scheduler.py): `backend/data/scheduler.py`
- [Application database](https://github.com/aritradeb2000/atbot/blob/master/backend/models/database.py): `backend/models/database.py`
- [Stored records](https://github.com/aritradeb2000/atbot/blob/master/backend/models/schemas.py): `backend/models/schemas.py`

### Other components

- **Investor**
- **Market and news providers**

## Connections

- Investor → Research pages: explores (evidence: `README.md`)
- Research pages → API routes: requests data (evidence: `README.md`)
- API routes → Price history: fetches prices (evidence: `backend/api/routes/analysis.py`)
- API routes → Fundamental data: fetches metrics (evidence: `backend/api/routes/analysis.py`)
- API routes → News feeds: fetches articles (evidence: `backend/api/routes/analysis.py`)
- API routes → NSE live data: gets live data (evidence: `backend/api/routes/analysis.py`)
- API routes → Technical scoring: computes indicators (evidence: `backend/api/routes/analysis.py`)
- API routes → Fundamental scoring: scores fundamentals (evidence: `backend/api/routes/analysis.py`)
- API routes → Sentiment scoring: scores sentiment (evidence: `backend/api/routes/analysis.py`)
- API routes → Signal ensemble: combines scores (evidence: `backend/api/routes/analysis.py`)
- API routes → NSE universe: screens symbols (evidence: `backend/api/routes/screener.py`)
- API routes → Allocation optimizer: requests allocation (evidence: `backend/api/routes/optimizer.py`)
- API routes → Application database: reads and writes (evidence: `backend/api/routes/settings.py`)
- Refresh scheduler → Price history: refreshes prices (evidence: `backend/data/scheduler.py`)
- Refresh scheduler → NSE live data: refreshes market (evidence: `backend/data/scheduler.py`)
- Refresh scheduler → News feeds: refreshes news (evidence: `backend/data/scheduler.py`)
- Refresh scheduler → Fundamental data: refreshes metrics (evidence: `backend/data/scheduler.py`)
- Refresh scheduler → Outcome tracking: checks outcomes (evidence: `backend/data/scheduler.py`)
- Refresh scheduler → Paper allocation: runs allocation (evidence: `backend/data/scheduler.py`)
- Outcome tracking → Application database: records results (evidence: `backend/engines/outcome_tracker.py`)
- Adaptive learner → Application database: loads and saves weights (evidence: `backend/engines/meta_learner.py`)
- API routes → Outcome tracking: serves learning (evidence: `backend/api/routes/learn.py`)
- API routes → Adaptive learner: loads adaptive weights (evidence: `backend/api/routes/learn.py`)
- API routes → PDF reports: generates reports (evidence: `backend/api/routes/learn.py`)
- API routes → Application database: queries records (evidence: `backend/api/routes/learn.py`)
- API routes → Refresh scheduler: reads cached data (evidence: `backend/api/routes/market.py`)
- Live cache socket → Refresh scheduler: streams cache (evidence: `backend/api/websocket.py`)
- Price history → Market and news providers: fetches market history (evidence: `README.md`)
- NSE live data → Market and news providers: fetches NSE data (evidence: `README.md`)
- News feeds → Market and news providers: fetches news (evidence: `README.md`)
- Application database → Stored records: creates tables (evidence: `backend/models/database.py`)
