Bahmni Apps

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.
See the sub-folder: ui/app/ to understand which all modules of the EMR UI are contained in this codebase.
Regarding the decision of migrating away from AngularJS and instead use React, please read this blog writeup: Bahmni EMR - 1 M lines of code
This code needs help in migrating to React. If you are interested in helping, please ping the Bahmni team on Slack (#community channel).
All Epics, Stories, Bugs, etc are tracked in JIRA.
To Run Bahmni locally you will need a Vagrant setup. See this documentation.

Build

This build requires Node, npm, yarn, grunt and compass.
You can see the travis-ci build to understand the build commands that get executed.
You can also see the go-cd build Bahmni_MRS_v0_93 pipeline to see in-depth build steps.

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

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:
- how to install Node using nvm.
- how to install NodeJS on mac.
Install Yarn: npm install -g yarn
Install Grunt: npm install -g grunt-cli
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: 2.6.6
- Once ruby is installed, you can install compass using: gem install compass

Run these commands from within the ui sub-folder.

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

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.

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

Docker images for Bahmniapps is built using Github Actions.

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

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

This behaviour can be prevented by:

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
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