FAIR Data Point

Castor’s FAIR Data Point allows researchers to share high-level metadata and data of their clinical trials and registries according to existing, community-adopted standards: the DCAT standard and FAIR Data Point metadata specification. This metadata includes textual descriptions of and contact and licensing information for catalogs (groups of datasets), datasets (data collections which are available for access or download in one or more representations) and distributions (specific available form of a dataset).

Setting up development environment

Requirements

To be able to run the FAIR Data Point application locally you need to have the following applications installed:

• docker: https://docs.docker.com/install/
• docker-compose: https://docs.docker.com/compose/install/

Before booting the application

• Copy the .env.dist file into the same folder with the new name .env.local.

• Paste the secrets (marked with [Paste from 1Password]) from the ENG - FDP Limited Access 1Password note in the .env.local file.

• Add the following entry to /etc/hosts:

  127.0.0.1       fdp.castoredc.local
  

Managing the local environment

To boot the application locally run:

yarn build-docker

You can now access the FAIR Data Point via https://fdp.castoredc.local.

To stop the environment run:

yarn stop-docker

To destroy all the containers:

yarn destroy-docker

Building the UI

To build the UI and watch for changes while developing, run:

yarn watch

To build the UI for production use, run:

yarn build

Common errors

In case you see errors related to composer on m1 macbooks

1. Install composer on your local machine from here

    https://getcomposer.org/download/

2. Then run the below comand in root directory of your project

    php composer.phar install