Buildplan system catalog

Architecture documentation is work in progress. api-v1 bounded contexts that have catalog pages: bim-ontology, product-marketplace, service-marketplace, design-management, construction-management (Site Image only), and project-delivery-graph (definition graph + Revit ingest). Start with the platform shared kernel, then the bounded-context language pages.

Start here

Read the platform ubiquitous language first. It carries POM, BFF, project-coordination, and the BIM terms other contexts consume.

Then read each bounded-context language page. construction-management currently documents Site Image only.

Ubiquitous language

Platform (Start Here)

Shared-kernel domain — catalog entry, ADRs, cross-cutting language

Platform language

POM, BFF, project-coordination, configuration DSL

BIM Ontology language

Object classes, parameter keys, assignment, Revit projection

Product Marketplace language

Catalog, scraping, product configuration

Service Marketplace language

Providers, service areas, scrape-from-URL

Design Management language

Collections, portal publish, part types

Construction Management language

Site Image only — estimates not modeled yet

Project Delivery Graph language

Definition graph, import runs, rematerialized summary

Domains and services

api-v1

Active Airtable-backed API (deployable)

api-v2

Prisma/Postgres target API (deployable)

Backend platform

api-v1 + api-v2 as machinery that spans domains

Product ingestion

Scrape-and-persist path owned by product-marketplace

BIM Ontology

Classification tree and parameter dictionary

Product Marketplace

Catalog, scraping, product configuration

Service Marketplace

Providers and coverage; profile overlays stubbed

Design Management

User product collections and portal publish

Construction Management

Site Image aggregate; other construction work not modeled

Project Delivery Graph

Definition graph, ImportRun, Revit ingest on api-v1

Architecture decisions

There are two ADR series, and both number from ADR-0001. Qualify every citation (platform vs per-file). The catalog does not host an ADR index — source of truth is the repo.

ADR index (repo)

Citation rules and both series

Platform ADR series

Canonical platform decisions