# vsspowerlifting/strategic-materials-policy-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/vsspowerlifting/strategic-materials-policy-tracker
- Repository: https://github.com/vsspowerlifting/strategic-materials-policy-tracker

## Overview

Strategic Materials Policy Tracker is a source-linked policy and financial-intelligence product, not a market-price model. Users browse policy measures and their official framing, then examine controls, public capital, portfolios, projects, and material/actor interplay; records link back to cited sources. The app also exposes API and dataset exports, coverage, search, watchlists, and methodology. The graph follows documented page-to-data and analytics dependencies; unsampled subsystems are included where the README documents them, but uncertain internal call paths are omitted.

Main entry points: [`lib/data.ts`](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/data.ts) (Typed seed-data access), [`app/capital/page.tsx`](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/capital/page.tsx) (Capital explorer), [`app/interplay/page.tsx`](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/interplay/page.tsx) (Capital-control interplay), [`app/controls/page.tsx`](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/controls/page.tsx) (Control measures)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_policy["Policy and framing"]
  node_events["Policy events<br/>[page.tsx]"]
  node_event_detail["Event dossier<br/>[page.tsx]"]
  node_framing["Framing matrix<br/>[page.tsx]"]
  node_compare["Actor comparison<br/>[page.tsx]"]
end

subgraph group_capital["Capital and control"]
  node_controls["Control measures<br/>[page.tsx]"]
  node_capital_page["Capital explorer<br/>[page.tsx]"]
  node_interplay["Capital-control interplay<br/>[page.tsx]"]
  node_portfolios["Government portfolios<br/>[page.tsx]"]
  node_projects["Project profiles<br/>[page.tsx]"]
  node_organizations["Organization profiles<br/>[page.tsx]"]
  node_programmes["Programme ledgers<br/>[page.tsx]"]
end

subgraph group_reference["Reference and discovery"]
  node_materials["Material profiles<br/>[page.tsx]"]
  node_coverage["Coverage analysis<br/>[page.tsx]"]
  node_methodology["Methodology<br/>[page.tsx]"]
  node_dataset["Dataset downloads<br/>[page.tsx]"]
  node_api["Versioned data API"]
end

subgraph group_data["Data and analytics"]
  node_seed_access["Typed seed-data access<br/>[data.ts]"]
  node_capital_analytics["Capital-control analytics<br/>[capital-control.ts]"]
  node_intelligence["Capital intelligence"]
  node_coverage_logic["Coverage computation<br/>[coverage.ts]"]
  node_domain_types["Domain records<br/>[types.ts]"]
  node_label_catalog["Categorical labels<br/>[labels.ts]"]
  node_lattice_logic["Comparison lattice<br/>[lattice.ts]"]
  node_chronology_logic["Interplay chronology"]
end

subgraph group_shared["Shared presentation"]
  node_quote_view["Framing quote view<br/>[framing-quote.tsx]"]
  node_capital_charts["Capital charts<br/>[charts.tsx]"]
  node_capital_rows["Capital and control rows<br/>[rows.tsx]"]
  node_capital_primitives["Capital record details<br/>[primitives.tsx]"]
  node_labels_view["Policy label badges<br/>[labels.tsx]"]
  node_lattice_view["Lattice visualization<br/>[lattice.tsx]"]
end

node_visitor(("Researcher"))

node_visitor -->|"browses"| node_events
node_visitor -->|"compares framing"| node_framing
node_visitor -->|"explores capital"| node_capital_page
node_visitor -->|"examines controls"| node_controls
node_visitor -->|"compares measures"| node_interplay
node_visitor -->|"reviews portfolios"| node_portfolios
node_events -.->|"loads records"| node_seed_access
node_event_detail -->|"loads record"| node_seed_access
node_event_detail -->|"renders capital details"| node_capital_primitives
node_event_detail -->|"renders quote"| node_quote_view
node_framing -->|"loads framing data"| node_seed_access
node_framing -->|"renders quotes"| node_quote_view
node_compare -->|"loads comparison data"| node_seed_access
node_compare -->|"uses lattice data"| node_lattice_logic
node_compare -->|"renders lattice"| node_lattice_view
node_controls -->|"loads records"| node_seed_access
node_controls -->|"uses analytics"| node_capital_analytics
node_controls -->|"renders charts"| node_capital_charts
node_capital_page -->|"loads records"| node_seed_access
node_capital_page -->|"uses analytics"| node_capital_analytics
node_capital_page -->|"renders charts"| node_capital_charts
node_capital_page -->|"renders rows"| node_capital_rows
node_interplay -->|"loads records"| node_seed_access
node_interplay -->|"uses analytics"| node_capital_analytics
node_interplay -->|"renders charts"| node_capital_charts
node_interplay -->|"renders rows"| node_capital_rows
node_interplay -.->|"uses chronology"| node_chronology_logic
node_portfolios -->|"loads records"| node_seed_access
node_portfolios -->|"uses portfolio analysis"| node_intelligence
node_projects -->|"loads records"| node_seed_access
node_projects -->|"uses intelligence"| node_intelligence
node_organizations -->|"loads records"| node_seed_access
node_organizations -->|"uses intelligence"| node_intelligence
node_programmes -->|"loads records"| node_seed_access
node_programmes -->|"uses intelligence"| node_intelligence
node_materials -.->|"loads material data"| node_seed_access
node_coverage -->|"loads report data"| node_seed_access
node_coverage -->|"uses coverage"| node_coverage_logic
node_dataset -->|"exports records"| node_seed_access
node_api -->|"serves records"| node_seed_access
node_seed_access -->|"computes coverage"| node_coverage_logic
node_capital_analytics -->|"reads commitments"| node_seed_access
node_intelligence -->|"uses analytics"| node_capital_analytics
node_capital_page -.->|"renders record details"| node_capital_primitives
node_capital_page -->|"renders labels"| node_labels_view
node_controls -->|"renders labels"| node_labels_view
node_framing -->|"renders categories"| node_labels_view

click node_events "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/events/page.tsx"
click node_event_detail "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/events/%5Bid%5D/page.tsx"
click node_framing "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/framing/page.tsx"
click node_compare "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/compare/page.tsx"
click node_controls "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/controls/page.tsx"
click node_capital_page "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/capital/page.tsx"
click node_interplay "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/interplay/page.tsx"
click node_portfolios "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/portfolios/page.tsx"
click node_projects "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/projects/page.tsx"
click node_organizations "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/organizations/page.tsx"
click node_programmes "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/programmes/page.tsx"
click node_materials "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/materials/page.tsx"
click node_coverage "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/coverage/page.tsx"
click node_methodology "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/methodology/page.tsx"
click node_dataset "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/data/page.tsx"
click node_api "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/tree/main/app/api/v1"
click node_seed_access "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/data.ts"
click node_capital_analytics "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/capital-control.ts"
click node_intelligence "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/capital-intelligence.ts"
click node_coverage_logic "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/coverage.ts"
click node_domain_types "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/types.ts"
click node_label_catalog "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/labels.ts"
click node_lattice_logic "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/lattice.ts"
click node_chronology_logic "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/interplay-chronology.ts"
click node_quote_view "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/framing-quote.tsx"
click node_capital_charts "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/capital/charts.tsx"
click node_capital_rows "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/capital/rows.tsx"
click node_capital_primitives "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/capital/primitives.tsx"
click node_labels_view "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/labels.tsx"
click node_lattice_view "https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/lattice/lattice.tsx"

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_events,node_event_detail,node_framing,node_compare toneBlue
class node_controls,node_capital_page,node_interplay,node_portfolios,node_projects,node_organizations,node_programmes toneAmber
class node_materials,node_coverage,node_methodology,node_dataset,node_api toneMint
class node_seed_access,node_capital_analytics,node_intelligence,node_coverage_logic,node_domain_types,node_label_catalog,node_lattice_logic,node_chronology_logic toneRose
class node_quote_view,node_capital_charts,node_capital_rows,node_capital_primitives,node_labels_view,node_lattice_view,node_visitor toneIndigo
```

## Components

### Policy and framing

- [Policy events](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/events/page.tsx): `app/events/page.tsx`
- [Event dossier](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/events/%5Bid%5D/page.tsx): `app/events/[id]/page.tsx`
- [Framing matrix](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/framing/page.tsx): `app/framing/page.tsx`
- [Actor comparison](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/compare/page.tsx): `app/compare/page.tsx`

### Capital and control

- [Control measures](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/controls/page.tsx): `app/controls/page.tsx`
- [Capital explorer](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/capital/page.tsx): `app/capital/page.tsx`
- [Capital-control interplay](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/interplay/page.tsx): `app/interplay/page.tsx`
- [Government portfolios](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/portfolios/page.tsx): `app/portfolios/page.tsx`
- [Project profiles](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/projects/page.tsx): `app/projects/page.tsx`
- [Organization profiles](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/organizations/page.tsx): `app/organizations/page.tsx`
- [Programme ledgers](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/programmes/page.tsx): `app/programmes/page.tsx`

### Reference and discovery

- [Material profiles](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/materials/page.tsx): `app/materials/page.tsx`
- [Coverage analysis](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/coverage/page.tsx): `app/coverage/page.tsx`
- [Methodology](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/methodology/page.tsx): `app/methodology/page.tsx`
- [Dataset downloads](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/app/data/page.tsx): `app/data/page.tsx`
- [Versioned data API](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/tree/main/app/api/v1): `app/api/v1`

### Data and analytics

- [Typed seed-data access](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/data.ts): `lib/data.ts`
- [Capital-control analytics](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/capital-control.ts): `lib/capital-control.ts`
- [Capital intelligence](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/capital-intelligence.ts): `lib/capital-intelligence.ts`
- [Coverage computation](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/coverage.ts): `lib/coverage.ts`
- [Domain records](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/types.ts): `lib/types.ts`
- [Categorical labels](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/labels.ts): `lib/labels.ts`
- [Comparison lattice](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/lattice.ts): `lib/lattice.ts`
- [Interplay chronology](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/lib/interplay-chronology.ts): `lib/interplay-chronology.ts`

### Shared presentation

- [Framing quote view](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/framing-quote.tsx): `components/framing-quote.tsx`
- [Capital charts](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/capital/charts.tsx): `components/capital/charts.tsx`
- [Capital and control rows](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/capital/rows.tsx): `components/capital/rows.tsx`
- [Capital record details](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/capital/primitives.tsx): `components/capital/primitives.tsx`
- [Policy label badges](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/labels.tsx): `components/labels.tsx`
- [Lattice visualization](https://github.com/vsspowerlifting/strategic-materials-policy-tracker/blob/main/components/lattice/lattice.tsx): `components/lattice/lattice.tsx`

### Other components

- **Researcher**

## Connections

- Researcher → Policy events: browses (evidence: `README.md`)
- Researcher → Framing matrix: compares framing (evidence: `README.md`)
- Researcher → Capital explorer: explores capital (evidence: `README.md`)
- Researcher → Control measures: examines controls (evidence: `README.md`)
- Researcher → Capital-control interplay: compares measures (evidence: `README.md`)
- Researcher → Government portfolios: reviews portfolios (evidence: `README.md`)
- Policy events → Typed seed-data access: loads records
- Event dossier → Typed seed-data access: loads record (evidence: `app/events/[id]/page.tsx`)
- Event dossier → Capital record details: renders capital details (evidence: `app/events/[id]/page.tsx`)
- Event dossier → Framing quote view: renders quote (evidence: `app/events/[id]/page.tsx`)
- Framing matrix → Typed seed-data access: loads framing data (evidence: `app/framing/page.tsx`)
- Framing matrix → Framing quote view: renders quotes (evidence: `app/framing/page.tsx`)
- Actor comparison → Typed seed-data access: loads comparison data (evidence: `app/compare/page.tsx`)
- Actor comparison → Comparison lattice: uses lattice data (evidence: `app/compare/page.tsx`)
- Actor comparison → Lattice visualization: renders lattice (evidence: `app/compare/page.tsx`)
- Control measures → Typed seed-data access: loads records (evidence: `app/controls/page.tsx`)
- Control measures → Capital-control analytics: uses analytics (evidence: `app/controls/page.tsx`)
- Control measures → Capital charts: renders charts (evidence: `app/controls/page.tsx`)
- Capital explorer → Typed seed-data access: loads records (evidence: `app/capital/page.tsx`)
- Capital explorer → Capital-control analytics: uses analytics (evidence: `app/capital/page.tsx`)
- Capital explorer → Capital charts: renders charts (evidence: `app/capital/page.tsx`)
- Capital explorer → Capital and control rows: renders rows (evidence: `app/capital/page.tsx`)
- Capital-control interplay → Typed seed-data access: loads records (evidence: `app/interplay/page.tsx`)
- Capital-control interplay → Capital-control analytics: uses analytics (evidence: `app/interplay/page.tsx`)
- Capital-control interplay → Capital charts: renders charts (evidence: `app/interplay/page.tsx`)
- Capital-control interplay → Capital and control rows: renders rows (evidence: `app/interplay/page.tsx`)
- Capital-control interplay → Interplay chronology: uses chronology
- Government portfolios → Typed seed-data access: loads records (evidence: `app/portfolios/page.tsx`)
- Government portfolios → Capital intelligence: uses portfolio analysis (evidence: `app/portfolios/page.tsx`)
- Project profiles → Typed seed-data access: loads records
- Project profiles → Capital intelligence: uses intelligence
- Organization profiles → Typed seed-data access: loads records
- Organization profiles → Capital intelligence: uses intelligence
- Programme ledgers → Typed seed-data access: loads records (evidence: `app/programmes/page.tsx`)
- Programme ledgers → Capital intelligence: uses intelligence (evidence: `app/programmes/page.tsx`)
- Material profiles → Typed seed-data access: loads material data
- Coverage analysis → Typed seed-data access: loads report data (evidence: `app/coverage/page.tsx`)
- Coverage analysis → Coverage computation: uses coverage (evidence: `app/coverage/page.tsx`)
- Dataset downloads → Typed seed-data access: exports records (evidence: `README.md`)
- Versioned data API → Typed seed-data access: serves records (evidence: `app/api/v1/control-measures/route.ts`)
- Typed seed-data access → Coverage computation: computes coverage (evidence: `lib/data.ts`)
- Capital-control analytics → Typed seed-data access: reads commitments (evidence: `lib/capital-control.ts`)
- Capital intelligence → Capital-control analytics: uses analytics (evidence: `lib/capital-intelligence.ts`)
- Capital explorer → Capital record details: renders record details (evidence: `app/capital/page.tsx`)
- Capital explorer → Policy label badges: renders labels (evidence: `app/capital/page.tsx`)
- Control measures → Policy label badges: renders labels (evidence: `app/controls/page.tsx`)
- Framing matrix → Policy label badges: renders categories (evidence: `app/framing/page.tsx`)
