Built Environment Graph

The built environment graph is the semantic model that ArchAI source compiles into.

It includes site context, land plot topology, terrain, zoning constraints, building envelopes, massing, floorplates, spaces, systems, materials, assemblies, metadata, provenance, and backend mappings.

Top-Level Shape

interface BuiltEnvironmentDocument {
  schemaVersion: string;
  project: ProjectInfo;
  units: UnitSystem;
  coordinateSystems: CoordinateSystem[];
  sites: Record<SiteId, Site>;
  parcels: Record<ParcelId, Parcel>;
  terrainSurfaces: Record<TerrainSurfaceId, TerrainSurface>;
  zoningOverlays: Record<ZoningOverlayId, ZoningOverlay>;
  buildableEnvelopes: Record<EnvelopeId, BuildableEnvelope>;
  buildings: Record<BuildingId, Building>;
  elements: Record<ElementId, Element>;
  spaces: Record<SpaceId, Space>;
  relations: Relation[];
  constraints: Constraint[];
  pathIndex: Record<GraphPath, EntityId | ArtifactRef>;
}

Site-To-Building Pipeline

survey / parcel data
normalize coordinate system
construct parcel and terrain topology
apply zoning and planning overlays
compute buildable envelope
generate massing and floorplates
generate building systems and spaces
run evals
commit option
export to BIM / visualization / GIS targets

Identity And Paths

Stable IDs are for persistence and backend mappings. Canonical paths are for source, docs, diagnostics, and agent patches.

id: Parcel.PCL-001
path: site.main.parcels.pcl_001