Contents

1. Description
2. Demo video
3. The architecture
4. Long description
5. Project roadmap
6. Getting started
7. Live demo
8. Built with
9. Version
10. Authors
11. License

Description

What's the problem?

Due to the current global pandemic, every country is going through economic crisis and food and other amenities supply chain has been disrupted. This disruption has caused food shortage, hoarding, mismanagement of goods. Both of these issues have especially affected lower middle class and poor strata of the population, who are not able to access essential items either due to non availability or unaffordability of goods. To provide them with basic necessities different NGOs and government agencies are conducting ration drives. However, due to lack of communication between these organisations, these necessities aren’t being evenly distributed (some families not getting supplies while others getting it multiple times)

How can Al-Wasl.Connect platform help?

Platform where needy users can put up request, which is visible to all the NGOs and donors registered on this application. The request is validated through information available from government portal related to the financial status of the family and the current aid statistics pertaining to the family under consideration that have already been added in the portal if any family member has received aid in near past. Based on these statistics, request would be either accepted or it would be rejected. The solution also takes into account the geographical proximity while routing request and also, would use machine learning techniques for ranking the needy users if the resources available are currently less than the number of requests.The solution would also predict the future aid requests for a certain area based on historical records

Our Vision

NGOs raised the concerns regarding the legitimacy and transparency of the distribution of ration and other goods. We collaborated with NGOs in order to better understand the problem and hence, are proposing a blockchain and analytics based system that help mitigate this issue through distributed ledger of transactions. Hoarding of goods is another issue that countries all over the world are facing, this solution will also address this issue through decision system that restricts individuals from getting excessive amount of goods.

Demo video

Here

The architecture

Project roadmap

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

1. IBM Account
2. Install IBM CLI tool
3. GitHub Account & some knowledge
4. Node.js installed
5. Clone this repo on your local machine here

Installing

Kindly follow below steps to run the application successfully

Db2 service:

All csv are available here

1. Search db2 service(simple), select lite plan and create.

2. First step is to create service credentials

3. Open db2 service from resource list and from left menu service credentials, click new credentials and then add. (We will use these credentials in .env file)

4. Now lets open db2 console, click manage from left menu and select Open Console

5. Select three dots on top left, then click Load Data

6. Drop data .csv file available here, select target schema

7. Kindly use defualt schema that would similar to RGJ19757(three letters and 4 digits)

8. Click new table, if the .csv file is Transaction.csv give the table name Transaction.

   NOTE : When data is loaded. If there is DATE field, please change the Date format: DD/MM/YYYY and Timestamp format:DD/MM/YYYY H:MM TT

9. Once everything is completed click Begin Load

10. Follow steps 5-9 for other 4 csv files.

Backend service:

1. Backend service is implemented in node.js
2. Backend server is available here . Make sure to clone it.
3. Move into the directory and make the changes as below:
   1. In manifest.yml change name and host field to some unique value.
   2. Please add .env file with your db2 credentials
4. Then login IBM Cloud Platform from CLI
5. Once above steps are completed,must be in backend directory and pass cf push 'name of app' command to create the IBM Cloud Foundry service.
6. Copy the URL example https://trustdon....eu-gb.mybluemix.net/ that will be used in Frontend servie step 4.

Frontend service :

1. Frontend service is implemented in angular 9
2. Applicaiton frontend is available here
3. Update .env file with db2 service credentials
4. Update route in two files:

Open src folder -> environments (update .ts & .prod files where the backend server is URL running  eg https://trustdon....eu-gb.mybluemix.net/) 

1. Run “npm install”
2. Run “yarn install”
3. Then build the project “ng build”
4. Now you can see the “Dist” folder , add manifest.yml (keep name unique, available here)
5. Push only Dist folder files to your GitHub repositry
6. Need to integrate IBM Toolchain service here for Continuous Integration and deployment
7. Open IBM Account search for Toolchain and select develop a Cloud Foundry app.

NOTE : Clone the application and push it under your GitHub account and provide the URL. Because pipeline will not trigger if some changes are made in the repository.

12. In Delivery Pipeline section , select new -> ok (it will generate a new API)
13. Make sure under Source repository URL field pass GitHub Dis path.
14. Once above steps are completed click Create.
15. This toolchain will automatically create a Cloud Foundry app for you go to resources list and check application would be up and running.

Live demo

You can find a running application at here

Credentials

1. Donor Login

   • Registration # : 1234567890112
   • password : 1234

2. Government Login

   • Username : govt
   • password : admin

Built with

• IBM Cloud Foundry
• IBM Toolchain
• IBM db2 simple
• Node.js
• Angular

Version

v1.0

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the Apache 2 License - see the LICENSE file for details