Docs / Concepts

Qlerify concepts

Every word Qlerify uses, defined once. The first half covers how a workspace is organised and how the diagram works. The second half covers the domain model, which is what a developer or a coding agent builds from.

Workspace and diagram

Organisation
The top level. An organisation owns projects, and you need one before you can create anything. It also decides who can turn on public access, that permission belongs to the organisation owner, not the project owner.
Project
A container for workflows, belonging to one organisation. Project membership is the unit of access: inviting someone to a project gives them every workflow in it.
Workflow
A sequence of events arranged on a timeline. This is the board you work on, and it is where Event Storming, Event Modeling, process mapping, User Story Mapping and Domain-Driven Design all happen.
Event
Something important that happened, named with a past-tense verb and a noun, “Order created”, “Broken equipment detected”. Events can be triggered by people, systems or time. Capture only state-changing events: “Guest viewed the calendar” is not an event unless it changes something. Depending on the method you are using, you might call these steps, tasks or epics.
Lane
A horizontal row naming the primary actor for the events in it, the user, role or system that initiates the command leading to the event. In “Customer created order”, the lane is Customer. A lane must be empty before you can delete it.
Group
A vertical division of the board into phases or milestones., Order Processing, Payment, Fulfilment. Groups are purely visual: unlike lanes, they carry no ownership or architectural meaning and never appear in the domain model.
Decision
A branching shape. Where an event moves the process along one path, a decision splits it into labelled conditions, each of which corresponds to a policy in Event Storming. Note that role cards attached to a decision are left out of the domain model and the spec export.
Connection
An arrow from one event or decision to another, added by dragging or with the Add connection tool. A target can have several incoming connections; the first parent stays the main one and controls horizontal position.
Card
Detail attached to an event: a user story, a business rule, a test case, a problem, an opportunity. An event can hold many cards, and card types are configurable per workflow. Card types marked “Show in backlog” appear in the backlog where you can reorder them by priority.
Release
An iteration or delivery milestone. Assign one to a card from the Release column in the backlog, or by dragging in the User Story Map, then filter the whole board by release to see the scope of one iteration.

The domain model

Entity
A domain object with a set of fields, usually implemented as a database table or type definition. Entities can be connected to other entities to form a hierarchy of related data, and both read models and commands use them. An entity is distinguished by having an id field, which is what gives it identity.
Value object
A domain data structure with no identity of its own. Address, Money, DateRange. The rule is mechanical: a schema with an id field or a key is an entity, anything else is a value object. A value object cannot be an aggregate root, which is why Qlerify refuses if you try.
Aggregate and aggregate root
An aggregate is a cluster of entities that change together and are treated as one unit. The aggregate root is the entity a command operates on, the way into the cluster. A useful modelling test: treat each event as one command invoked on one aggregate. If “Created order” is really “created customer” plus “created order”, split it into two events.
Command
The intention to change something, named as an instruction: “Create invoice”, “Send email”. It is what the actor in the lane invokes on the aggregate. An event carries at most one command.
Read model
A query, state view or projection — the data shown to the actor before they invoke the command, not after. “Get invoice details”, “Fetch customer orders”. Read models are reusable: the same one can be referenced from several events, and an event can have as many as it needs.
Domain event
The fact published as a result of the command succeeding: “Invoice created”, “Email sent”. As a schema it defines the data payload the event carries, linked to the aggregate that produces it.
Bounded context
A cohesive boundary around the aggregates that change together and share a single, consistent domain language. You assign entities to one or more bounded contexts on the Domain Model tab. When a related entity sits in a different context, Qlerify marks it as an integration point between the two — which is usually where a service boundary belongs.
Given-When-Then
Acceptance criteria for a step, written as a test scenario. Carried through to the spec export as acceptance criteria.
Looking for the modelling methods rather than the product vocabulary? See Event Storming, Domain-Driven Design and the full glossary.