View on GitHub

pid-ms

The implementation of Persistent Identifiers (pid) for Spatial objects is one of the most immediate challenges in the implementation of the INSPIRE Directive. This project aims to build a framework for implementing Persistent Identifiers able to be dereferenced for INSPIRE resources in Spain.

Build Status License

Sistema de Gestión de PID INSPIRE

Esta aplicación ha sido generada usando JHipster 4.7.0, puede encontrar documentación y ayuda en https://jhipster.github.io/documentation-archive/v4.7.0.

Antes de empezar

Esta configurada con datos de prueba para que se pueda entender mejor su funcionamiento. Tras arrancar se requiere que el usuario se autentique para poder ver toda la información:

Desarrollo

Antes de pode compilar este proyecto, debe instalar y configurar las siguiente dependencias en su máquina:

  1. Node.js: Se usa Node para ejecutar un servidor web de desarrollo y compilar el proyecto. Dependiento de su sistema, usted puede instalar Node a partir de los fuentes o una distribución pre-enpaquetada.
  2. Yarn: Se usa Yarn para gestionar las dependencias de Node. Dependiento de su sistema, usted puede instalar Yarn a partir de los fuentes o una distribución pre-enpaquetada.
  3. PostgreSQL: La aplicación está configurada por defecto para utilizar PostgreSQL como base de datos de desarrollo. Opcionalmente incluimos Docker para quien quiera mejorar su experiencia de desarrollo.

Después de instalar Node, debería ser capaz de ejecutar el siguiente comando para instalar las herramientas de desarrollo. Solamente necesitará ejecutar este comando cuando las dependencias cambien en package.json.

yarn install

Se usa Gulp como sistema de compilación. Instale la herramienta Gulp command-line globalmente con:

yarn global add gulp-cli

Ejecute los siguientes comandos en dos terminales separados para crear una experiencia de desarrollo donde su navegador autorecargue cuando los ficheros cambien en su disco duro.

./mvnw
gulp

Bower se usa para gestionar las dependencias CSS y JavaScript en esta aplicación. Puede actualizar las dependencias especificando la nueva versión en bower.json. Puede también ejecutar bower update y bower install para gestionar dependencias.

Añada el flag -h en cualquier comando para ver como puede usarlo. Por ejemplo, bower update -h.

Para obtener más instrucciones sobre como desarrollar con JHipster, eche un vistazo a Using JHipster in development.

Compilando para producción

Para optimizar la aplicación pidms para producción, ejecute:

./mvnw -Pprod clean package

Este concatenará y minificará los ficheros CSS y JavaScript. También modificará index.htmlreferenciando a los nuevos ficheros. Para asegurar que todo funciona, ejecute:

java -jar target/*.war

Entonces navegue a http://localhost:8080 en su navegador.

Diríjase a Using JHipster in production para más detalles.

Testing

Para lanzar los tests de su aplicación, ejecute

./mvnw clean test

Tests de clientes

Los test unitarios son ejecutados por Karma y escritos con Jasmine. Estan localizados en src/test/javascript/ y pueden ser ejecutados con:

gulp test

Para más información, diríjase a Running tests page.

Usando docker para simplificar el desarrollo (opcional)

Puede usar Docker para mejorar su experiencia de desarrollo. Un gran número de configuraciones docker-compose estan disponibles en el directorio src/main/docker para lanzar servicios de terceros. Por ejemplo, para inicializar una base de datos PostgreSQL en un contenedor de docker, ejecute:

docker-compose -f src/main/docker/postgresql.yml up -d

Para pararla y borrar el contenedor, ejecute:

docker-compose -f src/main/docker/postgresql.yml down

También puede dockerizar completamente su aplicación y todos los servicios que dependan de ella. Para lograr esto, primero compile una imagen de docker de su aplicación ejecutando:

./mvnw package -Pprod docker:build

Entonces ejecute:

docker-compose -f src/main/docker/app.yml up -d

Para más información diríjase a Using Docker and Docker-Compose, esta página también contiene información sobre el sub-generador de docker-compose (jhipster docker-compose), que está disponible para generar configuraciones de docker para una o muchas JHipster aplicaciones.

Integración contínua (opcional)

Para configurar CI para su proyecto, ejecute el sub-generador ci-cd (jhipster ci-cd), este le permitirá generar los ficheros de configuración para un gran número de sistemas de integración contínua. Consulte la página Setting up Continuous Integration para más información.