# vikas-visilean/ntpc-block8-mis-dashboard architecture

> Architecture diagram of the GitHub repository vikas-visilean/ntpc-block8-mis-dashboard, 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/vikas-visilean/ntpc-block8-mis-dashboard
- Repository: https://github.com/vikas-visilean/ntpc-block8-mis-dashboard

## Overview

KP MIS dashboards is a VisiLean-backed reporting site: scheduled refreshes fetch project data, transform it into dashboard or activity-report data, build static pages, and publish changed results. Portfolio rolls up the six published project pages without another API fetch. The README documents this workflow and the report capabilities; some builder and workflow wiring is unsampled, so those links are documented at subsystem level rather than inferred from imports.

Main entry points: [`.github/workflows`](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/tree/master/.github/workflows) (Refresh workflows), [`scripts/updates_data.py`](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/updates_data.py) (Updates data), [`scripts/build_portfolio.py`](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/build_portfolio.py) (Portfolio calculator), [`scripts/vl_token.py`](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/vl_token.py) (Project token lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sync["Refresh and credentials"]
  node_actions["Refresh workflows<br/>[workflows]"]
  node_tokens["Project token lookup<br/>[vl_token.py]"]
end

subgraph group_dash["Project dashboards"]
  node_dashdata["Project data feeds<br/>[dash_data.py]"]
  node_ntpcdata["NTPC data feeds"]
  node_dashboardbuild["Dashboard builders"]
  node_projectpages["Project dashboard pages"]
end

subgraph group_reports["Activity reports"]
  node_adoptiondata["Adoption data<br/>[adoption_data.py]"]
  node_adoptionbuild["Adoption builder<br/>[build_adoption.py]"]
  node_adoptionpage["Adoption tracker<br/>[index.html]"]
  node_updatesdata["Updates data<br/>[updates_data.py]"]
  node_trail["Audit event parser<br/>[updates_trail.py]"]
  node_updatesbuild["Updates builder<br/>[build_updates.py]"]
  node_updatespage["User Updates report<br/>[index.html]"]
end

subgraph group_portfolio["Portfolio rollup"]
  node_portfolio["Portfolio calculator<br/>[build_portfolio.py]"]
  node_projectoutputs["Published project pages"]
  node_portfoliopage["Portfolio dashboard<br/>[index.html]"]
end

node_visilean{{"VisiLean API"}}

node_actions -->|"refreshes projects"| node_dashdata
node_actions -->|"refreshes NTPC"| node_ntpcdata
node_actions -->|"refreshes adoption"| node_adoptiondata
node_actions -->|"refreshes updates"| node_updatesdata
node_actions -->|"rebuilds portfolio"| node_portfolio
node_dashdata -->|"looks up token"| node_tokens
node_ntpcdata -->|"looks up token"| node_tokens
node_adoptiondata -->|"looks up token"| node_tokens
node_updatesdata -->|"uses token pool"| node_tokens
node_dashdata -->|"fetches feeds"| node_visilean
node_ntpcdata -->|"fetches feeds"| node_visilean
node_adoptiondata -->|"fetches feeds"| node_visilean
node_updatesdata -->|"fetches feeds"| node_visilean
node_dashboardbuild -->|"builds pages"| node_projectpages
node_adoptionbuild -->|"builds report"| node_adoptionpage
node_updatesdata -->|"parses events"| node_trail
node_updatesbuild -->|"builds report"| node_updatespage
node_portfolio -->|"reads inline data"| node_projectoutputs
node_portfolio -->|"writes dashboard"| node_portfoliopage
node_projectoutputs -->|"supplies six projects"| node_portfolio

click node_actions "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/tree/master/.github/workflows"
click node_tokens "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/vl_token.py"
click node_dashdata "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/dash_data.py"
click node_ntpcdata "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/ntpc_dash_data_v2.py"
click node_dashboardbuild "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/tree/master/scripts"
click node_adoptiondata "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/adoption_data.py"
click node_adoptionbuild "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/build_adoption.py"
click node_adoptionpage "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/adoption/index.html"
click node_updatesdata "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/updates_data.py"
click node_trail "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/updates_trail.py"
click node_updatesbuild "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/build_updates.py"
click node_updatespage "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/updates/index.html"
click node_portfolio "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/build_portfolio.py"
click node_portfoliopage "https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/portfolio/index.html"

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_actions,node_tokens toneBlue
class node_dashdata,node_ntpcdata,node_dashboardbuild,node_projectpages toneAmber
class node_adoptiondata,node_adoptionbuild,node_adoptionpage,node_updatesdata,node_trail,node_updatesbuild,node_updatespage,node_visilean toneMint
class node_portfolio,node_projectoutputs,node_portfoliopage toneRose
```

## Components

### Refresh and credentials

- [Refresh workflows](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/tree/master/.github/workflows): `.github/workflows`
- [Project token lookup](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/vl_token.py): `scripts/vl_token.py`

### Project dashboards

- [Project data feeds](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/dash_data.py): `scripts/dash_data.py`
- [NTPC data feeds](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/ntpc_dash_data_v2.py): `scripts/ntpc_dash_data_v2.py`
- [Dashboard builders](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/tree/master/scripts): `scripts`
- **Project dashboard pages**

### Activity reports

- [Adoption data](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/adoption_data.py): `scripts/adoption_data.py`
- [Adoption builder](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/build_adoption.py): `scripts/build_adoption.py`
- [Adoption tracker](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/adoption/index.html): `adoption/index.html`
- [Updates data](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/updates_data.py): `scripts/updates_data.py`
- [Audit event parser](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/updates_trail.py): `scripts/updates_trail.py`
- [Updates builder](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/build_updates.py): `scripts/build_updates.py`
- [User Updates report](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/updates/index.html): `updates/index.html`

### Portfolio rollup

- [Portfolio calculator](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/scripts/build_portfolio.py): `scripts/build_portfolio.py`
- **Published project pages**
- [Portfolio dashboard](https://github.com/vikas-visilean/ntpc-block8-mis-dashboard/blob/master/portfolio/index.html): `portfolio/index.html`

### Other components

- **VisiLean API**

## Connections

- Refresh workflows → Project data feeds: refreshes projects (evidence: `README.md`)
- Refresh workflows → NTPC data feeds: refreshes NTPC (evidence: `README.md`)
- Refresh workflows → Adoption data: refreshes adoption (evidence: `README.md`)
- Refresh workflows → Updates data: refreshes updates (evidence: `README.md`)
- Refresh workflows → Portfolio calculator: rebuilds portfolio (evidence: `README.md`)
- Project data feeds → Project token lookup: looks up token (evidence: `scripts/dash_data.py`)
- NTPC data feeds → Project token lookup: looks up token (evidence: `scripts/ntpc_dash_data_v2.py`)
- Adoption data → Project token lookup: looks up token (evidence: `scripts/adoption_data.py`)
- Updates data → Project token lookup: uses token pool (evidence: `scripts/updates_data.py`)
- Project data feeds → VisiLean API: fetches feeds (evidence: `README.md`)
- NTPC data feeds → VisiLean API: fetches feeds (evidence: `README.md`)
- Adoption data → VisiLean API: fetches feeds (evidence: `README.md`)
- Updates data → VisiLean API: fetches feeds (evidence: `README.md`)
- Dashboard builders → Project dashboard pages: builds pages (evidence: `README.md`)
- Adoption builder → Adoption tracker: builds report (evidence: `scripts/build_adoption.py`)
- Updates data → Audit event parser: parses events (evidence: `scripts/updates_data.py`)
- Updates builder → User Updates report: builds report (evidence: `scripts/build_updates.py`)
- Portfolio calculator → Published project pages: reads inline data (evidence: `scripts/build_portfolio.py`)
- Portfolio calculator → Portfolio dashboard: writes dashboard (evidence: `scripts/build_portfolio.py`)
- Published project pages → Portfolio calculator: supplies six projects (evidence: `README.md`)
