Fork me on GitHub

Module Appointment Desk

Introduction

The Module Appointment Desk is a visualization tool for daily slots and appointments. It integrates a new tab (Day view) giving agents a consolidated view of appointments and slot availability.

Access paths:

  • Appointment context: via the appointment management screens
  • Slot context: via the planning screens

Implementation

The module integrates a dedicated FreeMarker template and a controller, and depends on the appointment plugin:

  • Template: admin/plugins/appointment/modules/desk/manage_appointmentdesks.html
  • Controller: fr.paris.lutece.plugins.appointment.modules.desk.web.AppointmentDeskJspBean
  • Access (with explicit context):
    • /jsp/admin/plugins/appointment/modules/desk/ManageAppointmentDesks.jsp?plugin_name=appointment-desk&id_form=1&context=app
    • /jsp/admin/plugins/appointment/modules/desk/ManageAppointmentDesks.jsp?plugin_name=appointment-desk&id_form=1&context=slot
  • Required RBAC right: AppointmentFormJspBean.RIGHT_MANAGEAPPOINTMENTFORM
  • No additional Spring beans are declared for this module.

Configuration

No specific configuration is required.

Usage

The Day view provides daily navigation and actions to manage slots and capacity for a given form and date. Typical user flow:

  • Navigation: previous day, next day, today button, and datepicker to select the target date.
  • Comments: display of day comments with popovers; creation/modification according to permissions.
  • Open/Close slots: toggle a slot’s availability on the selected day.
  • Surbooking indicator: a dedicated column highlights overbooking situations.
  • Increase number of desks (guichets): add additional desks for the same day, which increases the number of free places across the day’s slots.

Permissions are enforced via RBAC (at least AppointmentFormJspBean.RIGHT_MANAGEAPPOINTMENTFORM) for actions like opening/closing slots, adding comments, or increasing capacity.