LP#1879983: Release notes for Curbside Pickup
[Evergreen.git] / docs / RELEASE_NOTES_NEXT / Circulation / Curbside_Pickup.adoc
1 Curbside Pickup
2 ^^^^^^^^^^^^^^^
3 The Curbside Pickup features in Evergreen provides an interface to help
4 facilitate contact free pickup of library materials.  It provides a dedicated
5 interface in the staff client for library staff to track and manage curbside
6 pickup appointments and materials through the various stages of the process.
7 Staff can also schedule pickup appointments on behalf of patrons.  This feature
8 also allows patrons to schedule their own curbside pickup appointments in their
9 OPAC account, as well as inform the library when they have arrived and are
10 waiting for their materials.  
11
12 This is an extension of the existing holds functionality in Evergreen.  A hold
13 must be placed for an item to be eligible for curbside pickup.  After an item
14 has been captured for a hold and is available for pickup from the holds shelf,
15 a curbside pickup appointment can be scheduled to allow the materials to be
16 obtained in a contact free transaction.
17
18 It can accommodate several different workflows depending on how the library
19 decides to implement curbside pickup.  It can help library staff track and
20 checkout batches of items to be picked up curbside and help facilitate
21 communication between library staff and patrons.  It does not prescribe a
22 specific workflow for curbside pickup.
23
24 It can be used alongside regular (in the library) hold pickup.  Curbside pickup
25 can be an option offered patrons in addition to regular pickup or it can
26 be the primary pickup option depending on tghe library’s current service plan.
27
28 It assumes the library will have a staff member assigned to managing curbside
29 pickup throughout the day.
30
31 Library Settings
32 ++++++++++++++++
33 This feature adds the following library settings.
34
35  * `circ.curbside`: whether to enable curbside appointments for
36    picking up available hold requests. This default to off.
37     
38  * `circ.curbside.granularity`: interval between appointment slots. This
39    defaults to 15 minutes.
40  
41  * `circ.curbside.max_concurrent`: how many appointments to permit per
42    time slot.  This defaults to 10.
43
44  * `circ.curbside.disable_patron_input`: if turned on, display scheduled
45     and pending appointments in My Account in the public catalog but
46     do not give the patron the ability to change them from My Account.
47     This defaults to false, i.e., allowing patrons to modify appointments
48     from My Account.
49
50 Notifications And Action Triggers
51 +++++++++++++++++++++++++++++++++
52 There are several new patron notice options related to curbside pickup. 
53
54 When a patron’s holds are marked as ready for pickup in Evergreen, an email or
55 text/SMS notification can be sent to let them know that curbside pickup is an
56 option at their library.  This notice can be used to promote this service and
57 the default message will prompt patrons to log in to their OPAC account to
58 schedule an appointment or call the library to schedule an appointment.
59 notice message is customizable.  The Trigger Event Definitions for this notice
60 are called:
61
62  * Curbside offer Email notification, triggered by CurbsideSlot reactor on a
63    definition attached to the hold available hook
64  * Curbside offer SMS notification, triggered by CurbsideSlot reactor on a
65    definition attached to the hold available hook
66
67 If a patron has scheduled a curbside pickup appointment, an email or text/SMS
68 notification can be sent to confirm the appointment.  It will also prompt them
69 to log into their account or call the library when they have arrived for their
70 pickup appointment.  The Trigger Event Definitions for this notice are called:
71
72  * Curbside confirmation Email notification
73  * Curbside confirmation SMS notification
74
75 Patrons can receive an email with a list of the items they checked out.  To
76 receive this notice patrons must have an email address associated with their
77 account and the option for “Email checkout receipts by default?” must be
78 selected in their account.  This is an existing notice in Evergreen that ties
79 in to the curbside pickup workflow.
80
81 There is another action trigger called “Trigger curbside offer events and
82 create a placeholder for the patron, where applicable”.  This action trigger
83 does not send a notice to patrons or staff.  It is a silent action behind the
84 scenes that initiates the curbside offer email or SMS notification described
85 above.  
86
87 Upgrade Notes
88 +++++++++++++
89 This feature adds a new OpenSRF service, `open-ils.curbside`, which must be
90 enabled and registered with the public router for the feature to function.
91
92 This feature adds no new staff permissions.