Skip to content

elubilu/epi-workspace

Repository files navigation

epi-workspace

epi-workspace bundles all the necessary dependencies for building and running EPI SSApps in a single package.

For more details about what a workspace is check out the template-workspace.

Installation

In order to use the workspace, we need to follow a list of steps presented below.

If you have trouble installing the epi-workspace, please try to follow the guide provided on PrivateSky.xyz

Step 1: Clone the workspace

$ git clone https://github.com/PharmaLedger-IMI/epi-workspace.git

After the repository was cloned, you must install all the dependencies.

$ cd epi-workspace
#Important: If you plan to contribute to the project and/or dependecies please set DEV:true
#in the file env.json before you run the installation!
$ npm install

Note: this command might take quite some time depending on your internet connection and you machine processing power.

Step 2: Launch the "server"

While in the epi-workspace folder run:

$ npm run server

At the end of this command you get something similar to:

alt text

Step 3: Build all things needed for the application to run.

Open a new console inside epi-workspace folder and run:

# Note: Run this in a new console inside "epi-workspace" folder
$ npm run build-all

Running

To run the application launch your browser (preferably Chrome) in Incognito mode and access the http://localhost:8080 link.

Enterprise wallet

Enterprise wallet allows creation of Products and Batches.

Step 1: Register details

Username: test1234

Email: test@test.test

Password: test1234567890

Step 2: Setup credential for Issuer

1. Go to Issuer page
2. Put "epi" in application domain field and press "Generate Identity"
3. Copy the the generated issuer identity
4. Paste and save it into /apihub-root/external-volume/issuers-public-identities file. The entry should be on a single line.

Step 3: Setup credentials for Holder

1. Go to Holder
2. Put "epi" in application domain field and press "Generate Identity"
3. Copy the generated User Identity 
4. Paste it into Issuer's field named "Identity of a new user in domain [epi]" and press "Generate Credentials"
5. Copy the generated credentials (from Issuer's page) and paste it into credential field inside the Holder page and press "Save Credentials"

Now you will act as a Holder thus will be able to add Products (and leaflets for it) and create Batches of products.

EPI Client

This is the part a normal user will see. The part that will be used to scan barcodes on drug's packages.

Prepare & release a new stable version of the workspace

Steps:

  1. start from a fresh install of the workspace.
git clone https://github.com/PharmaLedger-IMI/epi-workspace
cd epi-workspace
  1. ensure that env variable called DEV is set to true in env.json file

{ "PSK_TMP_WORKING_DIR": "tmp", "PSK_CONFIG_LOCATION": "../apihub-root/external-volume/config", "DEV": true }

  1. run the installation process of the workspace
npm install
  1. run the server and build the ssapps and wallets
npm run server
npm run build-all
  1. verify that the builds are successfully and the ssapps are functioning properly
  2. execute the freeze command
npm run freeze
  1. verify the output of freeze command and check for errors. If any, correct them and run again the freeze command.
  2. commit the new version of the octopus.json file obtained with the freeze command.

Build Android APK

Steps

  1. Install all dependencies (as develoment) for this workspace
npm run dev-install
  1. Bind Android repository into workspace
npm run install-mobile
  1. Launch API HUB
npm run server
  1. Prepare the Node files that will be packed into the Android app
#In another tab / console
npm build-mobile
  1. Have /mobile/scan-app/android/local.properties file with the following content
# Change the value to your SDK path
sdk.dir=/home/alex/Android/Sdk

More on this here

  1. Build the APK
npm build-android-apk

This concludes the steps to build the APK file.

Note: The .apk file should be in folder

mobile/scan-app/android/app/build/outputs/apk/release

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published