PG Atlas Architecture Documentation

Welcome to the technical architecture specification for PG Atlas — the metrics backbone for SCF’s Public Goods Maintenance program.

This site is under active development by the SCF Public Goods Working Group.

Index

Overview & Goals — Explains the purpose of PG Atlas, its role in funding decisions, and its importance for ecosystem growth.
Ingestion — Details SBOM submission workflows, automated graph bootstrapping, and contributor log processing.
Storage — Describes the PostgreSQL-based data model, incremental updates, and auditability features.
Metric Computation — Covers criticality scoring, pony factor analysis, and adoption signal computation.
API Layer — Specifies the FastAPI-based design, endpoints, and OpenAPI documentation for public access.
Dashboard — Outlines user stories, UX goals, and dashboard features for ecosystem transparency.
Operations & Deployment — Lists hosting strategies, cost control measures, and deployment options.
Security & Privacy — Emphasizes privacy-first principles, data minimization, and defense-in-depth measures.
Extensibility & Migration — Discusses modular architecture, new metrics, and long-term evolution paths.