50 lines
2.1 KiB
Markdown
50 lines
2.1 KiB
Markdown
# Cartographer Module
|
|
|
|
**Status:** Implemented
|
|
**Source:** `src/Cartographer/`
|
|
|
|
## Purpose
|
|
|
|
The Cartographer service materializes immutable SBOM property graphs, precomputes layout tiles, and hydrates policy and VEX overlays so other services (API, UI, CLI) can navigate and reason about dependency relationships with context.
|
|
|
|
## Components
|
|
|
|
**Services:**
|
|
- **StellaOps.Cartographer** - Core graph materialization, overlay management, and tile serving
|
|
|
|
## Key Features
|
|
|
|
- **Graph Materialization** - Convert normalized SBOMs (CycloneDX/SPDX) into immutable, versioned graph snapshots
|
|
- **Property Graph Generation** - Build dependency relationship graphs with context-aware nodes and edges
|
|
- **Overlay Hydration** - Merge Policy Engine findings and VEX metadata onto graph nodes and edges
|
|
- **Layout Tiles** - Precomputed viewport tiles for efficient UI navigation
|
|
- **Path Relevance** - Compute path importance within the dependency graph
|
|
- **Graph Diffing** - Compare SBOM versions to track changes
|
|
- **Tenant-Aware Storage** - Per-tenant graph isolation and versioning
|
|
|
|
## API Capabilities
|
|
|
|
- Viewport tile serving for large graphs (≥50k nodes)
|
|
- Path exploration and filtering
|
|
- Graph export and simulation overlays
|
|
- RBAC-enforced access control via Authority
|
|
|
|
## Dependencies
|
|
|
|
- **PostgreSQL** - Graph and overlay storage
|
|
- **Policy Engine** - Effective findings computation
|
|
- **SBom Service** - Normalized SBOM projections
|
|
- **Excititor** - VEX metadata ingestion
|
|
- **Authority** - Authentication and RBAC enforcement (scopes: `graph:*`, `sbom:read`, `findings:read`)
|
|
- **Scheduler** - Overlay update coordination
|
|
|
|
## Related Documentation
|
|
|
|
- **Architecture Charter:** See `src/Cartographer/StellaOps.Cartographer/AGENTS.md` for charter and responsibilities
|
|
- **Sprint Plan:** Check `docs/implplan/SPRINT_*.md` for current development status
|
|
- **Tasks:** Completed tasks documented in `src/Cartographer/StellaOps.Cartographer/TASKS.completed.md`
|
|
|
|
## Current Status
|
|
|
|
Active development. Materializes immutable SBOM property graphs with overlay hydration, deterministic snapshots, and optimized tile serving for dependency navigation.
|