Infrastructure
Infrastructure is the shared layer that keeps Sustainable Catalyst coherent and auditable:
common entities, traceable sources, reproducible exports, and documentation standards that reduce drift over time.
Goal: if a claim is made, we should be able to show what it’s based on—quickly, clearly, and without hand-waving.
What this is
This page describes the internal standards and building blocks that sit beneath the modules.
It’s not a hosted platform promise—it’s a public description of how the work stays reviewable.
Shared layers
-
1) Common Entities
A shared “system of record” for organizations, topics, geographies, instruments, periods, and claims—so modules reference the same things.
-
2) Sources & Provenance
Every metric and narrative claim should point to sources. Where uncertainty exists, it’s documented—not buried.
-
3) Measurements & Methods
Define how indicators are calculated, updated, and interpreted. Methods are versioned so changes can be audited later.
-
4) Exports & Reproducibility
Outputs should be portable: clean exports, clear schemas, and workflows that can be rerun without tribal knowledge.
How modules connect
Most modules can stand alone, but they become significantly more useful when they reference shared entities and evidence.
Infrastructure provides those common references.
Catalyst Data
The shared relational layer: entities, sources, indicators, measurements.
Analytics R
Reproducible analysis and scenario workflows that reference the same system of record.
Standards
-
Evidence discipline
Claims should be explicit. Sources should be linkable. Uncertainty should be stated. “Confidence” should be earned.
-
Versioned methods
Indicator definitions, transformations, and assumptions should be versioned so changes don’t rewrite history.
-
Portable outputs
Prefer exports and documentation that can travel across teams, tools, and reviewers—without losing context.
-
Human-readable documentation
Documentation is written for real readers. If it can’t be explained clearly, it’s not finished.
Notes
Infrastructure is evolving. Some elements exist today as documentation and patterns, others as working code and schemas.
The guiding rule is consistency: shared references, traceable work, reproducible outputs.