Volunteering system

The volunteering system allows us to manage volunteers at EMF. You can find more detail on these models are used in the volunteering app docs.

Volunteer

class models.volunteer.volunteer.Volunteer(**kwargs)

A volunteer, which is mapped 1:1 to a website User.

user: Mapped[User]

The website user object for this volunteer

interested_roles: Mapped[list[Role]]

Roles a volunteer is interested in performing

trained_roles: Mapped[list[Role]]

Roles a volunteer has been trained to perform

property administered_role_ids: set[int]

Role IDs this user can administer, combining direct role admin and team admin.

property administered_team_ids: set[int]

Team IDs this user can administer.

Roles

class models.volunteer.role.Role(**kwargs)

A role which a volunteer can perform.

slug: Mapped[str]

A short, stable, urlsafe, identifier used for de-duplication during data seeding.

name: Mapped[str]

The name used to present a role. Should be kept short as it gets used in lists.

description: Mapped[str | None]

A brief summary of the role

full_description_md: Mapped[str | None]

A longer description of the role, supports Markdown.

instructions_url: Mapped[str | None]

A link to some instructions on how to perform the role.

role_notes: Mapped[str | None]

Things to know for the shift

over_18_only: Mapped[bool]

Whether the role is restricted to over-18s (e.g. bar shifts)

requires_training: Mapped[bool]

Whether the role requires training to perform

team: Mapped[Team]

The team this role is under

admins: Mapped[list[RoleAdmin]]

Admins for this role

shifts: Mapped[list[Shift]]

Shifts

interested_volunteers: Mapped[list[Volunteer]]

Volunteers who are interested in this role

trained_volunteers: Mapped[list[Volunteer]]

Volunteers who are trained for this role

class models.volunteer.role.RoleAdmin(**kwargs)

Join table used to indicate a given volunteer has admin permissions for a role.

volunteer: Mapped[Volunteer]

Volunteer to be an admin

role: Mapped[Role]

Role the user is an admin for

class models.volunteer.role.RolePermission(**kwargs)

Shifts

class models.volunteer.shift.Shift(**kwargs)

An available shift for one or more volunteers to perform.

min_needed: Mapped[int]

Minimum number of volunteers required for the shift

max_needed: Mapped[int]

Maximum number of volunteers required for the shift

role: Mapped[Role]

Role that this shift is filling

venue: Mapped[VolunteerVenue]

Venue where the shift occurs

occurrence: Mapped[Occurrence]

Optional Occurrence (talk/workshop) related to this shift

entries: Mapped[list[ShiftEntry]]

Entries (volunteers) for this shift

is_clash(other)

Calculate whether this shift clashes with another.

We use this to determine if we should allow a volunteer to sign up for both shifts, which is only permitted if the other shift is filling the same role in the same venue. In all other cases a volunteer can’t sign up for two shifts at the same time.

This is needed because contiguous shifts often have a slight overlap.

classmethod get_all_for_day(day)

Return all shifts for the requested day.

Return type:

Sequence[Self]

classmethod generate_for(role, venue, first, final, min, max, base_duration=120, changeover=15)

Build Shift records between start and end times.

Return type:

list[Shift]

Args:

first: an ISO8601 datetime indicating the start of the first shift

final: an ISO8601 datetime indicating the end of the last shift

min: is the minimum number of people needed to staff these shifts and still get the job done.

max: is the maximum number of people who can practically staff these shifts and having something to do.

base_duration: is how long we want a shift to be. The last shift of the day may be slightly shorter.

changeover: indicates the time in minutes to overlap two shifts, allowing some time for volunteers to handover between each other. Shifts will start changeover minutes before the configured start time.

class models.volunteer.shift.ShiftEntry(**kwargs)

Join table used to indicate a volunteer has signed up for a given shift.

state: Mapped[ShiftEntryState]

Indicates whether a volunteer has arrived for/completed a shift.

Venues

class models.volunteer.venue.VolunteerVenue(**kwargs)

A location for a volunteering shift.