Vocabulary Registry

The vocabulary registry provides shared naming standards within the data model. It stores canonical terms, abbreviations, and naming rules that the graph editor's validation engine checks against. By defining an authoritative vocabulary, teams maintain consistent naming across entities, properties, and relationships throughout the project.

Adding Terms

Term Structure

Each vocabulary entry contains the following fields.

Naming Convention Validation

The vocabulary registry connects to the naming-convention validation rule in the graph editor. When this rule is enabled, the validation engine checks every entity name, property name, and relationship label against the registry. Names that do not match a canonical term or an accepted abbreviation are flagged as warnings in the validation overlay.

Best Practices

• Use singular nouns for entity names ("Customer" not "Customers").
• Define abbreviations only when the short form is genuinely used by the team.
• Use domain context to avoid conflicts between terms that mean different things in different subdomains (e.g. "Account" in finance vs. "Account" in identity).
• Review the vocabulary periodically as the model evolves to retire obsolete terms.