Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

The Organisation Admin (orgAdmin) role allows organisations operating on the Voluntarily.nz platform to manage their organisation profile and members. Organisations include Schools, Businesses, activity providers and funding agencies.

It grants powers to view and edit areas of the platform specific to their own organisation and members but nowhere else.

People holding the orgAdmin role for their organisation are expected to be the first line of support for members of the organisation seeking help.

Who can get Organisation Admin for the service Voluntarily.NZ?

Criteria for OrgAdmin status

  • Must be a trusted employee of the organisation. For businesses, this would be an HR or CSR representative managing the volunteer programme. For schools, this should be the principal or digital support person. For activity providers - an appropriate representative or delegate.

  • Must be technically capable and understand the privileges granted.

  • Should complete online training for an org admin.

Identifying organisation admin people

  • Account profiles show OrgAdmin in the roles list. On the personal profile tab an icon is shown next to the organisation name indicating admin status.

  • When viewing the organisation home page the orgAdmin will see an Edit button for the profile.

  • API call Listing support id, name and email. - requires a list people permission. 

http://alpha.voluntarily.nz/api/people?q={ "role": "support" }&s="name"&p="name email"

Support Rights

If you have Support status on Voluntarily you have these abilities:

Client Interface

  • Footer - See menu to admin page and other entity pages.

  • MemberSection - See the member table of an organisation

  • supportPage - access to any page wrapped in the supportPageHOC - TODO

  • ActDetailPage - can edit the Activity

  • OpDetailPage - can manage the Opportunity: edit, manage interested volunteers, complete and cancel

  • OrgDetailPage - can edit the organisation

  • OrgDetailForm - Cannot edit the organisation category. category cannot be set to Admin except through db config.

  • OrgListPage - Cannot see Create Organisation button, cannot delete an org

  • PersonDetailPage - Can List people and edit people. Cannot delete.

Admin Pages

  • admin/invite-school - NO

  • admin/goals - No

Support Pages

  • TBD

API

Support can

  • list/get all entities

  • update all entities

  • carry out OrgAdmin functions for all organisations

  • carry out owner functions for activities and opportunities

  • view and modify person record

Support cannot:

  • delete all entities

  • create new people, organisations.

  • set organisation category

Enabling Support Role

To be a support person you must have role = [Role.SUPPORT] set in your Person record or be a member of an org with the Admin (AGENCY) Category.

Explicit Support role

When a person first signs in they are given the default ‘volunteer’ role.

The support role cannot be set through API PUT calls as the field is deleted before save.

Support role can be set by direct editing of the person record in the database. This allows devs to set their support status directly.

x/db/make-admin.js (Give a person the "admin" role) - TODO update to create support staff

However subsequent support staff should have their role set by membership of a support organisation. This makes it easier to add and remove new support staff.

Implicit Support role

People inherit their role and access permissions from the organisations they belong to. Hence an org with ‘admin’ category has members who will have the admin role. This allows us to create an org for ‘voluntarily support’ and to manage people in this role without needing database access.

Note to get support role you must be a MEMBER of and not ORG_ADMIN of the support org.

Setting the category of an organisation can only be done by an existing admin. Hence only an existing admin can create a new admin organisation. VP-1110 - Getting issue details... STATUS

  • No labels