- 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 (
#communitychannel). - All Epics, Stories, Bugs, etc are tracked in JIRA: Volunteer Board.
- To Run Bahmni locally you should use Docker option of Bahmni or Vagrant option. Docker is recommended.
- This build requires Node, npm, yarn, grunt and compass (ruby).
- You can see the Github Action Build to see what commands get executed.
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:
- 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
NOTE:
Run these commands from within the micro-frontends sub-folder
yarn installyarn build- If build is successful, the
../ui/app/micro-frontends-distfolder 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.
yarn installyarn ci(will internally trigger grunt)- If build is successful, the
distfolder has the set of files to be deployed in Apache (or in Vagrant).
- If you are using Bahmni Docker, then you can hot deploy your app by following these steps: Bahmni Web Configurations Docker (Wiki)
- You can also sym-link the
/var/www/bahmniappsfolder 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 App 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
noindexwith thenofollowmetatag:<meta name=”robots” content=”noindex,nofollow”>The same is already done here
-
Using an X-ROBOTS-TAG HTTP HEADER:
An
X-Robots-Tagcan be added to the HTTP response header. It has basically the same effect as anoindextag, 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
openmrs-module-bahmniapps also integrates with SNOMED for terminology lookup and CDSS. More details can be found in this Wiki link