Skip to content

25. Roles: owner, team member and guest

  • Status: accepted
  • Date: 2026-11-07

A membership carried one of four roles: owner, member, subcontractor and client. Projects and tasks will be shared with specific people whatever label their contact carries: a client, a supplier, a subcontractor or a contact with no role at all. Two roles for outsiders split one idea by a label the address book already holds. The staff checks of the modules (StaffCheck, OwnerCheck) were also called by hand in each controller, and the address book had none, so a client or subcontractor could read and edit every contact.

  • An outsider sees only what is shared with them, never a module of the organisation.
  • A new screen is closed to outsiders without anyone remembering to close it.
  • What an outsider is comes from one place, the contact they represent.
  • Roles: owner, team member and guest, the meaning of a guest from the linked contact (chosen); keep client and subcontractor and add more labels as they come
  • Access: deny guests by default, with an attribute on the controllers open to them (chosen); a #[StaffOnly] attribute on every staff controller; access_control by path; a voter called from each controller
  • Where the check runs: a kernel.controller listener in Identity (chosen); the firewall

Three roles: owner, team member and guest, stored as owner, member and guest. A migration turns the stored client and subcontractor into guest; going down makes every guest membership a client one, as the two cannot be told apart again. A guest membership must link a contact (Membership refuses one without); the owner and a team member may link their own person record. app:user:create takes owner, member or guest, the contact with --contact=<id>, required for a guest.

GuestAccessGuard turns a guest of the active organisation away with 403 from every controller that does not carry #[OpenToGuest]: the sign-in and its code step, the account (language, two-factor), the choice of organisation, the public document links, the start page and the “Shared with me” page. The start page sends a guest on to “Shared with me”, which the projects module serves (ADR 0026, sharing); the Work routes a guest uses on what is shared with them carry the attribute too. The health check and the inbound mail webhook run on firewalls without a session, so no person is ever signed in there. The sidebar shows guests “Shared with me” and, since sharing, “My tasks”; every module’s navigation, notices and dashboard sections stay for the staff (StaffCheck), the address book included.

A route test walks the whole route collection and expects 403 for a guest on every route outside a short allow-list, so a module added later is checked without a test of its own. The existing per-controller StaffCheck and OwnerCheck calls stay: they separate the owner from team members, which the guard does not.

Paths could not carry the rule: the screens are not under prefixes per audience, and a module that opens a screen to guests would have had to edit the security configuration. Denying by default inverts the cost: forgetting the attribute closes a screen, which a test shows at once, rather than opening one, which nothing shows.

  • Good, because a forgotten check now fails closed, and the address book is closed to outsiders.
  • Good, because the projects module opens its shared screens with one attribute per controller.
  • Bad, because a membership stored as a guest before this change may have no contact; the domain cannot repair it, an operator links one.
  • Bad, because each request of a signed-in user reads their memberships once more, as the staff checks already did.