Start here

Buildplan architecture documentation is work in progress. product-marketplace and bim-ontology are the started domain slices; other domains and platform terms are added incrementally.

This domain is the shared kernel: terms more than one bounded context has to agree on. It owns no deployable and no aggregates.

Ubiquitous language (read order)

1. Platform ubiquitous language — POM, BFF, project-coordination, configuration DSL, committed vs proposed state, and the BIM terms other contexts consume.
2. BIM Ontology ubiquitous language — object classes, parameter keys, assignment and inheritance, Revit projection (bounded context only).
3. Product Marketplace ubiquitous language — catalog, scraping, object classes (bounded context only).

Domains

• BIM Ontology — canonical classification tree and parameter dictionary; owns ParameterKey
• Product Marketplace — catalog, scraping, product configuration; consumes ParameterKey
• Platform — this page; shared-kernel language only

Services and APIs

• api-v1
• api-v2
• Backend platform

Architecture decisions

ADRs live in the repo, not as catalog custom-docs pages.

There are two ADR series, and both number from ADR-0001. Qualify every citation: platform ADR-0008 or built api-v1 ADR-0008.

Series	Where	Scope
Platform — canonical	docs/adr/07_Architectural_Decision_Records.md	New decisions go here
Per-file	docs/adr/ ADR-NNNN-*.md	Documentation stack and built api-v1 domain

Index and citation rules: docs/adr/README.md. Repo conventions: eventcatalog/CONVENTIONS.md.

Agents (Cursor)

• MCP is not activated. Do not call the eventcatalog MCP server. It requires Scale and a configured .mcp.json.
• Use now: npm run docs:catalog:dev (no licence key), catalog MDX, and llms.txt after build.
• Cursor rules: documentation-stack-overview.mdc, architecture-documentation-entry.mdc.