A rule engine on top of dhis2 developed by Bluesquare, to let power users describe their Results-Based Financing scheme.
More info about the tool https://bluesquarehub.com/services/openrbf-2-0/
Created with the support of the World Bank.
Thanks to the DHIS2 team for their help and support
A wizard approach guiding you in the setup of projects
With your rules editor and visual explanation
each formula will be mapped to a dhis2 data element.
You can easily verify your formula with the invoicing simulation form with a built-in invoice explainer showing you how was this amount/score calculated
Every change is tracked and you publish your project draft to be used at a given period.
The database configuration is handled in database.yml.
Rails limits the number of database connections with he pool setting. This is the maximum size of the connections your app can have to the database.
A puma worker on 1 dyno will need RAILS_MAX_THREADS connections.
Sidekiq on 1 dyno will need SIDEKIQ_CONCURRENCY connections.
Rails maintains its own database connection pool, with a new pool created for each worker process/dyno. Threads within a worker/dyno will operate on the same pool.
The current pool is set to ENV["DB_POOL"] || ENV['SIDEKIQ_CONCURRENCY'] || ENV['MAX_THREADS'] || 5.
In production, we currently have:
SIDEKIQ_CONCURRENCY => 20
MAX_THREADS => 5
WEB_CONCURRENCY => 1
DB_POOL => 1
This means that we need a DB_POOL of:
[SIDEKIQ_CONCURRENCY, MAX_THREADS*WEB_CONCURRENCY].max
=> [20, 5*1].max
=> 20
The current pool size is 20.
(Run bundle exec rake config:check_db_pool to get a live version of this output)
Run script/setup, this should install all dependencies and create the local databases.
Run script/test to check if everything was successfull.
A default user and program will be create by the db/seeds.rb file.
We have an example project that can be created using the public DHIS2 demo instance (https://play.dhis2.org/demo/) to showcase a RBF project configuration:
http://127.0.0.1:3000/setup/seeds
This will generate a "typical" RBF project with quality, quantity & payment rules for you to explore and play with.
You can access any element in the application using the admin interface at
If you set an ENV variable for LOG_ROCKET_TOKEN, a logrocket session will be started. (Currently only enabled in production)
Run the tests after any change:
bin/rspec
We recommand Heroku to host the application, but any hosting should work as long as it support Rails & Postgresql. On heroku, deploy should be as simple as:
git push heroku master
heroku run rake db:create db:migrate db:seed
Or you can use this button to get up and running immediately:
A dhis2 app called hesabu-manager is available but not yet on par with the web application.
heroku run rake ui:setup_all -a yourappname
heroku run rake ui:deploy_all -a yourappname
get a fresh copy using Heroku
heroku pg:pull DATABASE_URL orbf2 --app yourappname
to speed up things you can a copy without the dhis2_logs table
bundle exec rake db:fetch APP_NAME=yourappname
- https://github.com/BLSQ/orbf-rules_engine/ (equations building blocks extracted from this repo)
- https://github.com/BLSQ/hesabu (ruby facade of go-hesabu for equation solving)
- https://github.com/BLSQ/go-hesabu (golang implementation to speed up invoice calculations)
- https://github.com/BLSQ/hesabu-manager dhis2 app to replace the rails frontend here
- https://github.com/BLSQ/blsq-report-components react components to allow building invoice apps (dhis2 dedicated apps with invoice templates, custom data entries, contracts modules,... )