Skip to content

Bahmni EMR Frontend code for Clinicians and staff members, written in Angular.JS and React

License

Notifications You must be signed in to change notification settings

Bahmni/openmrs-module-bahmniapps

Repository files navigation

Bahmni Apps

Build Status

Build and Publish

  1. This repository contains most of the frontend code for the Bahmni EMR. It is written in AngularJS with only the Form viewer part utilising React.
  2. See the sub-folder: ui/app/ to understand which all modules of the EMR UI are contained in this codebase.
  3. Regarding the decision of migrating away from AngularJS and instead use React, please read this blog writeup: Bahmni EMR - 1 M lines of code
  4. This code needs help in migrating to React. If you are interested in helping, please ping the Bahmni team on Slack (#community channel).
  5. All Epics, Stories, Bugs, etc are tracked in JIRA: Volunteer Board.
  6. To Run Bahmni locally you should use Docker option of Bahmni or Vagrant option. Docker is recommended.

Build

Notes

  1. This build requires Node, npm, yarn, grunt and compass (ruby).
  2. You can see the Github Action Build to see what commands get executed.

One time installation:

These steps need to performed ONLY the FIRST TIME you set up this code.

  1. Install node/npm (node version: 10.11.0). Preferably use nvm, so that you have control over which project uses which version of node. See:
  2. Install Yarn: npm install -g yarn
  3. Install Grunt: npm install -g grunt-cli
  4. Install Compass:
    • Compass compiles SASS/SCSS into CSS.
    • Requires ruby (It's recommended to install ruby also using rvm. See install rvm with ruby).
    • Ruby version: 3.1
    • Once ruby is installed, you can install compass using: gem install compass

Build commands

NOTE: Run these commands from within the micro-frontends sub-folder

  1. yarn install
  2. yarn build
  3. If build is successful, the ../ui/app/micro-frontends-dist folder has the set of files which can be used by the angular modules for their build

Run these commands from within the ui sub-folder.

  1. yarn install
  2. yarn ci (will internally trigger grunt)
  3. If build is successful, the dist folder has the set of files to be deployed in Apache (or in Vagrant).

Docker (Hot Deploy)

  1. If you are using Bahmni Docker, then you can hot deploy your app by following these steps: Bahmni Web Configurations Docker (Wiki)

Vagrant (Hot Deploy)

  1. You can also sym-link the /var/www/bahmniapps folder in Vagrant to {CODE_DIR}/ui/app/ folder so that JS changes are reflected immediately.

Debugging AngularJS App

  1. To be able to debug Bahmni frontend please read this post: Debugging AngularJS
  2. If you are brand new to AngularJS, this is a good intro video: Youtube: 60 min overview of AngularJS Fundamentals

Bahmniapps (bahmni-web) docker image

Docker images for Bahmniapps is built using Github Actions.

Resources to build the following docker images can be found in the package directory.

Prevent Search Engines from Indexing the homepage

⚠️ : Search Engines are able to index the Bahmni App homepage.

This behaviour can be prevented by:

  1. Adding a “noindex” metatag:

    The following tag should be inserted in the <head> section of the homepage's HTML markup:

    <meta name=”robots” content=”noindex”>
    

    Additionally, in order to both de-index the homepage and not follow the links, use the noindex with the nofollow metatag:

    <meta name=”robots” content=”noindex,nofollow”>
    

    The same is already done here

  2. Using an X-ROBOTS-TAG HTTP HEADER:

    An X-Robots-Tag can be added to the HTTP response header. It has basically the same effect as a noindex tag, but with the additional options to specify conditions for different search engines. For more information, please see Google’s guide here. Here are examples of X-Robots-Tag for specific functions:

    • To de-index a web page:
    Header set X-Robots-Tag "noindex, nofollow"
    

    The same is already done here

SNOMED Integration Support

openmrs-module-bahmniapps also integrates with SNOMED for terminology lookup and CDSS. More details can be found in this Wiki link