This blockchain model for a customer loyalty program enhances the value of points to loyalty program members and brings in new value to the partners. Participants in this network have a more level relation among each other and points are in the centric position to connect all participants.
This code pattern is for developers looking to start building blockchain applications with Hyperledger Composer. When the reader has completed this code pattern, they will understand how to:
- Create basic business network using Hyperledger Composer
- Deploy the network to an instance of Hyperledger Fabric locally and IBM Blockchain
- Build a Node.js web application to interact with the blockchain network using Composer API
- Member is registered on the network
- Member can sign-in to make transactions to earn points, redeem points and view their transactions
- Partner is registered on the network
- Partner can sign-in to view their transactions and display dashboard
-
Hyperledger Composer v0.19.4 Hyperledger Composer is an extensive, open development toolset and framework to make developing blockchain applications easier
-
Hyperledger Fabric v1.1 Hyperledger Fabric is a platform for distributed ledger solutions, underpinned by a modular architecture delivering high degrees of confidentiality, resiliency, flexibility and scalability.
-
IBM Blockchain Starter Plan The IBM Blockchain Platform Starter Plan allows to build and try out blockchain network in an environment designed for development and testing
- Nodejs Node.js is an open-source, cross-platform JavaScript run-time environment that executes JavaScript code server-side
- Bootstrap Bootstrap is an open source toolkit for developing with HTML, CSS, and JS
Original: https://github.com/raheelzubairy/customer-loyalty-program
Follow these steps to setup and run this code pattern. The steps are described in detail below.
-
Operating Systems: Ubuntu Linux 14.04 / 16.04 LTS (both 64-bit), or Mac OS 10.12 or higher
-
Docker (Version 17.03 or higher)
-
npm (v5.x)
-
Node (version 8.9 or higher - note version 9 is not supported)
- to install specific Node version you can use nvm
- nvm install 8.9
- nvm use 8.9
- output: Now using node v8.9.4 (npm 6.1.0)
- Example: 'nvm install 8.94' results in: "Now using Node v8.9.4, NPM v5.6.0"
1. Install the Hyperledger Composer runtime components and clone the Customer Loyalty Program GitHub Repo
- Install composer cli:
npm install -g composer-cli
- Install composer-rest-server:
npm install -g composer-rest-server
- Install generator-hyperledger-composer:
npm install -g generator-hyperledger-composer
Clone the Customer Loyalty Program with Blockchain
repo locally. In a terminal, run:
git clone https://github.com/LennartFr/customer-loyalty-program
Next we will generate the Business Network Archive (BNA) file from the root directory.
This file will contain your network including:
- the model defined in the
org.clp.biznet.cto
file in themodels
folder - the logic behind transactions in the
logic.js
file in thelib
folder - permissions defined in the
permissions.acl
file - queries defined in the
queries.qry
file
Run the following command to create the BNA file:
cd customer-loyalty-program/
npm install
The composer archive create
command in package.json
has created a file called clp-network@0.0.1.bna
.
The BNA file can either be deployed to a local instance of Fabric or to the IBM Blockchain Starter Plan.
- To deploy to Hyperledger Fabric locally, please click here
- Or to deploy to IBM Blockchain Starter Plan, please click here
At this point you will either have installed the Hyperledger Fabric locally or to the IBM Blockchain Starter Plan! See above for the instructions.
Go into the web-app
folder and install the dependency:
cd web-app/
npm install
Start the application:
npm start
The application should now be running at:
http://localhost:8000
If your hosting the network on IBM Blockchain Starter Plan, then you can deploy the app to IBM Cloud.