🔍 Note: I wrote this through a translator 🔎

This application allows managers to register surveys and check students' responses

Click here to view the network architecture

1. The blockchain operator sets up the Hyperledger Fabric network and the operator installs and instantiates the smart contract on the Fabric network.
2. The User interacts with the Vue.js Web interface to register surveys and responses, or with the Explorer to identify blocks in the Fabric network.
3. The Vue.js client uses the API gateway to interact with the overall servers.
4. The API gateway uses the Express.js applications API to interact with the fabric network and uses the Flask.py application API to recognize card information.
5. The Express.js application servers use the fabric-sdk-node to interact with the deployed fabric network and creates APIs for a web client.
6. The Fabric network notifies the event processing Express.js application when an event occurs during an interaction.
7. The Explorer identifies blocks by interacting with the fabric network through the postgresql DB.

• Hyperledger Fabric v1.4 is a platform for distributed ledger solutions, underpinned by a modular architecture that delivers high degrees of confidentiality, resiliency, flexibility, and scalability.
• Hyperledger Explorer is a user-friendly Web application tool used to view, invoke, deploy or query blocks, transactions and associated data, network information, chain codes and transaction families, as well as any other relevant information stored in the ledger.
• Node.js is an open source, cross-platform JavaScript run-time environment that executes server-side JavaScript code.
• Vue.js is an open-source JavaScript framework for building user interfaces and single-page applications.
• Flask.py is a lightweight WSGI web application framework. It is designed to make getting started quick and easy, with the ability to scale up to complex applications.
• Tesseract is an optical character recognition engine for various operating systems.

⚠️ Note: You will need Node >=10.15.3 to run this pattern! ⚠️

1. Clone the Repo
2. Prepare prerequisites By shell script
3. Start the Fabric network By shell script
4. Run the Dockerize web apps By shell script

Git clone this repo onto your computer:

ubuntu$ git clone https://github.com/woojae9488/fabric-survey-app
ubuntu$ cd fabric-survey-app/

The shell script in the fabric-survey-app folder provides simple preparation:

ubuntu$ chmod +x prepare.sh
ubuntu$ sudo ./prepare.sh light
ubuntu$ source ./environment

If your computer has less than 1.5GB of memory, you need to add an -S option or an -s <size> Option to create a swapfile.

After all the scripts are run, the version will be checked at the end. Check the versions of the other programs except python and pip.

The source command is to set the necessary environment variables for starting the fabric network.

For more details, see the contents of the prepare.sh file.

The shell script in the fabric-survey-app folder provides simple Fabric network startup:

ubuntu$ chmod +x operate.sh
ubuntu$ sudo ./operate.sh up

When you run a script, the following things happen in order:

1. Generate certificates through the "artifacts/crypto-config.yaml" file.
2. Generate channel artifacts through the "artifacts/configtx.yaml" file.
3. Deploy the required containers on the Fabric network through the docker-compose command and the "arifacts/docker-compose.yaml" file.
4. Run the "scripts/script.sh" file using the cli docker container.

When you run a script in the cli docker container, the following things happen in order:

1. Create a surveynet channel.
2. All peers join in the surveynet channel.
3. Update anchor peers for each organization.
4. Install chaincode on all peers.
5. Instantiate chaincode in each peer.
6. The query and Invoke are tested since all configurations are complete.

For more details, see the contents of the operate.sh file.

Now, finally, run only the deploy.sh shell script will end the whole process.

ubuntu$ cd web-app/
ubuntu$ chmod +x deploy.sh
ubuntu$ sudo ./deploy.sh start all

If everything is done well, we are ready to access our fabric network. Go to http://[HOST-IP]:8080/ to view the client app, or http://[HOST-IP]:8888/ to view the Explorer app. 😄
Now test the web you created. The id and password of the existing manager are admin, adminpw.

If you want to run applications separately from the Explorer or just the Explorer, you can run them through the following commands:

ubuntu$ sudo ./deploy.sh start msa       # Exclude the Explorer
ubuntu$ sudo ./deploy.sh start explorer  # Just the Explorer

For more information, see the contents of the deploy.sh file and the resources in the docker-config directory.

It is not possible to run the Explorer when running web applications in a local deployment because only dockerized Explorer is available in this code pattern.

These steps overlap with the preceding steps(Step 1. and Step 3.). Therefore, I will explain the other parts only.

1. Clone the Repo
2. Prepare all prerequisites By shell script
3. Start the Fabric network By shell script
4. Run the web servers and client

The shell script in the fabric-survey-app folder provides simple preparation:

ubuntu$ chmod +x prepare.sh
ubuntu$ sudo ./prepare.sh all
ubuntu$ source ./environment

If your computer has less than 1.5GB of memory, you need to add an -S option or an -s <size> Option to create a swapfile.

After all the scripts are run, the version will be checked at the end. Make sure that all version of the programs are checked.

The source command is to set the necessary environment variables for starting the fabric network.

For more details, see the contents of the prepare.sh file.

To deploy without a dockerize web servers or client, each servers and client must be run directly. At this step, you can modify and execute the code as you wish.

First, let's run a fabric-manager server, a fabric-student server, and a fabric-event server that connects to the fabric network.

ubuntu$ cd web-app/servers/fabric-manager/
ubuntu$ npm install
ubuntu$ npm start
ubuntu$ cd ../fabric-student/
ubuntu$ npm install
ubuntu$ npm start
ubuntu$ cd ../fabric-event/
ubuntu$ npm install
ubuntu$ npm start

Here, the fabric-student server does not matter, but the fabric-event server must run later than the fabric-manager server. (This is because the fabric-manager server registers the certificate of the fabric-event server.)

Then, run the card-recognize server and the API gateway.

ubuntu$ cd ../card-recognize/
ubuntu$ pip3 install -r ./requirements.txt
ubuntu$ python3 app.py
ubuntu$ cd ../api-gateway/
ubuntu$ npm install
ubuntu$ npm start

If you don't want to use Chonnam National University's student card recognition, you don't have to run the card-recognize server and you have to change the client's student signup process.

Finally, run the client.

ubuntu$ cd ../../client/
ubuntu$ npm install
ubuntu$ npm run serve

If everything is done well, we are ready to access our fabric network. Go to http://localhost:8080/ to see your app. 😄
Now test the web you created. The id and password of the existing manager are admin, adminpw.

After testing network, or if an error occurs and the network must be stopped, go to the fabric-survey-app folder and the following should be done:

ubuntu$ sudo ./operate.sh down

If you also want to shut down dockerize web apps:

ubuntu$ cd web-app/
ubuntu$ sudo ./deploy.sh stop all  # Or msa or explorer

This section will show pictures of the network structure or elements of the surveynet.

• hyperledger-fabricdocs (release-1.4)
• Hyperledger Fabric SDK for node.js
• Hyperledger Fabric contract SDK for node.js
• hyperledger/fabric-samples/first-network
• hyperledger/fabric-samples/balance-transfer
• hyperledger/fabric-samples/commercial-paper
• hyperledger/blockchain-explorer
• IBM/evote
• IBM/auction-events
• Vue.js
• Vue Router
• BootstrapVue

• Walkthrough of HLF Node SDK and Client App
• Exploring Fabric-CA: Registration and Enrollment
• PutState and GetState
• Private Data in Hyperledger Fabric
• Connection Profiles
• How to deploy chaincode in Hyperledger Fabric?

• MartinYounghoonKim/nodejs-authenticate-jwt-vuejs
• 자바스크립트 async와 await
• async/await으로 콜백지옥을 해결해보자
• RESTful API 설계 가이드
• 모두 알지만 모두 모르는 package.json
• Node.js 기반에서 환경변수 사용하기
• 특정 시간에 이벤트 발생시키기
• Nodejs lowdb 사용하기
• Node.js 가 로컬, 글로벌 모듈을 탐색하는 순서를 확인해보자
• MSA 제대로 이해하기 - MSA의 기본 개념
• API Gateway 구현
• ecojuntak/api-gateway

• Vue 컴포넌트 데이터 주고 받기
• Vue에서 중첩 데이터를 감시하는 법
• Vue.js 컴포넌트 재사용하기 - slot 편
• Vue Router의 LifeCycle 이해하기
• Vue.js 라우터 네비게이션 가드 알아보기
• Component 개념을 익히고 만들어보자!!
• Axios 러닝 가이드
• javascript로 이미지 업로드 및 미리보기 기능 구현하는 방법
• LocalStorage, SessionStorage 클라이언트에 정보 저장
• Vue.js와 Chart.js를 이용하여 아름다운 차트 만들기
• Vue cli 4 환경 변수 설정하기

• 파이썬 Flask를 이용하여 REST API 만들기
• Axios, POST request to Flask
• opencv / pytesseract를 활용한 image2text
• Python OpenCV 강좌 : 제 1강 - OpenCV 설치
• 딥러닝과 OpenCV를 활용해 사진 속 글자 검출하기
• OpenCV - 이미지에서 텍스트 영역만 찾아내기
• 바코드 / QR코드 인식하기
• Python에서 Open API 호출하기
• How to convert base64 string to image?

• 도커 이미지 빌드 원리와 OverlayFS
• 초보를 위한 도커 안내서 - 이미지 만들고 배포하기
• 리액트 프로젝트에 ESLint 와 Prettier 끼얹기
• 마크다운 사용법
• ParkSB/javascript-style-guide
• Apache License 2.0 사용법
• Fixing security vulnerabilities in npm dependencies