Audience#
An Audience represents a population of people who use the System, grouped by their business relationship to the organization operating it.
People with the same kind of business relationship belong to the same Audience, even when they work for different organizations. Differences in departments, responsibilities, or permissions do not create separate Audiences. Roles distinguish access to Processes within an Audience.
An Audience represents people, not software components or execution mechanisms. Automated Processes reference the Audience whose business work they support.
Each Audience's description explains who those people are and their business relationship to the operating organization. User, Role, and access-grant management are provided separately by the runtime and are outside System Design.
The produced file is audiences/<audience-name>.json; it follows Audience.schema.json.
| Property | Meaning |
|---|---|
name |
Audience name, unique among Audiences in this System and used in references and its filename. |
description |
Who these people are and their business relationship to the operating organization. |
People can execute a Process through a user interface, an API-backed application or a chat tool.
For example, a retail System can serve Employees and Customers. A procurement System can serve Employees and Suppliers. A transport System can serve Employees, Customers and Transporters. The System's author identifies the Audiences appropriate to its purpose.
An Audience has a name and documentation explaining its population and business relationship. Each Process declares one required audience, using the exact Audience name. The Audience's Process list is read from those references; do not store a second list in the Audience file. Internal, scheduled and message-driven Processes also declare the Audience whose work they support. Their channels determine how they can be invoked, not this association.
The Audience specification is Audience.schema.json.
JSON Example#
{
"name": "Employees",
"description": "People working for the organization operating the System who maintain supplier information for purchasing activities."
}
The ReadSupplier Process declares "audience": "Employees". The referenced Audience must exist in the System. This association describes business responsibility; it does not configure access permissions.