PointSav GIS Engine
PointSav GIS Engine
The PointSav GIS Engine is a high-performance, sovereign Location Intelligence platform designed for offline-first, flat-file operation. Built in Rust, it represents a structural departure from traditional, proprietary geographic information systems (GIS) that rely on centralized database instances.
Architectural Principles
The engine is engineered to operate as a stateless application surface, adhering to the PointSav principle of complete data sovereignty.
Flat-File Substrate
Unlike traditional GIS stacks (e.g., PostGIS, Esri) which require persistent database management, the PointSav engine utilizes a flat-file substrate. It consumes geographic data directly from JSONL, GeoParquet, and YAML formats versioned within a Totebox Archive. This architecture ensures the data layer remains entirely decoupled from the application logic, eliminating database maintenance overhead and preventing vendor lock-in.
Sovereign Rendering Stack
The platform avoids commercial SaaS mapping dependencies by utilizing a high-performance, open-source rendering stack:
- PMTiles: A single-file archive format for tiled data that enables maps to be served directly from standard web servers (Nginx) or blob storage without a dedicated tile server. [pmtiles-spec]
- MapLibre GL JS: A WebGL-based library for rendering interactive vector maps with high client-side performance. [maplibre-gl-js]
- Tippecanoe: A tool used to compile massive flat-file datasets into optimized vector tiles, ensuring rapid delivery of complex co-location clusters. [tippecanoe-tool]
Spatial Processing and Orchestration
The engine's core logic resides in the app-orchestration-gis service. This component executes the Woodfine co-location methodology deterministically:
- Ingestion: Reads retail and civic infrastructure records from the Totebox Archive.
- Analysis: Executes spatial joins and proximity queries to identify co-location clusters across 1.0 km, 3.0 km, and 5.0 km radii.
- Ranking: Applies the 12-rank named-anchor matrix to generate site quality tiers.
- Serialization: Outputs the processed results as tiled data for the visual interface at gis.woodfinegroup.com.
This stateless approach ensures that the entire GIS environment can be re-provisioned instantly from the immutable data layer, providing maximum service resilience and auditability.
See Also
Provenance
- Draft Source:
topic-pointsav-gis-engine.md(project-gis) - Refinement: 2026-05-02 by project-language Task
- Verification: Architectural details and rendering stack confirmed against
app-orchestration-gisbuild configuration.