Webapp to manage the workflow Parliamentary Questions
- Ruby MRI 2.1.2
- Postgresql 9.3
- phantomjs (tests only)
- coreutils (required by the
version_tag.shscript) - graphviz (required by the
bin/generate-erdscript)
To start with, make sure you have the right version of the Ruby runtime installed. Multiple versions of Ruby can be managed on the same machine through either rbenv or rvm.
The Postgresql version used in production is 9.3. This can be installed via homebrew:
brew install homebrew/versions/postgresql93
Start by setting the required environment variables. Then Install the app dependencies by running the following
gem install bundler && bundle install
If you get problems installing the pg gem not being able to find libpg, try setting the architecture flag as follows:
gem install bundler && ARCHFLAGS="-arch x86_64" bundle install
You can now procede setting up the database table layout
bundle exec rake db:setup
And starting the app with:
bundle exec rails s
Mock data can be automatically imported by running the following rake task:
bundle exec rake pqa:import_dummy_data
Finally, a rake task is also provided to load PQ&A XML data into the system.
bundle exec rake pqa:import_from_xml[path/to/question_file.xml]
It's done using devise and devise invitable:
For development you can create users with a rake task.
# default user
rake user:create
# specific email, password, name
rake "user:create[[email protected], 123456789, admin]"
An entity-relationship diagram of PQ's data model can be generated by running
the bin/generate-erd script. Please do re-run this script to update the graph as
the application schema evolves.
Unit tests can be run via bundle exec rspec, while end-to-end tests can
be run be executing the same command with the features folder as argument (i.e.
bundle exec rspec features). Please refer to the readme in the features folder
for end-to-end tests implementation details.