Skip to content
Cratis Cratis Cratis

Personas

Personas name the roles that interact with the application — the vocabulary of Event Modeling’s actors. A persona has a name, an optional description, and the policies that define what the persona is allowed to do.

Syntax

Section titled “Syntax”
persona <Name>
  [description "<text>"]
  [policy <PolicyName>]*

Example

Section titled “Example”
persona Accountant
  description "Keeps the books and approves invoices"
  policy IsAccountant
  policy CanManageInvoice


persona InvoiceManager
  description "Registers invoices and manages their lifecycle"
  policy CanManageInvoice

Rules

Section titled “Rules”
  • Personas are top-level declarations, alongside policies and modules.
  • Each policy line references a policy declared in the same file — an unknown policy is reported as a warning.
  • The description, when present, is the first body line and appears at most once — a quoted single line or a fenced multi-line block (see Descriptions).

Guidance

Section titled “Guidance”
  • Name personas after roles, not people — Accountant, not Alice.
  • Personas group policies; policies define rules. A persona says who; its policies say what they must satisfy.