# kadoa-org/congress-trading-monitor architecture

> Architecture diagram of the GitHub repository kadoa-org/congress-trading-monitor, 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/kadoa-org/congress-trading-monitor
- Repository: https://github.com/kadoa-org/congress-trading-monitor

## Overview

Congress Trading Monitor is a client-side dashboard for exploring STOCK Act disclosures. Its main workflow loads static JSON, prepares shared filer and transaction data, routes users to overview, searchable listings, and filer/ticker drill-downs, then presents filtered trades and return-related views. The README documents aggregation from House, Senate, and OGE records; those collection steps are upstream of this repository’s runtime. The graph preserves the documented insights and methodology branches. Some subsystem links rely on README or source-index references because their implementations were not excerpted.

Main entry points: [`src/App.jsx`](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/App.jsx) (App and routing), [`src/pages/FilerPage.jsx`](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/FilerPage.jsx) (Filer detail), [`src/pages/TickerPage.jsx`](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/TickerPage.jsx) (Ticker detail), [`src/components/FilterBar.jsx`](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/components/FilterBar.jsx) (Filter controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_app["App and routing<br/>[App.jsx]"]
  node_entry["Client entry<br/>[main.jsx]"]
  node_palette["Command palette<br/>[CommandPalette.jsx]"]
end

subgraph group_explore["Browse disclosures"]
  node_overview["Overview dashboard<br/>[OverviewPage.jsx]"]
  node_filers["Filer directory<br/>[FilersPage.jsx]"]
  node_tickers["Ticker directory<br/>[TickersPage.jsx]"]
  node_trades["Trades listing<br/>[TradesPage.jsx]"]
  node_filters["Filter controls<br/>[FilterBar.jsx]"]
end

subgraph group_detail["Drill-down views"]
  node_filer_detail["Filer detail<br/>[FilerPage.jsx]"]
  node_ticker_detail["Ticker detail<br/>[TickerPage.jsx]"]
  node_trade_table["Trade table<br/>[TradesTable.jsx]"]
  node_timeline["Personal timeline"]
end

subgraph group_insights["Insights and context"]
  node_insights_list["Insights directory<br/>[InsightsPage.jsx]"]
  node_insight_detail["Insight detail<br/>[InsightPage.jsx]"]
  node_about["Methodology page<br/>[AboutPage.jsx]"]
  node_insight_data["Insight definitions<br/>[insights.js]"]
end

subgraph group_shared["Data and UI"]
  node_data_loader["Data loading<br/>[data.js]"]
  node_static_data[("Static disclosure dataset")]
  node_kit["Shared data-kit<br/>[index.jsx]"]
  node_ui["UI primitives<br/>[ui.jsx]"]
end

node_visitor(("Dashboard visitor"))
node_external_records["House, Senate, OGE records"]
node_kadoa["Kadoa collection and normalization"]

node_visitor -->|"opens dashboard"| node_entry
node_entry -->|"mounts or hydrates"| node_app
node_app -->|"loads data"| node_data_loader
node_data_loader -.->|"fetches JSON"| node_static_data
node_app -->|"routes to"| node_overview
node_app -->|"routes to"| node_filers
node_app -->|"routes to"| node_tickers
node_app -->|"routes to"| node_trades
node_app -->|"routes to"| node_filer_detail
node_app -->|"routes to"| node_ticker_detail
node_app -->|"routes to"| node_insights_list
node_app -->|"routes to"| node_insight_detail
node_app -->|"routes to"| node_about
node_app -->|"renders"| node_palette
node_filers -->|"uses controls"| node_filters
node_trades -.->|"uses controls"| node_filters
node_filer_detail -->|"filters trades"| node_filters
node_ticker_detail -->|"filters trades"| node_filters
node_filer_detail -->|"renders trades"| node_trade_table
node_ticker_detail -->|"renders trades"| node_trade_table
node_filer_detail -->|"renders timeline"| node_timeline
node_ticker_detail -.->|"renders timeline"| node_timeline
node_overview -->|"renders figures"| node_kit
node_insights_list -->|"reads definitions"| node_insight_data
node_insight_detail -->|"reads definitions"| node_insight_data
node_about -->|"uses primitives"| node_ui
node_external_records -->|"collected and parsed"| node_kadoa
node_kadoa -->|"aggregates disclosures"| node_static_data

click node_app "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/App.jsx"
click node_entry "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/main.jsx"
click node_palette "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/components/CommandPalette.jsx"
click node_overview "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/OverviewPage.jsx"
click node_filers "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/FilersPage.jsx"
click node_tickers "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/TickersPage.jsx"
click node_trades "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/TradesPage.jsx"
click node_filters "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/components/FilterBar.jsx"
click node_filer_detail "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/FilerPage.jsx"
click node_ticker_detail "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/TickerPage.jsx"
click node_trade_table "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/TradesTable.jsx"
click node_timeline "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/components/PersonalTimeline.jsx"
click node_insights_list "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/InsightsPage.jsx"
click node_insight_detail "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/InsightPage.jsx"
click node_about "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/AboutPage.jsx"
click node_insight_data "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/insights.js"
click node_data_loader "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/data.js"
click node_static_data "https://github.com/kadoa-org/congress-trading-monitor/tree/main/public/data"
click node_kit "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/kit/index.jsx"
click node_ui "https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/ui.jsx"

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_app,node_entry,node_palette toneBlue
class node_overview,node_filers,node_tickers,node_trades,node_filters toneAmber
class node_filer_detail,node_ticker_detail,node_trade_table,node_timeline toneMint
class node_insights_list,node_insight_detail,node_about,node_insight_data toneRose
class node_data_loader,node_static_data,node_kit,node_ui,node_visitor,node_external_records,node_kadoa toneIndigo
```

## Components

### App runtime

- [App and routing](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/App.jsx): `src/App.jsx`
- [Client entry](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/main.jsx): `src/main.jsx`
- [Command palette](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/components/CommandPalette.jsx): `src/components/CommandPalette.jsx`

### Browse disclosures

- [Overview dashboard](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/OverviewPage.jsx): `src/pages/OverviewPage.jsx`
- [Filer directory](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/FilersPage.jsx): `src/pages/FilersPage.jsx`
- [Ticker directory](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/TickersPage.jsx): `src/pages/TickersPage.jsx`
- [Trades listing](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/TradesPage.jsx): `src/pages/TradesPage.jsx`
- [Filter controls](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/components/FilterBar.jsx): `src/components/FilterBar.jsx`

### Drill-down views

- [Filer detail](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/FilerPage.jsx): `src/pages/FilerPage.jsx`
- [Ticker detail](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/TickerPage.jsx): `src/pages/TickerPage.jsx`
- [Trade table](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/TradesTable.jsx): `src/TradesTable.jsx`
- [Personal timeline](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/components/PersonalTimeline.jsx): `src/components/PersonalTimeline.jsx`

### Insights and context

- [Insights directory](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/InsightsPage.jsx): `src/pages/InsightsPage.jsx`
- [Insight detail](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/InsightPage.jsx): `src/pages/InsightPage.jsx`
- [Methodology page](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/pages/AboutPage.jsx): `src/pages/AboutPage.jsx`
- [Insight definitions](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/insights.js): `src/insights.js`

### Data and UI

- [Data loading](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/data.js): `src/data.js`
- [Static disclosure dataset](https://github.com/kadoa-org/congress-trading-monitor/tree/main/public/data): `public/data`
- [Shared data-kit](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/kit/index.jsx): `src/kit/index.jsx`
- [UI primitives](https://github.com/kadoa-org/congress-trading-monitor/blob/main/src/ui.jsx): `src/ui.jsx`

### Other components

- **Dashboard visitor**
- **House, Senate, OGE records**
- **Kadoa collection and normalization**

## Connections

- Dashboard visitor → Client entry: opens dashboard (evidence: `src/main.jsx`)
- Client entry → App and routing: mounts or hydrates (evidence: `src/main.jsx`)
- App and routing → Data loading: loads data (evidence: `src/App.jsx`)
- Data loading → Static disclosure dataset: fetches JSON (evidence: `README.md`)
- App and routing → Overview dashboard: routes to (evidence: `src/App.jsx`)
- App and routing → Filer directory: routes to (evidence: `src/App.jsx`)
- App and routing → Ticker directory: routes to (evidence: `src/App.jsx`)
- App and routing → Trades listing: routes to (evidence: `src/App.jsx`)
- App and routing → Filer detail: routes to (evidence: `src/App.jsx`)
- App and routing → Ticker detail: routes to (evidence: `src/App.jsx`)
- App and routing → Insights directory: routes to (evidence: `src/App.jsx`)
- App and routing → Insight detail: routes to (evidence: `src/App.jsx`)
- App and routing → Methodology page: routes to (evidence: `src/App.jsx`)
- App and routing → Command palette: renders (evidence: `src/App.jsx`)
- Filer directory → Filter controls: uses controls (evidence: `src/pages/FilersPage.jsx`)
- Trades listing → Filter controls: uses controls (evidence: `src/pages/TradesPage.jsx`)
- Filer detail → Filter controls: filters trades (evidence: `src/pages/FilerPage.jsx`)
- Ticker detail → Filter controls: filters trades (evidence: `src/pages/TickerPage.jsx`)
- Filer detail → Trade table: renders trades (evidence: `src/pages/FilerPage.jsx`)
- Ticker detail → Trade table: renders trades (evidence: `src/pages/TickerPage.jsx`)
- Filer detail → Personal timeline: renders timeline (evidence: `src/pages/FilerPage.jsx`)
- Ticker detail → Personal timeline: renders timeline (evidence: `src/pages/TickerPage.jsx`)
- Overview dashboard → Shared data-kit: renders figures (evidence: `src/pages/OverviewPage.jsx`)
- Insights directory → Insight definitions: reads definitions (evidence: `src/pages/InsightsPage.jsx`)
- Insight detail → Insight definitions: reads definitions (evidence: `src/pages/InsightPage.jsx`)
- Methodology page → UI primitives: uses primitives (evidence: `src/pages/AboutPage.jsx`)
- House, Senate, OGE records → Kadoa collection and normalization: collected and parsed (evidence: `README.md`)
- Kadoa collection and normalization → Static disclosure dataset: aggregates disclosures (evidence: `README.md`)
