PG Atlas Architecture Documentation
Welcome to the technical architecture specification for PG Atlas — the metrics backbone for SCF’s Public Goods Maintenance program. This part of the site is updated by PG Atlas contributors.
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 with property graph design patterns and audit tables.
- Metric Computation — Covers criticality scoring, pony factor analysis, and adoption signal computation.
- API Layer — Specifies the FastAPI-based REST API with OpenAPI documentation for public access.
- Dashboard — Documents the React dashboard with Cytoscape.js sub-graph explorer and interactive filtering.
- Operations & Deployment — Lists hosting strategies, scheduled workflows, and operational monitoring.
- Security & Privacy — Describes authentication, rate limiting, privacy measures, and audit trail strategy.
- Extensibility — Discusses extension patterns for metrics, crawlers, and scheduled workflows.
- Graph Scaling — Covers current PostgreSQL + NetworkX architecture and future scaling options.