OpenConsent is a java-based microservice that acts as a safe trusted intermediary connecting patients with clinical services and research projects.
For more information about this project, please see my recent blog post.
An updated description of the project is now available here: http://wardle.org/information-governance/2017/04/08/pseudonymous-consent.html
How to get started
- Download the source code.
git clone https://github.com/wardle/openconsent.git
- Compile without unit tests
mvn -DskipTests package
Create a local database - I use PostgreSQL.
Create a config.yml and change your jdbc url for the database you have created
jdbc: postgres: url: jdbc:postgresql:openconsent driverClassName: org.postgresql.Driver initialSize: 10 cayenne: datasource: postgres createSchema: false flyway: locations: - db/migration dataSources: - postgres
- Create the database using flyway migrations.
java -jar target/openconsent-1.0-SNAPSHOT.jar --config=config.yml --migrate
Note: currently at this early stage of development, I am editing migration #1 so use --clean to remove all database tables and then migrate to take into account changes. Once the schemas are relatively stable, any changes will be made properly in migrations.
- You can run the unit tests to check it is all working
- Otherwise, start the REST server:
java -jar target/openconsent-1.0-SNAPSHOT.jar --config=config.yml --server