HospitalRun frontend

Ember frontend for HospitalRun

To run the development environment for this frontend you will need to have Git, Node.js, Ember CLI, Bower and CouchDB installed.

Install

To install the frontend please do the following:

• Make sure you have installed Git
• Make sure you have installed Node.js. Versions after 0.10.0 should work, but please note if you encounter errors using 5.x it may be necessary to upgrade your npm version. Versions after 3.5.x should work:
  1. npm install -g npm
• Install ember-cli v1.13.13: npm install -g ember-cli@1.13.13
• Install bower: npm install -g bower
• Clone this repo with git clone https://github.com/HospitalRun/hospitalrun-frontend, go to the cloned folder and:
  1. npm install to install needed node modules.
  2. bower install to install needed bower modules.
  3. npm install -g phantomjs2 to install PhantomJS2, which is needed to run tests.
• Install ands configure CouchDB
  1. Download and install CouchDB from http://couchdb.apache.org/#download
  2. Create admin user:
  3. If you have just installed CouchDB and have no admin user, please run initcouch.sh. A user hradmin will be created with password: test.
  4. If you already have a CouchDB admin user, please run initcouch.sh USER PASS where USER and PASS are the CouchDB admin user credentials.
• Copy the server/config-example.js to server/config.js.

Start

To start the frontend please do the following:

• Start the server by running ember serve in the repo folder.
• Go to http://localhost:4200/ in a browser and login with username hradmin and password test.

Loading sample data

If you would like to load sample data, you can do so by navigating to Load DB under the Adminstration menu. You should see the following screen:

Click on Choose File and select the file sample-data.txt which is included in root directory of the repo at sample-data.txt.
Next, click on Load File. When the database load is complete a message will appear indicating if the load was successful.

Testing

Fixtures for Acceptance Tests

Fixtures are PouchDB dumps that are generated with pouchdb-dump-cli.

To create a fixture, run pouchdb-dump http://localhost:5984/main -u hradmin -p test | cat > tests/fixtures/${name_of_fixture}.txt.

To use a fixture, use runWithPouchDump(${name_of_fixture}, function(){..}); in your acceptance test. For example,

test('visiting /patients', function(assert) {
  runWithPouchDump('default', function() {
    //Actual test code here
    authenticateUser();
    visit('/patients');
    andThen(function() {
      assert.equal(currentURL(), '/patients');
    });
  });
});

Contributing

Contributions are welcome via pull requests and issues. Please see our contributing guide for more details.