Data dictionary

This note describes the structure of the vault so it can be used later as a presentation or application backend.

Dataset inventory

  • Actors: 6 notes in Actors/
  • Process models: 2 notes in Process/
  • Flow relationship cards: 6 sections in Information flows
  • Exchange matrix rows: 10 rows in Exchange matrix
  • Friction points: 8 sections in Friction map
  • Glossary terms: 30 notes in Glossary/
  • Source notes: 34 notes in Sources/
    • Industry analyses and policy: 5, Local permitting and plan-review examples: 4, National definitions and statistics: 2, Occupations and personas: 13, Professional practice and standardized documents: 10

Schema by note family

Actors

Each actor note contains:

  • Role in the system
  • Personas
  • Receives / consumes
  • Produces / sends
  • Key decisions
  • Related terms
  • Evidence

Process models

Each process note contains:

  • Model summary
  • Ordered phases
  • Phase summary
  • Terms used in the phase
  • Actor-lane responsibilities for owner, design, builder, authority, trades, and vendor
  • Evidence

Information flows

The flow notes contain:

  • Relationship title
  • What moves
  • Why it matters
  • Typical failure mode
  • Exchange matrix row data with formats / channels

Frictions

Each friction entry contains:

  • Heat label
  • Description
  • Why it happens
  • What it does
  • What to watch for
  • Evidence

Glossary

Each glossary note contains:

  • Definition
  • Evidence
  • Auto-detected related notes where available

Sources

Each source note contains:

  • Kind
  • Group
  • URL
  • Why the source was used in the map

Machine-readable export

For a more literal export of the underlying arrays and text blocks, see Appendix - Raw structured export.