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:
- admin:admin, administrador de la organización ign. Tiene plenos poderes sobre los espacios de nombres y los miembros gestionados por la organización ign.
- user:user, editor de la organización ign. Tiene plenos poderes sobre los espacios de nombres y los miembros gestionados por la organización ign.
Desarrollo
Antes de pode compilar este proyecto, debe instalar y configurar las siguiente dependencias en su máquina:
- 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.
- 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.
- 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.html
referenciando 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.