2.6: GESTOR DE RESERVAS DE INSTALACIONES

Introducción y Objetivo del Componente C2.06 – Gestor de Reserva de Instalaciones

El componente C2.06 – Gestor de Reserva de Instalaciones forma parte del proyecto La Palma Smart Island, una iniciativa orientada a modernizar y digitalizar los servicios públicos insulares mediante el uso de tecnologías inteligentes.

Este componente tiene como finalidad dotar al Cabildo de La Palma y a los Ayuntamientos de una plataforma centralizada que permita a ciudadanos, turistas y entidades del sector consultar, reservar y gestionar instalaciones públicas (deportivas, culturales, sociales o medioambientales) de forma eficiente y accesible.

Objetivos principales

Facilitar a los ciudadanos la reserva en línea de instalaciones públicas.
Permitir a los turistas planificar y reservar espacios antes de su llegada a la isla.
Optimizar el uso de infraestructuras infrautilizadas por parte de los municipios.
Ofrecer a los hoteles una herramienta para cubrir la demanda de sus clientes en cuanto a instalaciones deportivas y de ocio.
Integrar el sistema dentro de la Plataforma Smart Island, aprovechando su arquitectura de servicios.

Este sistema se construye bajo una arquitectura modular, escalable y basada en software libre, garantizando su interoperabilidad, evolución futura y sostenibilidad tecnológica

Análisis y diseño

Analizar los requisitos funcionales y técnicos para diseñar una solución que permita la gestión centralizada de reservas de instalaciones (deportivas, culturales, sociales, medioambientales) por parte de ciudadanos, turistas, hoteles y administraciones locales.

Actores del Sistema

Usuario Web (anónimo): consulta de disponibilidad.
Usuario Web Registrado: reserva, cancelación, confirmación, incidencias.
Gestor de centro: gestión de reservas e instalaciones asignadas.
Administrador de entidad local: gestión de centros, instalaciones y usuarios locales.
Administrador del sistema: gestión completa del sistema.

Componentes Técnicos

Tecnologías: Drupal, PostgreSQL/PostGIS, Apache, librerías JS como jQuery, CKEditor, Select2, etc.
Arquitectura: modular, escalable, interoperable, basada en software libre.
Capas:
- Interoperabilidad (API REST)
- Persistencia (PostgreSQL)
- Servicios (lógica de negocio)
- Aplicación (web y móvil)

Modelo de Datos NGSI

Entidades: Booking y Resource
Atributos como startDate, endDate, resourceId, bookingId, location, equipment, etc.

Requisitos Funcionales y Técnicos

Multientidad
FrontOffice y BackOffice
Gestión de centros e instalaciones
Roles y permisos
Calendario de disponibilidad
Reservas múltiples
Confirmación por email
API abierta
Solución modular y escalable

————————————————————————————————————————————————————————————————-

C2.06 – Diseño Gráfico y Piloto de la Solución

El documento de diseño forma parte del desarrollo del Componente C2.06. Su propósito es presentar, mediante un prototipo navegable, el diseño gráfico y la experiencia de usuario de la aplicación web destinada a la gestión de reservas de instalaciones públicas.

El objetivo principal es mostrar el flujo de navegación y las funcionalidades clave de la solución a través de un conjunto de mockups que representan las pantallas principales de la aplicación. Este diseño busca validar visualmente la estructura, usabilidad y coherencia del sistema antes de su desarrollo definitivo.

El prototipo incluye vistas como:

Página de inicio (Home)
Secciones por tipología de centros
Detalle de centros e instalaciones
Gestión de reservas del usuario
Pantallas de inicio de sesión y registro

Además, se proporcionó un enlace al prototipo navegable en Figma, permitiendo explorar la solución de forma interactiva:

🔗 Prototipo en Figma

Configuraciones y Parametrizaciones

Su propósito es detallar las configuraciones técnicas y parametrizaciones necesarias para el correcto funcionamiento del sistema de reservas.

El objetivo principal es documentar todos los módulos contribuidos y personalizados utilizados en la implementación del gestor de reservas, incluyendo:

Plantillas contribuidas para el diseño del frontend (como bootstrap_barrio y bootstrap_sass).
Módulos contribuidos de Drupal que amplían funcionalidades clave del sistema (como captcha, pathauto, webform, views_bulk_operations, entre muchos otros).
Módulos personalizados desarrollados específicamente para el proyecto:
- reservas: gestiona toda la lógica relacionada con las reservas.
- custom_api_rest: expone una API REST para integraciones externas.

Esta documentación es esencial para garantizar la trazabilidad, mantenimiento y evolución del sistema dentro del ecosistema de la plataforma Smart Island.

Listado de Fuentes y Librerías

Su finalidad es identificar y documentar las fuentes tipográficas y librerías de software utilizadas en el desarrollo de la solución.

El objetivo principal es proporcionar un inventario técnico detallado de los recursos utilizados en la construcción de la aplicación, incluyendo:

Librerías instaladas para funcionalidades del sistema (como ckeditor, jquery, swagger-ui, signature_pad, entre otras).
Librerías de plantillas para el diseño visual (Bootstrap v5.2.3, Swipper v4.3.0).
Fuentes tipográficas utilizadas:
- Arial Rounded MT Bold para el tema personalizado.
- Roboto para el tema de administración.

Documento de Integraciones

Su propósito es describir las integraciones técnicas entre el sistema de reservas y otros componentes de la plataforma Smart Island.

El objetivo principal es documentar gráficamente y textualmente las relaciones entre el sistema de reservas y los siguientes servicios:

Google Analytics: para el seguimiento del uso del portal de reservas.
Servicio de SMS (Movistar): para la confirmación de reservas mediante mensajes de texto.
Context Broker: para el envío de datos estructurados sobre reservas, tanto en tiempo real como en procesos de consolidación diaria.

Estas integraciones se configuran desde el backend del sistema, mediante formularios específicos y clases dedicadas (SMSHandler, ContextBrokerHandler) que gestionan la comunicación con los servicios externos.

Manual de Administrador

El Manual de Administrador está dirigido a los usuarios con el rol rsv_admin, quienes tienen acceso completo a las funcionalidades de gestión del sistema. Su propósito es servir como guía operativa y formativa, permitiendo a los administradores:

Comprender la estructura del sistema.
Navegar por la interfaz de administración.
Realizar tareas de mantenimiento y configuración.
Gestionar usuarios, centros, instalaciones y reservas.

El objetivo principal es describir de forma clara, visual y paso a paso los procesos necesarios para administrar el sistema de reservas. Esto incluye:

Acceso a la plataforma: cómo iniciar sesión y acceder a las herramientas administrativas.
Gestión de usuarios: creación, edición, asignación de roles y control de acceso para ayuntamientos, centros y visitantes.
Configuración de entidades:
- Ayuntamientos: datos institucionales y geográficos.
- Centros: agrupaciones de instalaciones con información detallada.
- Instalaciones: espacios reservables con condiciones específicas.
Definición de tipologías y subtipologías: categorización de instalaciones para facilitar su búsqueda y gestión.
Gestión de horarios: configuración de tramos de apertura, cierres y excepciones (festivos, mantenimiento, etc.).
Supervisión de reservas: consulta y edición de reservas realizadas por los usuarios.

Rol del administrador (`rsv_admin`)

El usuario con este rol tiene acceso a una interfaz simplificada y amigable, diseñada para abstraer la complejidad técnica de Drupal y centrarse en las funcionalidades específicas del portal. A través de una barra de herramientas personalizada, el administrador puede acceder a todos los módulos de gestión sin necesidad de conocimientos técnicos avanzados.

Manual del Gestor de Centros

El Manual del Gestor de Centros proporciona una guía práctica y detallada para los usuarios encargados de administrar las instalaciones, horarios y reservas de un centro específico. Está diseñado para facilitar el uso del sistema a través de una interfaz simplificada, sin necesidad de conocimientos técnicos sobre la plataforma Drupal.

El objetivo principal es describir los procesos de gestión que puede realizar un usuario con rol rsv_centro, incluyendo:

Acceso a la plataforma: cómo iniciar sesión y acceder a las herramientas de gestión.
Gestión de instalaciones: creación, edición y configuración de espacios reservables, incluyendo información general, condiciones de reserva, precios y horarios por defecto.
Configuración de horarios: definición de tramos de apertura y cierre, así como excepciones (festivos, cierres parciales, etc.).
Supervisión de reservas: consulta, edición y cancelación de reservas, así como gestión de incidencias reportadas por los usuarios.

Rol del gestor (`rsv_centro`)

El usuario con este rol tiene acceso a una barra de herramientas personalizada, desde la cual puede gestionar exclusivamente los recursos de su centro. Esta interfaz incluye:

Instalaciones: listado y edición de espacios disponibles.
Horarios: configuración de disponibilidad semanal y excepciones.
Reservas: seguimiento de reservas activas, cancelaciones e incidencias.

Este enfoque garantiza una gestión descentralizada pero controlada, donde cada centro tiene autonomía sobre sus recursos, sin interferir en los de otros centros o entidades.