Skip to main content

Business Glossary

The Business Glossary at /governance/dictionary is Clone-Xs's centralised business-term dictionary. Define terms once, classify them by domain, link them to UC columns, and let downstream tools (search, lineage, AI Assistant) resolve customer_id to the official business definition.

Add a term​

Click Add Term. The form takes:

FieldNotes
NameRequired, e.g. Active Customer
AbbreviationOptional, e.g. AC
DomainDropdown: Customer, Product, Finance, Operations, Compliance (configurable)
DefinitionFree-text, required
OwnerEmail of accountable person
TagsComma-separated
Statusdraft / approved / deprecated

Saved terms call POST /governance/glossary and appear in the datatable below.

Each term row expands to show:

  • Full definition
  • Tags
  • Linked columns — UC column FQNs this term governs
  • Delete button (admin only)

Link a column to a term by adding it on the term's expand row, or by tagging the column from the Explorer. Linked terms surface in:

  • Search — when you query the term name
  • Explorer — column tooltip shows the term definition
  • AI Assistant — uses term definitions to disambiguate ambiguous user prompts

API​

GET    /governance/glossary
POST   /governance/glossary
DELETE /governance/glossary/{term_id}

Lifecycle​

  • draft — work-in-progress, not surfaced in search
  • approved — visible everywhere, governed
  • deprecated — kept for historical reference but flagged in tooltips

The status transitions are tracked in Change History.