WikiSmart

Equipo

2.18: GESTOR DE CAZA

Componente C2.18 – Gestor de Caza

Introducción

El componente C2.18 – Gestor de Caza forma parte del proyecto La Palma Smart Island. Su objetivo es dotar al Cabildo Insular de La Palma de una solución digital que permita gestionar de forma centralizada y eficiente toda la actividad cinegética de la isla.

Este sistema responde a la necesidad de modernizar y digitalizar los procesos actualmente gestionados de forma manual, facilitando la tramitación de licencias, permisos, control de capturas, gestión de cotos y zonas cinegéticas, así como la supervisión por parte de los técnicos del Cabildo.

Actores del Sistema

  • Propietario de coto de caza.
  • Titular de licencia de caza.
  • Técnico del Cabildo.
  • Técnico con acceso restringido / usuarios externos autorizados (Agentes de Medioambiente, SEPRONA).

Funcionalidades Principales

Para Propietarios de Cotos

  • Consulta y modificación de datos administrativos.
  • Notificación de cambios y errores.
  • Aportación de datos para el Plan Técnico de Caza.

Para Titulares de Licencias

  • Solicitud y renovación de licencias.
  • Solicitud de pruebas de aptitud.
  • Gestión de morraleros, perros de caza y licencias de armas.
  • Gestión de cuadrillas y días de Caza Mayor.

Para Técnicos del Cabildo

  • Alta y gestión de cotos y zonas cinegéticas.
  • Tramitación de solicitudes.
  • Control de acceso y salida en Caza Mayor.
  • Gestión de sanciones y notificaciones.
  • Consulta de estadísticas.

Funcionalidades Comunes

  • Autenticación y gestión de usuarios.
  • Visualización de históricos y observaciones.
  • Impresión de carnets digitales.

Arquitectura de la Solución

Arquitectura Lógica

  • Capas: interoperabilidad, persistencia, servicios.
  • Uso de API REST, PostgreSQL, Drupal, etc.

Arquitectura de Despliegue

  • Servidores involucrados.
  • Integración con la Plataforma Smart.

Tecnologías Utilizadas

  • Backend: Drupal, Symfony, PostgreSQL/PostGIS.
  • Frontend: Bootstrap, Twig, jQuery.
  • Librerías y herramientas: Composer, CKEditor, Guzzle, etc.

 

Prototipo de la Solución

Tiene como objetivo mostrar, mediante un prototipado gráfico, el flujo de navegación y las principales funcionalidades del Gestor de Caza, en respuesta a los requisitos funcionales definidos en la fase de análisis y diseño.

Se han desarrollado mockups de las pantallas clave del sistema, representando de forma visual la estructura, contenido y disposición de los elementos del portal, tanto para el perfil de cazador como para el de técnico del Cabildo.

Fundamentos de diseño

  • Basado en la identidad visual de La Palma Smart Island.
  • Paleta de colores: tonos grises con opacidad y blanco para el contenido.
  • Tipografía: Lato, en versiones regular y bold.
  • Diseño responsivo y accesible.

El diseño del Gestor de Caza se ha concebido para ofrecer una experiencia de usuario clara, accesible y coherente con la identidad visual del proyecto La Palma Smart Island. A continuación, se detallan los principios y elementos clave que rigen su interfaz:

  • Simplicidad visual: se prioriza la claridad y la legibilidad, evitando sobrecargar las pantallas.
  • Consistencia: todos los elementos visuales (colores, tipografías, botones, menús) mantienen una coherencia visual en todas las vistas.
  • Accesibilidad: se utilizan contrastes adecuados y estructuras claras para facilitar el uso por parte de todos los perfiles de usuario.

Paleta de colores

Basada en los colores del logotipo de La Palma Smart Island, adaptados con opacidades para mejorar la legibilidad:

Elemento UI Color base Descripción
Cabecera #B3B8BD Gris neutro para encabezados y fondo superior.
Menú lateral #CBCED0 Gris claro con 50% de opacidad.
Texto principal #000000 Negro al 100% para máxima legibilidad.
Fondo de contenido #FFFFFF Blanco para destacar los bloques de información.
 

Tipografía

  • Fuente: Lato
  • Estilos: Regular y Bold, según jerarquía de contenido.
  • Color: Negro puro (#000000)

Estructura visual común

  • Cabecera fija: siempre visible en la parte superior, con el logo de Smart Island y el título del portal.
  • Menú lateral: vertical, a la izquierda, con navegación contextual según el perfil del usuario.
  • Zona de contenido: espacio central en blanco, donde se muestran formularios, tablas, gráficos y mensajes.

Elementos comunes de la interfaz

El diseño del Gestor de Caza mantiene una coherencia visual y funcional en todas sus pantallas, tanto para el perfil de Titular de Licencia de Caza como para el de Técnico del Cabildo. Los elementos comunes son los siguientes:

Cabecera fija superior

  • Presente en todas las vistas.
  • Color de fondo: gris #B3B8BD.
  • Contiene el logo de La Palma Smart Island y el título del portal:
    “Gestor de Caza, La Palma”.

Menú lateral

  • Barra vertical situada a la izquierda.
  • Color: gris claro #CBCED0 (50% opacidad).
  • Contiene las secciones y subsecciones disponibles según el perfil del usuario.
  • El menú resalta la sección activa con una banda de color.

Tipografía

  • Fuente: Lato.
  • Color: negro #000000.
  • Estilos: regular y bold, según el tipo de contenido.

Estructura visual

  • Espacio central en blanco para mostrar el contenido principal.
  • Diseño limpio y jerárquico para facilitar la navegación.

 Perfiles de Usuario

Perfil Descripción
Titular de Licencia de Caza Cazador registrado que puede gestionar su licencia, permisos, cuadrillas, perros, etc.
Propietario de Coto de Caza Usuario con acceso a la información administrativa de su coto.
Técnico del Cabildo Usuario con acceso completo para gestionar solicitudes, permisos, sanciones, estadísticas, etc.
Técnico con acceso restringido / Externos Acceso limitado a consultas específicas (SEPRONA, Agentes de Medioambiente).
 

Pantalla de Inicio de Sesión

  • Imagen de fondo a pantalla completa.
  • Logo de La Palma Smart Island.
  • Formulario de acceso con campos de email y contraseña.
  • Botón de acceso al sistema.

Interfaz del Cazador

Registro y Acceso

  • Formulario de registro con todos los campos necesarios.
  • Opciones para iniciar sesión o recuperar contraseña.

Menú del Cazador

  • Inicio
  • Licencia
  • Censo de Perros
  • Caza Mayor
  • Solicitudes
  • Sanciones

Funcionalidades

  • Consulta de licencia en vigor.
  • Gestión de perros (alta, baja, modificación).
  • Consulta de cuadrilla y permisos de Caza Mayor.
  • Solicitudes:
    • Licencia de caza
    • Renovación
    • Prueba de aptitud
    • Morraleros
    • Cuadrilla
    • Permiso de día de caza
    • Permiso de armas
  • Consulta de sanciones aplicadas.

Interfaz del Técnico del Cabildo

Menú del Técnico

  • Inicio
  • Licencias
  • Solicitudes
  • Especies cinegéticas
  • Tipos de licencias
  • Sanciones
  • Estadísticas
  • Zonas cinegéticas y cotos
  • Censo de perros
  • Permisos
  • Usuarios

Funcionalidades

  • Gestión de licencias: consulta, edición, eliminación.
  • Gestión de solicitudes: validación, edición, resolución.
  • Gestión de especies y tipos de licencia.
  • Gestión de sanciones: alta, edición, eliminación.
  • Consulta de estadísticas por edad, género, tipo de licencia.
  • Alta y edición de zonas cinegéticas y cotos.
  • Gestión del censo de perros.
  • Gestión de permisos de caza mayor:
    • Control de entrada y salida
    • Registro de capturas
    • Invitados del Cabildo
  • Gestión de usuarios registrados.

 

Tecnologías utilizadas

Librerías instaladas

El sistema del Gestor de Caza se apoya en un conjunto de librerías que garantizan su funcionalidad, rendimiento y compatibilidad con la Plataforma Smart Island. Entre ellas se encuentran:

El sistema hace uso de una amplia variedad de librerías para funcionalidades de edición, interfaz, interacción y procesamiento. A continuación, se detallan las principales:

Librerías de edición y UI

  • ckeditor5 (v40.2.0): múltiples módulos como editorClassic, blockquote, image, table, codeBlock, style, etc.
  • internal.backbone (v1.5.0)
  • internal.jquery.form (v4.3.0)
  • internal.shepherd (v10.0.1)
  • jquery (v3.7.1)
  • modernizr (v3.11.7)
  • normalize (v8.0.1)
  • sortable (v1.15.1)
  • tabbable (v6.2.0)

Librerías del core de Drupal

  • drupal, drupal.ajax, drupal.dialog, drupal.states, drupal.vertical-tabs, drupal.tabledrag, drupal.tableheader, entre muchas otras.

Otras utilidades

  • loadjs (v4.2.0)
  • once (v1.0.1)
  • js-cookie (v3.0.5)
  • es6-promise
  • phpwkhtmltopdf (v2.5)
  • tcpdf (v6.0)
  • composer-patches (v1.7)
  • email-validator (v3.0)
  • installers (v2.0)
  • guzzle (v7.8.1)
  • diff (v4.0.6)
  • php-parser (v5.0)
  • phpmailer (v6.9.3)

Librerías de plantillas

Estas librerías permiten la generación de interfaces visuales y documentos:

  • Bootstrap: v5.3.3
  • Twig: v3.8.0
  • php-css-parser: v8.7.0
  • HTML5
  • dompdf: v3.0.1
  • tcpdf: v6.7.7

Fuentes tipográficas

  • Lato: utilizada en el tema personalizado del portal.
  • Segoe UI: utilizada en el tema de administración.

 

Configuraciones y Parametrizaciones

Este apartado documenta las configuraciones técnicas, plantillas, módulos contribuidos y módulos personalizados utilizados en el desarrollo del componente Gestor de Caza, como parte de la Plataforma Smart Island.

El objetivo es garantizar la trazabilidad de las decisiones técnicas y facilitar el mantenimiento, evolución y despliegue del sistema.

Plantillas contribuidas

Plantilla Descripción
drupal/bootstrap_barrio Permite construir el frontend utilizando el framework Bootstrap.
drupal/bootstrap_sass Extiende la anterior permitiendo el uso de SCSS para los estilos.
 

Módulos contribuidos

A continuación se listan los módulos de la comunidad Drupal utilizados, con su funcionalidad principal:

Administración y experiencia de usuario

  • admin_toolbar: mejora la barra de herramientas de Drupal.
  • better_exposed_filters: mejora los filtros en vistas.
  • field_group: agrupa campos en formularios.
  • paragraphs: permite crear campos compuestos reutilizables.
  • pathauto: genera URLs amigables.
  • scheduler: permite programar publicación/despublicación de contenidos.
  • smtp: configuración de envío de correos.
  • ctools: utilidades y APIs para otros módulos.
  • entity_print: exportación de entidades a PDF, Word, etc.
  • auto_entitylabel: etiquetas automáticas para entidades.
  • dependent_fields: campos dependientes entre sí.
  • entity_reference_revisions: referencia a revisiones específicas de entidades.
  • hide_revision_field: oculta el campo de revisiones.
  • poll: encuestas.
  • remove_username: oculta el campo de nombre de usuario.
  • registration_role: asignación de roles en el registro.
  • structure_sync: sincronización de estructuras entre entornos.
  • time_field: campo de hora sin fecha.
  • token: tokens dinámicos para reemplazo de texto.
  • ultimate_cron: mejora del sistema de cron.
  • user_redirect: redirección tras login/logout.
  • views_contextual_filters_or: filtros contextuales con lógica OR en Views.

Módulos personalizados

Estos módulos han sido desarrollados específicamente para el componente Gestor de Caza:

Módulo Funcionalidad
cazadores_clear_data Reseteo anual del contenido: bajas de licencias, eliminación de cuadrillas.
cazadores_email_notifications Envío de notificaciones por correo según el estado de las solicitudes.
cazadores_functionalities Funcionalidades varias: acceso a nodos, formularios, etc.
cazadores_license_restriction Restricciones de acceso a licencias.
cazadores_permisions_by_transitions Control de permisos según transiciones de estado.
cazadores_requests_menu_block Limpieza dinámica del menú según permisos de usuario.
 

 

Tipos de Usuarios

Rol Funcionalidades principales
Administrador Control total del BackOffice.
Gestor (Técnico del Cabildo) Gestión de contenidos, licencias, permisos, especies, zonas, estadísticas.
Gestor restringido Consulta limitada y edición de controles de entrada/salida.
Cazador Solicitud de licencias, registro de perros, morraleros, cuadrillas.
Propietario de Coto Consulta y actualización de datos del coto.
 

Estructura de Datos

Entidades principales

  • Usuario
  • Licencia
  • Perro
  • Sanción
  • Prueba de aptitud
  • Morralero
  • Permiso de armas
  • Cuadrilla de caza mayor
  • Permiso de caza mayor
  • Control de entrada
  • Control de salida
  • Zona cinegética
  • Coto de caza

Cada entidad contiene campos específicos con atributos como: identificador, nombre, apellidos, DNI, teléfono, municipio, imágenes, fechas, referencias a taxonomías, etc.

Taxonomías

Municipios

  • Barlovento
  • Breña Alta
  • Breña Baja
  • El Paso
  • Fuencaliente
  • Garafía
  • Los Llanos de Aridane
  • Puntagorda
  • Puntallana
  • San Andrés y Sauces
  • Santa Cruz de La Palma
  • Tazacorte
  • Tijarafe
  • Villa de Mazo

Tipos de licencias

  • A1, A1-C, A1-C1-R, A1-R
  • A2, A2-C, A2-R
  • B, B1, B1-C, B1-R, B2-C

Tipos de licencias “otras islas”

  • C, R

Especies de caza mayor

  • Arruí
  • Muflón

Especies de caza menor

  • Animales asilvestrados
  • Codorniz común
  • Conejo
  • Paloma bravía
  • Perdiz moruna
  • Perdiz roja
  • Tórtola común

C2.18 – Manual de Administración

Describe los procesos administrativos del Gestor de Caza. Está dirigido a usuarios con rol de Administrador, responsables de gestionar contenidos, usuarios, módulos y configuraciones del sistema Drupal.

Introducción a Drupal

  • Versión utilizada: Drupal 10.2.4
  • Características clave: Modularidad, seguridad, escalabilidad, código abierto.
  • Tipos de usuarios definidos:
    • Usuario anónimo
    • Usuario autenticado
    • Cazador
    • Titular de coto
    • Gestor
    • Gestor restringido
    • Administrador

Administración del Portal

Acceso

  • URL de login: /user/login

Menú de administración

  • Secciones principales:
    • Contenido
    • Estructura
    • Apariencia
    • Ampliar (módulos)
    • Configuración
    • Usuarios
    • Informes
    • Ayuda

Configuraciones del Sitio

  • Sistema: Nombre del sitio, correo, eslogan.
  • Usuarios: Campos y roles.
  • Auditoría: Formatos de texto.
  • Interfaz: Atajos y menú.
  • Búsqueda y metadatos: Alias de URLs.
  • Desarrollo: Caché, errores, contenido de prueba.
  • Multimedia: Formatos gráficos.
  • Regional e idioma: Localización y horarios.
  • Servicios web: Configuración pública/privada.
  • Flujos de trabajo: Estados y transiciones.

Gestión de Menús

  • Menú de Gestor: /admin/structure/menu/manage/menu-gestor
  • Menú de Cazador: /admin/structure/menu/manage/menu-cazador
  • Menú de Titular de Coto: /admin/structure/menu/manage/menu-titular-coto

Módulos

Contribuidos

  • SMTP
  • Admin Toolbar
  • Entity Print
  • Interface Translation
  • Paragraphs
  • Workflows
  • Field Group
  • Dependent Fields
  • Scheduler
  • Pathauto
  • User Redirect
  • Registration Role
  • Ultimate Cron

Personalizados

  • cazadores_license_restriction
  • cazadores_requests_menu_block
  • cazadores_clear_data
  • cazadores_email_notifications
  • cazadores_functionalities
  • cazadores_permisions_by_transitions
  • gestor_de_cazadores_migracion

Bloques

  • Gestión desde: /admin/structure/block
  • Personalización por tema y región.
  • Reglas de visibilidad por página.

Cron y Caché

  • Cron: /admin/config/system/cron
  • Caché: /admin/config/development/performance

Traducciones

  • Interfaz: /admin/config/regional/translate
  • Exportar/Importar: Archivos .po para traducción masiva.

Informes

  • Mensajes de registro: /admin/reports/dblog
  • Informe de estado: /admin/reports/status

Gestión de Usuarios

  • URL: /admin/people
  • Funciones:
    • Ver, editar, eliminar usuarios
    • Asignar roles
    • Crear atajos
    • Visualizar perfil

Vistas

  • URL: /admin/structure/views
  • Permite crear páginas y bloques personalizados.

Tipos de Contenido

Incluye:

  • Control de entrada/salida
  • Cuadrilla caza mayor
  • Licencia
  • Morralero
  • Permiso caza mayor/arma
  • Prueba de aptitud
  • Perro
  • Página básica
  • Sanción
  • Solicitudes (coto, cuadrilla)
  • Zona cinegética / Zona de coto

Párrafos

Tipos definidos:

  • Asistencia Cazadores
  • Línea hoja de control
  • Línea hoja de control salida

Taxonomías

Vocabularios utilizados:

  • Especies de caza mayor
  • Especies de caza menor
  • Municipio
  • Tipo de licencia
  • Tipo de licencia (Otras islas)

 Manual de Gestor 

Describir los procesos de gestión de contenidos del componente C2.18 Gestor de Caza, orientado a usuarios con rol Gestor, responsables de:

  • Tramitación de solicitudes.
  • Gestión de licencias, permisos, sanciones y censos.
  • Administración de zonas cinegéticas y cotos.
  • Control de capturas y generación de estadísticas.

Acceso a la Plataforma

  • URL: https://lapalmasmart-caza.lapalma.es
  • Requiere usuario con rol Gestor.
  • Interfaz amigable basada en Drupal, centrada en la funcionalidad.

Funcionalidades del Rol “Gestor”

Funcionalidad Descripción
Usuarios Consulta y gestión de usuarios registrados.
Licencias Gestión de licencias de caza.
Solicitudes Tramitación de solicitudes (aptitud, licencias, permisos, etc.).
Especies cinegéticas Alta, edición y eliminación de especies.
Tipos de licencias Gestión de tipos de licencias (incluye otras islas).
Zonas y Cotos Alta y edición de zonas cinegéticas y cotos.
Morraleros y Perros Gestión de censos.
Permisos Tramitación de permisos de caza mayor.
Controles de Caza Mayor Registro de controles de entrada y salida.
Sanciones Registro y gestión de sanciones sobre licencias.
Estadísticas Visualización y descarga de estadísticas generales y de pruebas de aptitud.
 

Tipos de Solicitudes Gestionables

  1. Prueba de Aptitud
  2. Licencia de Caza
  3. Permiso de Armas
  4. Alta de Morralero
  5. Cuadrilla de Caza Mayor
  6. Permiso de Caza Mayor
  7. Cambio de datos en Coto

Cada solicitud puede estar en los estados: Borrador, En trámite, Problemas a subsanar, Aprobada, Rechazada.

Estadísticas Disponibles

  • Licencias por tipo, género, edad y municipio.
  • Licencias con recargo (otras islas).
  • Solicitudes de prueba de aptitud por género y municipio.
  • Exportables en PDF.

Gestión de Controles de Caza Mayor

  • Control de entrada: verificación de documentación y asistencia.
  • Control de salida: registro de piezas abatidas y datos biométricos.
  • Ambos controles se generan automáticamente al aprobar un permiso de caza mayor.

Despliegue de la Solución, Servicios Web y APIs (Versión 1.0)

Describir el despliegue técnico del componente C2.18 Gestor de Caza, su integración con la Plataforma Smart Island, y los modelos de datos y APIs utilizados.

Integración con Plataforma

  • Integración mediante API del Context Broker.
  • Datos accesibles desde otros verticales y sistemas de la plataforma.
  • Cumplimiento con requisitos de datos abiertos y reutilización.

Modelos de Datos

Modelo NGSI

Se definen dos entidades principales:

  • HunterLicense: Información de licencias de caza.
  • HunterUser: Información de usuarios cazadores.

Cada entidad incluye atributos como licenseId, typeLicense, refHunterUser, status, userId, name, email, birthDate, municipality, etc.

Modelo de Base de Datos (PostgreSQL)

Tablas y vistas implementadas:

  • hunting_hunterlicense, hunting_hunterlicense_lastdata, hunting_hunterlicense_historic_join
  • hunting_hunteruser, hunting_hunteruser_lastdata, hunting_hunteruser_historic_join

Scripts SQL para inicialización y vistas de datos históricos y actuales.

Documentación C2.18 Gestor de Caza

Documentación C2.18

Gestión del Cambio

Análisis y diseño

Modelo de datos

Plan de pruebas

Prototipo 

Configuración y parametrizaciones 

Fuentes y librerías 

Despliegue de la solución 

Capacitación 

Manual administrador 

Manual gestor