The Pilgrim's Path

Aplicación de gestión de peregrinos, paradas y estancias desarrollada como proyecto formativo con Java, Spring Boot y JPA/Hibernate.

Qué incluye

• Registro y gestión de peregrinos.
• Administración de paradas, estancias e itinerarios.
• Perfiles diferenciados para invitados, peregrinos, administradores de parada y administración general.
• Autenticación y autorización.
• Persistencia con varios motores y modelos de datos utilizados durante el ejercicio.
• Exportación de información en XML.

Stack

• Java
• Spring Boot
• JPA / Hibernate
• Maven
• MySQL / MariaDB
• MongoDB
• ObjectDB / DB4O
• eXist-db
• MVC

Puntos de interés técnico

El proyecto concentra buena parte de su valor en comparar distintos modelos de persistencia dentro de una misma aplicación. La lógica de gestión se mantiene reconocible mientras cambian las tecnologías utilizadas para almacenar y recuperar información.

También sirve como referencia de una aplicación Spring tradicional con autenticación, separación MVC y exportación de datos.

Contexto y estado

El repositorio se conserva como proyecto académico y como referencia histórica. Algunas dependencias y servicios externos reflejan el entorno utilizado durante el desarrollo original y pueden requerir configuración adicional para reproducirlo hoy.

Puesta en marcha

Clona el repositorio y construye el proyecto con Maven usando la configuración correspondiente a las bases de datos que quieras probar:

git clone https://github.com/AlthausDev/01-ThePilgrimsPath.git
cd 01-ThePilgrimsPath

Compilación reproducible (Java 21)

El código utiliza la biblioteca legada db4o. El JAR ya se encuentra en lib/, pero no está publicado como dependencia Maven del proyecto. Instálalo desde ese archivo local antes de compilar:

mvn -B org.apache.maven.plugins:maven-install-plugin:3.1.4:install-file \\
  -Dfile=lib/db4o-8.0.224.15975-core-java5.jar \\
  -DgroupId=com.db4o -DartifactId=db4o -Dversion=8.0.224.15975 \\
  -Dpackaging=jar -DgeneratePom=true
mvn -B verify

La CI realiza estos mismos pasos. La compilación correcta no garantiza que los motores de persistencia antiguos funcionen con Java 21 en producción; requieren pruebas de integración específicas. El JAR db4o es de terceros y sus condiciones de distribución deben revisarse por separado de la licencia del código del repositorio.

Licencia

Este proyecto está publicado bajo Creative Commons Attribution-NonCommercial 4.0 International. Consulta LICENSE.md.

Si reutilizas contenido original, conserva la atribución a Sam Althaus / AlthausDev según los términos de la licencia.