Reference implementation for the Connected Diagnostics API (http://dxapi.org/)
To start developing:
-
Clone the repo.
-
Install dependencies:
bundle install
.- PhantomJS 1.9.8 for Poltergeist (development and test only)
- Install it in mac with:
brew install phantomjs
- Install it in mac with:
- ImageMagick for Paperclip
- Install it in mac with:
brew install imagemagick
- Install it in mac with:
- Redis is used by sidekiq. CDX uses sidekiq as ActiveJob backend
- Install it in mac with:
brew install redis
- you can start it with
redis-server --daemonize yes
- Install it in mac with:
-
Setup development database:
bundle exec rake db:setup
-
Setup test database:
bundle exec rake db:test:prepare
-
Run tests:
bundle exec rake
(this will runrspec
andcucumber
) -
Start development server:
bundle exec rails s
Additionally:
- Import manifests:
bundle exec rake manifests:load
To create an initial set of tests:
-
Navigate to the application
-
Create a new account and sign in
-
Create a new institution
-
Create a new site
-
Create a new device, choosing Genoscan model
-
Navigate to
/api/playground
-
Select your newly created device
-
Copy the contents of
/spec/fixtures/csvs/genoscan_sample.csv
into the Data field -
Run create message and navigate to Tests to verify the tests were successfully imported
To run notifiable diseases on development, checkout the project and symlink the custom settings files in /etc/nndd
on this project:
$ cd $NOTIFIABLE_DISEASES/conf
$ ln -s $CDP/etc/nndd/overrides.js overrides.js
$ ln -s $CDP/etc/nndd/overrides.css overrides.css
In order to allow synchronization of clients through rsyns - for csv files -, you should use cdx-sync-sshd, which is a dockerized sshd container, with an inbox and outbox directoy for each client. Download and build it before continuing.
You have to mount sshd volumes pointing to the folders where you will store your authorized keys, server keys and sync directory. Although sshd-server runs standalone and independently of the cdx server, the cdx server needs to be aware of such directories:
SYNC_HOME
: here is where files from clients wil be sync'ed. The file watcher will monitor inbox files hereSYNC_SSH
: here is whereauthorized_keys
file will be stored. The cdx app will write such file on this directory whenever a new ssh keys is added to a device.
By default, the cdx app assumes such directories will point to the tmp directory of the cdp app. Thus, you should start the cdx-sync-sshd docker container this way:
cd <where you have cloned cdx-sync-server>
export CDP_PATH=<where you have cloned this cdp repository>
make testrun SYNC_HOME=$CDP_PATH/tmp/sync \
SYNC_SSH=$CDP_PATH/tmp/.ssh
Now you must start the sync filewatcher. It is based on cdx-sync-server, but already bundled into cdx app. Run the following:
cd $CDX_PATH
rake csv:watch
Now, whenever a new csv file enters the sshd inbox, it will be imported into the cdx platform.
In the client side, you will need to run another filewatcher: cdx-sync-client. It is a Windos App. Install it using its NSI installer, restart your computer, and fill the form that will prompt after first restart. You will be required to provide an activation token - you can generate it form the device manager in the CDP app.
Using i18n gem. The Ruby I18n (shorthand for internationalization) gem which is shipped with Ruby on Rails (starting from Rails 2.2) provides an easy-to-use and extensible framework for translating your application to a single custom language other than English or for providing multi-language support in your application.
-
DO NOT hardcode any text
-
For any text
2.1. Create/Update one of the corresponding files (based on localization file structure below), depending on where the text appear
2.2. Then update the markup. For example:
-
Instead of using fixed text. Ex:
Filter was successfully created
-
We need to use i18n function to support multi-lingual. Ex:
I18n.t('filters_controller.filter_created')
2.3. When update any en.yml file, please update all other languages (vi.yml, fr.yml, ...) file correspondingly
-
For each language, there are separated files. Ex: *.en.yml and *.vi.yml. EN files are in cdx_core directory and VI files are in cdx_vietnam directory
-
Controller and helper: there is one file for all
-
Model and view: there is one file for each model or view
-
The locale file is organized based on file/module hierachy