Podium is the request portal for samples, data and images from biobanks with the purpose to uniformize the request and review processes for all associated users and organisations.
Podium is built in a microservices architecture which works in following way:
-
Podium Registry
The registry is a runtime application on which all applications registers and get their configuration from. It also provides runtime monitoring dashboards. The registry application is available in the Podium Registry repository. -
Podium UAA
Podium UAA is a user accounting and authorizing service for securing microservices using the OAuth2 authorization protocol. Podium UAA is an fully configured OAuth2 authorization server with the users and roles endpoints inside, wrapped into a usual JHipster application. This allows the developer to deeply configure every aspect of his user domain, without restricting on policies by other ready-to-use UAAs. -
Podium Gateway
The gateway serves the Angular frontend application, contains a component for handling requests and deliveries, and also handles web traffic
The services have to be started in order.
For development, you can create a Postgres database locally with psql:
sudo -u postgres psql
create role "podiumUser" with password 'podiumUser' login;
create database "podiumUaaDev";
create database "podiumGatewayDev";
grant all on database "podiumUaaDev" to "podiumUser";
grant all on database "podiumGatewayDev" to "podiumUser";Before you can build this project, you must install and configure the following dependencies on your machine:
- Maven: Maven is used to build the microservices and to publish them to a Nexus repository.
- Node.js: We use Node to run a development web server and build the project. Depending on your system, you can install Node either from source or as a pre-packaged bundle.
- Yarn: We use Yarn to manage Node dependencies. Depending on your system, you can install Yarn either from source or as a pre-packaged bundle.
Java dependencies are managed by Maven in the pom.xml files. Versions of packages are
configured in the root pom.xml.
Yarn is used to manage CSS and JavaScript dependencies for the user interface application.
You can upgrade dependencies by specifying a newer version in package.json.
You can use npm install, yarn update and yarn install to manage dependencies.
First everything should be installed by running the following in the root folder:
mvn clean install-
Start Podium Registry
Podium Registry needs to be up and running before the UAA and Gateway services start. Go to yourpodium-registryfolder and start the registry withmvn. The user interface of the registry will be available at http://localhost:8761. -
Start ElasticSearch Run
docker run --name podium-elasticsearch -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" docker.elastic.co/elasticsearch/elasticsearch:7.6.2. -
Start Podium UAA
Open a new terminal and navigate to thepodium-uaafolder and start the UAA service withmvn. The UAA service will be listening to port 9999. -
Start Podium Gateway
Open a new terminal and run the following commands in thepodium-gatewayfolder:
# start the podium gateway service
mvnThe application is now available at http://localhost:8080.
To create a blissful development experience, where your browser auto-refreshes when files change on your hard drive, you can start a hot reloading user interface with:
# serve the user interface for hot reloading
npm run startThis will open the application at http://localhost:9000 in your browser.
To optimize the podiumGateway application for production, run:
# Build for production
mvn -DskipTests -Pprod clean package
# Publish to Nexus
mvn -DskipTests -Pprod clean deployThis will concatenate and minify the client CSS and JavaScript files.
It will also modify index.html so it references these new files.
To ensure everything worked, run:
java -jar target/*.warThen navigate to http://localhost:8080 in your browser.
For installing Podium for production use, there is an installation manual.
To launch a service's tests, run in its folder:
mvn -Dspring.profiles.active=h2,test testTests are run automatically on Travis.
User interface unit tests are run by Karma and written with Jasmine.
They're located in src/test/javascript/ in each of the service folders and can be run with:
yarn testThe end to end (e2e) tests use Protractor, Cucumber and are by default configured to use Chrome. They can only be run against a development environment. The reason for this is that the setup steps makes use of routes from podium-uaa TestResource. These routes are excluded for production.
1. Install protractor:
Part of the dev dependencies:
yarn install2. Run a development environment
3. Run tests
# Navigate to the test folder
cd podium-gateway/src/test/javascript/
# Run all tests
npx protractor
# Run tests for a specific feature file
npx protractor --specs=e2e/features/bbmri-admin-organisations.featureBy default the test suite expects the user interface to be available at port 8080.
To change this, set the baseUrl setting in protractor.conf.js.
Test are made up out of three main components.
- A scenario described in a feature file.
e2e/features/*.feature - Step definitions
e2e/stepdefinitions/*.ts - Test data
e2e/pages/*.tse2e/data/data-dictionary.tse2e/personas/persona-dictionary.ts
The director class is used to bind the test data to test scripts. dataIds that are in .feature files can be used to
retrieve test data from the appropriate dictionary.
for examples on how to do this look at the .ts files in e2e/stepdefinitions/*.ts
Copyright © 2017, 2018 The Hyve and respective contributors.
This program is free software: you can redistribute it and/or modify it under the terms of the Apache 2.0 License published by the Apache Software Foundation, either version 2.0 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Apache 2.0 License for more details.
You should have received a copy of the Apache 2.0 License along with this program. If not, see https://www.apache.org/licenses/LICENSE-2.0.txt.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent