talent-find

OHR DOH Track

Abu Dhabi’s Health Workforce Management System, a new digital platform that allows clinical staff from across the UAE to volunteer their support or work full or part-time at the emirate’s healthcare sector, by registering online through the portal and highlighting their key skill sets to provide support to the sector’s facilities in the emirate during the COVID-19 outbreak.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

You need to install the software and how to install them

Download NodeJS https://nodejs.org/en/ LTS - 12.16.2

[sudo] npm install npm -g
npm i -g @vue/cli

Installing

A step by step series of examples that tell you how to get a development env running

Go to frontend/ folder

npm install 
npm run serve

How to setup fronend development

1. Download vs code
2. clone the repo
3. create a branch from doh-dev branch

    git checkout doh-dev
    git checkout -b your_dev_branch

4. use the following naming conventions to name your branch
   1. Create a gitlab issue and get issue number
   2. Name the branch like issue/<issue_number>
5. cd frontend
6. ensure that .env.development file points to the staging url VUE_APP_BASE_URL=https://ohr-staging.screel.in/api/v1
7. yarn install
8. yarn serve
9. Now your dev setup should be ready and you should be able to access the app at http://localhost:8080
10. The backend will be provided by https://ohr-staging.screel.in
11. Backend is already setup to allow CORS for port localhost:8080, if you run it on other ports you will face CORS issue
12. We use VueJs, here are some resources you may find useful to get started with vue
    1. https://www.vuemastery.com/courses/intro-to-vue-js/vue-instance
    2. https://vuex.vuejs.org/
13. We use the free admin template provided by core-ui, so use the CoreUi components for building the UI elements
    1. https://coreui.io/vue/docs/3.0/
    2. https://coreui.io/vue/demo/3.0-beta.1/#/dashboard
    3. https://github.com/coreui/coreui-free-vue-admin-template
14. The code is organized like shown below
    1. src/components - has resusable Vue Components
    2. containers - this folder has the components used in page
    3. pages - this folder contains the vue template that uses components from containers and builds the final page that are rendered under a url
    4. router - has routing logic, also supports access control
    5. modules - has files related to vuex state
    6. custom styles can be added in _custom.scss
15. Do your changes in your own branch, test it locally and then commit your changes.
16. Create a Merge request in gitlab
17. After review your changes will be deployed in staging https://ohr-staging.screel.in
18. After testing in staging, the changes will be migrated to production