Skip to main content

People & Groups

An actor is anyone or anything that can own content, be given access to it, or make a change. Every piece of content records who created it, and every change records who made it.

Five kinds of actor​

ActorWho it isCan create and change content?
USERA person with an OnEarly account.Yes
GROUPA care team, family, organisation or other group of people. Content a group owns stays with the group, even as members come and go.Yes, through members allowed to act for it
AGENTYour OnEarly Agent. Each person has their own.Yes, within the access you give it (see below)
SYSTEMOnEarly itself. Carries out platform processes.Yes
PUBLICEveryone, including people who are not signed in.No — the public can only be given access, never make changes

Author and subject​

Content records two different actors:

  • the author — who created it and owns it
  • the subject — who it is about

They are often different. When a clinic records a result for a patient, the clinic is the author and the patient is the subject.

Acting as yourself or as a group​

When you make a change you act in one of three ways. The way you act decides whose name the change is recorded under, and what is checked.

Acting asRecorded asYour identity
USERYou, personallyShown
GROUPThe groupNot shown — the change is the group's
GROUP_MEMBERYou, as a member of a named groupShown, together with the group
  • Signed in to the app, you act as yourself by default.
  • Acting as a group needs permission from the group (see Group roles). Posting as a group in threads is on the roadmap; see Threads with other people.
  • Requests made with a group's API key act as the group.

Your OnEarly Agent​

Your OnEarly Agent is an actor in its own right, so its work is never confused with yours.

  • It works only within your access. It cannot see or change anything you can't, and it never acts for another person.
  • It asks before changing your content. Changes to content you own happen only after you approve them on an approval card; once you approve, the change is made as you. Content the agent owns, such as a log you ask it to keep, it can write straight away.
  • Shares and invitations are shown on an approve or reject card first, unless you have already told it exactly what to do. See Approvals before it acts for you for every rule.
  • The permissions your agent holds for you can be narrowed or revoked.

Groups​

Groups bring people together around shared information: care teams, families, organisations and programs.

Visibility​

VisibilityCan people find it?How people join
PUBLICYesAnyone can join
PRIVATEYesBy invitation
SECRETNo — only members know it existsBy invitation

Invitations​

People join private and secret groups by invitation, including through an invite link. An invitation is PENDING, ACCEPTED, DECLINED, EXPIRED or REVOKED.

Group roles​

Each member holds one or more roles. A role is a set of group permissions.

RolePermissionsCan it be changed?
AdminEvery group permissionNo
MemberView the groupYes — a group can add to it

Groups can also define their own roles. The names Admin and Member are reserved.

Group permissions​

PermissionAllows
view-groupSee the group.
manage-groupChange group settings and publish members' posts to the group.
view-group-membersSee the member list.
manage-group-membersManage members and their roles.
view-group-member-countSee how many members the group has.
view-group-member-namesSee members' names.
view-group-member-emailsSee members' email addresses.
act-as-group:view-as-groupSee content shared with the group, as the group.
act-as-group:manage-group-contentCreate and change content as the group.
create-sub-groupCreate sub-groups under the group. Sub-groups are on the roadmap.

When a group is created, the Member role can be given only view-group-member-count and view-group-member-names on top of view-group. Email addresses and the right to act as the group are never added to Member at creation.

Membership and content are separate

Joining a group does not give you access to any content by itself. Content becomes visible to members only when it is shared with the group. See Permissions & Roles.