DAM1_GRUPO4_2025

Índice

1. Descripción del Proyecto
2. Participantes
3. Diagramas del Sistema
   • Diagrama Entidad-Relación (E/R)
   • Diagrama Relacional
   • Diagrama de Clases
   • Diagrama de Casos de Uso
4. Base de Datos
   • Script SQL
   • Triggers
5. Lógica del Sistema (Java)
6. Página Web y Frontend
7. Transformaciones XSLT
8. Documentación Técnica (JavaDoc)
9. Manual de Usuario
10. Documentos de Seguridad y Prevención
    • Infografía Seguridad Social
    • Subsidios Seguridad Social
    • Peligros y Riesgos de Actividades
    • Plan de Emergencias
11. Recursos OVAs
12. Guía de Despliegue
13. Instalación
14. Uso de la Aplicación
15. Tecnologías Utilizadas

Descripción del Proyecto

Resumen del objetivo del proyecto, su funcionalidad principal y tecnologías utilizadas.

Participantes

• Rebeca Cabo Cianca (@Rebeca467)
• Oriol Fernández Saiz (@MaxwellRoyers)
• Fabián Saiz Landeras (@Napster002)
• Ciro Galán Vertiz (@CiroGalanVertiz)
• Ana María Rodríguez Méndez (@anarodriguezm)

Diagrama Entidad-Relación (E/R)

El diagrama muestra las entidades principales, sus relaciones y atributos clave en el sistema.

Diagrama Relacional

Ver el Diagrama Relacional

El diagrama muestra las entidades principales, sus relaciones y atributos clave en el sistema.

Script BD

Ver el Script

Aqui se puede ver el script de la base de datos.

Diagrama de Clases

El diagrama de clases ilustra la estructura del sistema orientado a objetos, incluyendo clases, métodos y relaciones de herencia o asociación.

Diagrama de Casos de Uso

1. Crear Ruta (Alumno/Diseñador)

Actor: Alumno / Diseñador
Resumen: Permite introducir una nueva ruta de manera manual o cargando un archivo CSV.
Flujo principal:

1. El actor accede a la aplicación y selecciona "Crear Ruta".
2. Introduce la información de la ruta o selecciona un archivo CSV.
3. El sistema calcula automáticamente el nivel de esfuerzo y riesgo.
4. Se guarda la ruta con estado "Pendiente de validación".

Decisiones destacadas:
Se priorizó la carga desde archivo CSV para reducir errores de entrada manual y mejorar la eficiencia.

2. Validar Ruta (Administrador)

Actor: Administrador
Resumen: Aprueba o rechaza rutas pendientes para ser incluidas en el catálogo público.
Flujo principal:

1. Accede a "Rutas Pendientes".
2. Revisa los datos de cada ruta.
3. Decide si validar o no.
4. El sistema cambia el estado a "Validada" o muestra mensaje de rechazo.

Decisiones destacadas:
Solo los administradores pueden validar para asegurar calidad y veracidad.

3. Valorar Ruta (Alumno/Profesor/Invitado)

Actor: Todos los perfiles (excepto no registrados)
Resumen: Permite valorar la dificultad, belleza e interés cultural de una ruta.
Flujo principal:

1. Seleccionar una ruta validada.
2. Introducir valores del 1 al 5 por cada criterio.
3. Guardar valoración.

Decisiones destacadas:
Las valoraciones se almacenan por usuario y se calcula media para mostrar en la interfaz.

4. Descargar Fichas Informativas (Diseñador/Profesor/Administrador)

Actor: Diseñador, Profesor, Administrador
Resumen: Genera informes en formato texto (ficha de seguridad, usuario y organización).
Flujo principal:

1. Selecciona una ruta validada.
2. Elige tipo de ficha.
3. Se genera documento con QR y datos clave.

Decisiones destacadas:
Se usa una plantilla XSLT para personalizar la salida y facilitar impresión o distribución.

5. Eliminar Reseñas (Administrador)

Actor: Administrador
Resumen: Permite eliminar reseñas inapropiadas o que incumplen normas de uso.
Flujo principal:

1. Ver reseñas marcadas por usuarios.
2. Revisar contenido.
3. Confirmar eliminación.

Decisiones destacadas:
Solo accesible por admin para mantener integridad del contenido público.

Pagina web

Ver pagina web

XSLT

Ver XSLT para generación de CSV

Ver XSLT para generación de HTML

La hoja de estilo XSLT define la transformación de un documento XML a formato CSV aparte de la deficinicion de un XSLT para la transformacion de un RSS a HTML, especificando plantillas y reglas para recorrer y convertir los nodos del XML en registros delimitados por comas.

Lógica educativa Java

Para determinar el nivel educativo recomendado de una ruta en base a su dificultad, se ha implementado el siguiente método:

public String getNivelEducativoRecomendado(Ruta r) {
    int esfuerzo = r.getNivelEsfuerzo();
    int riesgo = r.getNivelRiesgo();
    int nivel = Math.max(esfuerzo, riesgo);

    return switch (nivel) {
        case 1, 2 -> "Primaria";
        case 3 -> "Educación Secundaria Obligatoria (ESO)";
        case 4 -> "Bachillerato";
        case 5 -> "Ciclos Formativos / Adultos";
        default -> "Sin especificar";
    };
}

Script Triggers

Ver el Script (Nivel esfuerzo)

Ver el Script (Nivel riesgo)

Aqui se puede ver el script de los triggers.

Documentación JavaDoc

Todas las clases están documentadas con JavaDoc, incluyendo:

• Descripción de propósito
• Parámetros y retorno
• Ejemplos de uso Ver Documentacion JavaDoc

Manual de usuario

Ver Manual de usuario

Infografía Seguridad Social

Ver Infografias

Documento visual que consta sobre multiples apartados de la Seguridad Social.

Subsidios de la Seguridad Social

Ver subsidios

Documento donde se presenta el cálculo de los subsidios de la Seguridad Social.

Peligros y riesgos

Ver peligros y riesgos

Documento donde se muestran los peligros y riesgos de una actividad

Plan Emergencias

Ver plantilla Ver ejemplo 1 Ver ejemplo 2

Documentos en los que vemos una plantilla de plan de emergencias y dos rellenadas con ejemplos

OVAS

Ver Servidor base datos Ver Servidor web

Guia despliegue

Ver guia despliegue

Instalación

git clone https://github.com/Rebeca467/DAM1_GRUPO4_2025
cd proyecto
npm install

Uso

En esta sección se describen las instrucciones para utilizar la aplicación, así como ejemplos de uso y consideraciones importantes.

Requisitos Previos

Antes de utilizar la aplicación, asegúrate de tener instaladas las siguientes herramientas: -Node.js: La aplicación está construida sobre Node.js, por lo que es necesario tenerlo instalado en tu sistema. -Base de Datos: Asegúrate de que la base de datos esté configurada y corriendo según el script proporcionado.

Funcionalidades Principales

Una vez que la aplicación esté en funcionamiento, podrás acceder a las siguientes funcionalidades: -Crear Rutas: Los usuarios pueden crear nuevas rutas manualmente o mediante la carga de archivos CSV. -Validar Rutas: Los administradores pueden revisar y validar rutas pendientes. -Valorar Rutas: Todos los usuarios registrados pueden valorar las rutas en función de diferentes criterios. -Descargar Fichas Informativas: Los diseñadores, profesores y administradores pueden generar informes en formato texto. -Eliminar Reseñas: Los administradores tienen la capacidad de eliminar reseñas inapropiadas.

Ejemplo de Uso Para crear una nueva ruta, sigue estos pasos: Accede a la sección "Crear Ruta". Introduce la información requerida o selecciona un archivo CSV. Haz clic en "Guardar" para almacenar la ruta. Consideraciones Importantes Validación de Datos: Asegúrate de que todos los datos ingresados sean correctos para evitar errores en la creación de rutas. Acceso a Funciones: Algunas funciones están restringidas a ciertos tipos de usuarios (por ejemplo, solo administradores pueden validar rutas). Soporte Si encuentras algún problema o tienes preguntas sobre el uso de la aplicación, no dudes en contactar a los desarrolladores a través de los canales de comunicación establecidos en el proyecto.

Despliegue y Tecnologías

Tecnologías Utilizadas

• Frontend:

  • HTML5, CSS3 y JavaScript
  • Bootstrap para diseño responsive
  • XSLT para transformación de datos XML
  • Generación dinámica de contenidos con JavaScript

• Backend:

  • Java para lógica de negocio y educativa
  • JavaDoc para documentación técnica
  • Scripts SQL para la creación y gestión de la base de datos

• Base de Datos:

  • MySQL
  • Modelado mediante Diagrama E/R y relacional
  • Script de creación (.sql) para despliegue automático

• Otras tecnologías:

  • Git y GitHub para control de versiones y colaboración
  • Visual Paradigm / MySQL Workbench para modelado visual
  • PDF y herramientas gráficas para documentación e infografías

Despliegue

El sistema puede desplegarse localmente o en un entorno de servidor educativo.

Requisitos para el Despliegue Local:

• Node.js (para entorno web local)
• Servidor local (como XAMPP o WAMP) si se requiere backend en PHP/MySQL
• Java JDK 17 o superior
• MySQL Server
• Navegador web actualizado

Pasos para Desplegar la Aplicación:

1. Clonar el repositorio:

   git clone https://github.com/Rebeca467/DAM1_GRUPO4_2025
   cd DAM1_GRUPO4_2025

2. Instalar dependencias:

   npm install

3. Configurar y levantar la base de datos:
   • Abrir MySQL Workbench o cliente similar.
   • Ejecutar el script bd-script-grupo4-definitivo.sql.
4. Ejecutar la aplicación:
   • Compilar y ejecutar desde entorno como Eclipse, Netbeans o IntelliJ.