Ratings Application

Lego Blocks

• Workflow Manager (Enketo)
• Fusionauth

Tech Stack

• React.js
• Tailwind
• GraphQL
• Hasura

Installation Guide

Requirements 📜

1. Your machine should have Yarn (preferable) or Npm or Docker installed.

Installation Steps 🚶

1. Fork it 🍴

You can get your own fork/copy of UP-HRH by using the Fork button.

2. Clone it 👥

You need to clone (download) it to a local machine using

git clone https://github.com/Your_Username/UP-HRH.git

This makes a local copy of the repository in your machine.

Once you have cloned the UP-HRH repository in GitHub, move to that folder first using the change directory command.

# This will change directory to a folder UP-HRH
cd UP-HRH

Move to this folder for all other commands.

3. Set it up ⬆️

Run the following commands to see that your local copy has a reference to your forked remote repository in GitHub

git remote -v
origin  https://github.com/Your_Username/UP-HRH.git (fetch)
origin  https://github.com/Your_Username/UP-HRH.git (push)

Now, add a reference to the original UP-HRHUI repository using

git remote add upstream https://github.com/Samagra-Development/UP-HRH.git

This adds a new remote named upstream.

See the changes using

git remote -v
origin    https://github.com/Your_Username/UP-HRH.git (fetch)
origin    https://github.com/Your_Username/UP-HRH.git (push)
upstream  https://github.com/Samagra-Development/UP-HRH.git (fetch)
upstream  https://github.com/Samagra-Development/UP-HRH.git (push)

4. Run it 🏁

Using Yarn (preferable)

# To install all the dependencies
yarn install

# To start the application
yarn start

OR

using NPM

# To install all the dependencies
npm install

# To start the application
npm start

The React application will start on port 3000. Go to: http://localhost:3000

Environment

REACT_APP_USER_SERVICE_URL=
REACT_APP_APPLICATION_ID=
REACT_APP_HASURA_URL=
REACT_APP_ENKETO_URL=
REACT_APP_ENKETO_URL=
HASURA_REST_API_URL=
HASURA_ADMIN_SECRET=

Data uploading

Scripts reside inside the scripts folder. To run scripts, create copies of data inside the scripts/input/samples folder inside scripts/inputs and insert data as per the format mentioned in the samples.

Note: Ensure .env is updated.

To upload institutes:

Command: python3 institute_upload.py

Input file: scripts/input/institutes/InstituteData.csv Sample input file: scripts/input/samples/institutes/InstituteData.csv

To upload assessors:

Command: python3 assessors_upload.py

Input file: scripts/input/assessors/CodePhonenumberMapping.csv, scripts/input/assessors/PhonenumberUserIdMapping.csv Sample input file: scripts/input/samples/assessors/CodePhonenumberMapping.csv, scripts/input/samples/assessors/PhonenumberUserIdMapping.csv

Note: New users will be needed to be created on fusionauth using https://github.com/choxx/hasura-fa-user-creation-script

To upload schedules:

Command: python3 schedule_upload.py

Input file: scripts/input/scheduling/AssessmentSchedule.csv Sample input file: scripts/input/samples/scheduling/AssessmentSchedule.csv