# tazim-tech/zebuplatform architecture

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

- Interactive diagram: https://gitdiagram.com/tazim-tech/zebuplatform
- Repository: https://github.com/tazim-tech/zebuplatform

## Overview

ZEBU AI is a browser-based Indian market intelligence dashboard. Users explore a market brief, search stock research, review portfolio and alerts, or ask AI chat; the agent classifies requests, builds responses from bundled mock market data and remembered context, and the app presents those responses and supported follow-up actions. The README also documents mentor and event-alert capabilities. Data is explicitly mock data, not a live feed. Source excerpts are partial, so unsampled app-to-chart and view-rendering calls are not asserted.

Main entry points: [`js/app.js`](https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js) (App Controller), [`js/agents.js`](https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js) (Intent Orchestrator), [`index.html`](https://github.com/tazim-tech/zebuplatform/blob/main/index.html) (Dashboard Shell), [`js/charts.js`](https://github.com/tazim-tech/zebuplatform/blob/main/js/charts.js) (SVG Chart Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_shell["Dashboard Shell<br/>[index.html]"]
  node_controller["App Controller<br/>[app.js]"]
  node_brief["Market Brief<br/>[app.js]"]
  node_research["Stock Research<br/>[app.js]"]
  node_portfolio["Portfolio Intelligence<br/>[app.js]"]
  node_events["Market Alerts<br/>[app.js]"]
  node_chat["AI Chat<br/>[app.js]"]
end

subgraph group_intelligence["AI Intelligence"]
  node_agent["Intent Orchestrator<br/>[agents.js]"]
  node_mentor["Financial Mentor<br/>[agents.js]"]
  node_risk["Portfolio Risk<br/>[agents.js]"]
  node_monitor["Alert Monitor<br/>[agents.js]"]
  node_memory["Agent Memory<br/>[agents.js]"]
end

subgraph group_domain["Market Data"]
  node_marketdata["Market Data<br/>[data.js]"]
  node_stockdata["Stock Fundamentals<br/>[data.js]"]
  node_portfoliodata["Holdings Data<br/>[data.js]"]
  node_eventdata["Events and Concepts<br/>[data.js]"]
end

subgraph group_presentation["Visualization"]
  node_charts["SVG Chart Engine<br/>[charts.js]"]
end

node_user(("Investor"))

node_user -->|"opens"| node_shell
node_shell -->|"hosts UI"| node_controller
node_controller -->|"renders"| node_brief
node_controller -->|"renders"| node_research
node_controller -->|"renders"| node_portfolio
node_controller -->|"renders"| node_events
node_controller -->|"initializes"| node_chat
node_chat -.->|"routes query"| node_agent
node_agent -->|"reads"| node_marketdata
node_agent -->|"reads"| node_stockdata
node_agent -->|"reads"| node_portfoliodata
node_agent -->|"reads"| node_eventdata
node_agent -->|"reads and updates"| node_memory
node_agent -->|"dispatches"| node_mentor
node_agent -->|"dispatches"| node_risk
node_controller -->|"updates session"| node_memory
node_controller -->|"starts"| node_monitor
node_monitor -->|"posts alerts"| node_controller
node_brief -.->|"renders charts"| node_charts
node_portfolio -.->|"renders charts"| node_charts

click node_shell "https://github.com/tazim-tech/zebuplatform/blob/main/index.html"
click node_controller "https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js"
click node_brief "https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js"
click node_research "https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js"
click node_portfolio "https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js"
click node_events "https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js"
click node_chat "https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js"
click node_agent "https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js"
click node_mentor "https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js"
click node_risk "https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js"
click node_monitor "https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js"
click node_memory "https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js"
click node_marketdata "https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js"
click node_stockdata "https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js"
click node_portfoliodata "https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js"
click node_eventdata "https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js"
click node_charts "https://github.com/tazim-tech/zebuplatform/blob/main/js/charts.js"

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_shell,node_controller,node_brief,node_research,node_portfolio,node_events,node_chat toneBlue
class node_agent,node_mentor,node_risk,node_monitor,node_memory toneAmber
class node_marketdata,node_stockdata,node_portfoliodata,node_eventdata toneMint
class node_charts toneRose
class node_user toneIndigo
```

## Components

### User Experience

- [Dashboard Shell](https://github.com/tazim-tech/zebuplatform/blob/main/index.html): `index.html`
- [App Controller](https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js): `js/app.js`
- [Market Brief](https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js): `js/app.js`
- [Stock Research](https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js): `js/app.js`
- [Portfolio Intelligence](https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js): `js/app.js`
- [Market Alerts](https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js): `js/app.js`
- [AI Chat](https://github.com/tazim-tech/zebuplatform/blob/main/js/app.js): `js/app.js`

### AI Intelligence

- [Intent Orchestrator](https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js): `js/agents.js`
- [Financial Mentor](https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js): `js/agents.js`
- [Portfolio Risk](https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js): `js/agents.js`
- [Alert Monitor](https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js): `js/agents.js`
- [Agent Memory](https://github.com/tazim-tech/zebuplatform/blob/main/js/agents.js): `js/agents.js`

### Market Data

- [Market Data](https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js): `js/data.js`
- [Stock Fundamentals](https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js): `js/data.js`
- [Holdings Data](https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js): `js/data.js`
- [Events and Concepts](https://github.com/tazim-tech/zebuplatform/blob/main/js/data.js): `js/data.js`

### Visualization

- [SVG Chart Engine](https://github.com/tazim-tech/zebuplatform/blob/main/js/charts.js): `js/charts.js`

### Other components

- **Investor**

## Connections

- Investor → Dashboard Shell: opens (evidence: `README.md`)
- Dashboard Shell → App Controller: hosts UI (evidence: `README.md`)
- App Controller → Market Brief: renders (evidence: `js/app.js`)
- App Controller → Stock Research: renders (evidence: `js/app.js`)
- App Controller → Portfolio Intelligence: renders (evidence: `js/app.js`)
- App Controller → Market Alerts: renders (evidence: `js/app.js`)
- App Controller → AI Chat: initializes (evidence: `js/app.js`)
- AI Chat → Intent Orchestrator: routes query
- Intent Orchestrator → Market Data: reads (evidence: `js/agents.js`)
- Intent Orchestrator → Stock Fundamentals: reads (evidence: `js/agents.js`)
- Intent Orchestrator → Holdings Data: reads (evidence: `js/agents.js`)
- Intent Orchestrator → Events and Concepts: reads (evidence: `js/agents.js`)
- Intent Orchestrator → Agent Memory: reads and updates (evidence: `js/agents.js`)
- Intent Orchestrator → Financial Mentor: dispatches (evidence: `js/agents.js`)
- Intent Orchestrator → Portfolio Risk: dispatches (evidence: `js/agents.js`)
- App Controller → Agent Memory: updates session (evidence: `js/app.js`)
- App Controller → Alert Monitor: starts (evidence: `js/app.js`)
- Alert Monitor → App Controller: posts alerts (evidence: `js/agents.js`)
- Market Brief → SVG Chart Engine: renders charts
- Portfolio Intelligence → SVG Chart Engine: renders charts
