Reservation: Adds reservation cancellation path to resources

TYPE: Feature
LINK: ogc-3064

Author: Tschuppi81

src/onegov/org/forms/__init__.py

@@ -54,6 +54,7 @@
 from onegov.org.forms.text_module import TextModuleForm
 from onegov.org.forms.ticket import (
     InternalTicketChatMessageForm, ExtendedInternalTicketChatMessageForm)
+from onegov.org.forms.ticket import RequestCancellationForm
 from onegov.org.forms.ticket import TicketAssignmentForm
 from onegov.org.forms.ticket import TicketChangeTagForm
 from onegov.org.forms.ticket import TicketChatMessageForm
@@ -115,6 +116,7 @@
     'PublicRequestMTANForm',
     'ReservationAdjustmentForm',
     'ReservationForm',
+    'RequestCancellationForm',
     'ResourceChangeUrlForm',
     'ResourceCleanupForm',
     'ResourceExportForm',

src/onegov/org/forms/resource.py

@@ -381,6 +381,12 @@ class ResourceBaseForm(Form):
         ),
     )
 
+    allow_cancellation_requests = BooleanField(
+        label=_('Enable cancel reservation'),
+        fieldset=_('Cancellation'),
+        default=False,
+    )
+
     def on_request(self) -> None:
         if hasattr(self.model, 'type'):
             if self.model.type != 'room':

src/onegov/org/forms/resource_recipient.py

@@ -87,6 +87,13 @@ class ResourceRecipientForm(Form):
                       'be sent to the above recipient.'),
     )
 
+    cancellation_requests = BooleanField(
+        label=_('Cancellation Requests'),
+        fieldset=_('Notifications *'),
+        description=_('When a customer requests to cancel a reservation, a '
+                      'notification will be sent to the above recipient.'),
+    )
+
     send_on = MultiCheckboxField(
         label=_('Send on'),
         fieldset='Tage und Ressourcen',
@@ -145,6 +152,7 @@ def ensure_at_least_one_notification(self) -> bool | None:
             or self.customer_messages.data
             or self.internal_notes.data
             or self.rejected_reservations.data
+            or self.cancellation_requests.data
         ):
             self.request.alert(_('Please add at least one notification.'))
             return False

src/onegov/org/forms/ticket.py

@@ -1,10 +1,13 @@
 from __future__ import annotations
 
+import sedate
+
 from onegov.chat import MessageFile
 from onegov.core.security import Private
 from onegov.form import Form
 from onegov.form.fields import (ChosenSelectField,
                                 ChosenSelectMultipleEmailField, PanelField)
+from onegov.form.fields import MultiCheckboxField
 from onegov.form.fields import TextAreaFieldWithTextModules
 from onegov.form.fields import UploadFileWithORMSupport
 from onegov.form.filters import strip_whitespace
@@ -17,6 +20,7 @@
 from wtforms.fields import BooleanField
 from wtforms.fields import TextAreaField
 from functools import cached_property
+from wtforms.validators import DataRequired
 from wtforms.validators import InputRequired
 from wtforms.validators import Length
 from wtforms.validators import Optional
@@ -25,6 +29,7 @@
 
 from typing import TYPE_CHECKING
 if TYPE_CHECKING:
+    from onegov.org.models.ticket import ReservationTicket
     from onegov.org.request import OrgRequest
 
 
@@ -180,3 +185,40 @@ def on_request(self) -> None:
             for tag in (item.keys() if isinstance(item, dict) else (item,))
         ]
         choices.insert(0, ('', ''))
+
+
+class RequestCancellationForm(Form):
+    """Cancellation request form for reservation tickets.
+
+    Shows reservation checkboxes when there are multiple reservations,
+    allowing the user to select which ones to cancel. For a single
+    reservation the checkbox field is removed and the form acts as a
+    plain confirmation.
+    """
+
+    if TYPE_CHECKING:
+        model: ReservationTicket
+
+    reservation_ids = MultiCheckboxField(
+        label=_('Select reservations to cancel'),
+        coerce=int,
+        validators=[DataRequired()],
+    )
+
+    def on_request(self) -> None:
+        now = sedate.utcnow()
+        reservations = [
+            r for r in self.model.handler.reservations
+            if r.start is not None and r.start > now
+        ]
+
+        if len(reservations) <= 1:
+            self.delete_field('reservation_ids')
+            return
+
+        self.reservation_ids.choices = [
+            (r.id, self.model.handler.get_reservation_title(r))
+            for r in reservations
+        ]
+        if not self.request.POST:
+            self.reservation_ids.data = [r.id for r in reservations]