Code Monkey home page Code Monkey logo

supply-chain-poc's Introduction

Vaccine Distribution Traceability using EOSIO NFTs

About This Project:

Amid the COVID-19 pandemic, pharmaceutical companies have been advancing to develop a vaccine against the SARS-CoV-2 virus outbreak. Governments and institutions are also leading a global effort to vaccinate the totality of the world population and end the pandemic.

As of December 2020, three companies have developed vaccines that have demonstrated their efficacy upon continuous studies. Each of these vaccines has different requirements in terms of storage temperatures, expiration times, and handling, requiring precise traceability across logistics operations to safeguard its integrity.

The team at LACChain, a program from the IDB Lab that works to accelerate the blockchain ecosystem in Latin America, is currently leading a project to create and promote a solution that deploys blockchain technology to guarantee full traceability of the vaccines, regardless of their origin. This solution will help track each vaccine from the manufacturer to its application, certifying that it did not have any irregularities during its supply chain process.

A blockchain can register transactions immutably and securely, meaning the data of each vaccine cannot be altered or hacked. The team of EOS Costa Rica is currently developing a solution deploying the EOSIO blockchain protocol. This technology will guarantee reliable and near-real-time traceability of the vaccines. Moreover, EOSIO technology is highly scalable and enables improved efficiency when storing data, ideal for executing millions of transactions in a safe environment.

NFT Proof Of Concept

This script test the basic functionality required by creating Non-Fungible Tokens to represent vaccines from different manufacturers and to represent the containers used for transporting the vaccines.

Vaccines are packaged in a primary containers containing 100 doses. Two primary containers are then packaged together in secondary containers. This is represented by bundling NFTs using the attach action provided by the Simple Assets Contract.

NFTs can be update periodically with data such as temperature and location.

In order to transfer a token between accounts an owner must offer it for another another account to claim.

Please see SimpleAssets.hpp in Github for a detailed description of each of these actions and their parameters.

Before you start

Some things you need before getting started:

Basic knowledge about Simple Assets, EOSIO, and Shell Script is required.

First time run

  1. Clone this repo using git clone --depth=1 https://github.com/eoscostarica/vaccine-traceability-poc.git <YOUR_PROJECT_NAME>
  2. Move to the appropriate directory: cd <YOUR_PROJECT_NAME>.
  3. Set the environment variables: rename .env.example to .env and update accordingly
  4. Copy wallet seeds files to wallet_data folder.
  5. Enter command: make run
  6. Access the backend console: http://localhost:8080/console
  7. Manually import SQL files found in hasura/seeds
  8. Navigate to http://localhost:3000/inventory/active
  9. Create a new batch of vaccines

File Structure

Within the repo you'll find the following directories:

.
├── contracts ..................... Simple Assets Smart Contract
├── docs .......................... Docusaurus Documentation Generator
├── hasura ........................ Hasura GraphQL Engine
├── hapi .......................... HTTP API 
├── kubernetes .................... Kubernetes Manifests 
├── wallet ........................ EOSIO Wallet Service
└── webapp ........................ ReactJS Web Application

Documentation

Documentation built using Docusaurus 2, a modern static website generator. Installed in /docs folder.

Topics Covered :

  • Project Background
  • System Architecture
  • User Experience Design
  • Smart Contracts
  • Accounts and Identity

Documentation Installation

yarn install

Documentation Local Development

yarn start

This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.

License

© EOS Costa Rica

About EOS Costa Rica


EOS Costa Rica is an independently-owned, self-funded, bare-metal Genesis EOS block producer that develops solution using EOSIO and provides infrastructure for EOSIO blockchains. We support open source software for our community while offering enterprise solutions and custom blockchain development for our clients.

eoscostarica.io

supply-chain-poc's People

Contributors

adriexnet avatar code-factor avatar tetogomez avatar xavier506 avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

supply-chain-poc's Issues

Patient account creation

As an admin and vaccination personnel I want to be able to create patient accounts, so vaccination tokens can be transferred to their wallets.

Event Notifications

Notify related users on events related to them

for example : offer / claim
change of status

image

Draft Lots

Draft orders can be persisted to the database without sending ant transactions to the blockchain in order to help users create and double check new orders/

We did something similar in lifebank:
image

Configurable Supply chain

As an admin user I want to set the order of checkpoints that is allowed so that I know my supply chain is on track

Transport User Profile

Lets create a table with information about users that belong to a Storage Facility GIAI

Authentication

research lifebank authentication to re use the code base as a starting point for this project.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.