/maslow

A tool to create and manage needs from the Need API

Primary LanguageRuby

Maslow

Maslow is a tool to create and manage needs. It's a frontend for the Need API. It's a Rails app which is part of the GOV.UK Publishing Platform.

Dependencies

  • Ruby (1.9.3)
  • Bundler
  • A running instance of the Need API

If you'd like to show a list of content for a need, you can also run the Content API (and its dependencies). However, Maslow will still work when the Content API isn't present.

Getting started

The bootstrap script should get you up and running in the development environment. It runs Bundler and creates a stub user in the database.

./script/bootstrap
bundle exec unicorn -p 3001

GDS development

If you're using the development VM, you should run the app from the development repository using Bowler and Foreman. The Need API will automatically be started alongside Maslow.

cd development/
bowl maslow

From your host machine, you should be able to access the app at http://maslow.dev.gov.uk/.

User accounts

Authentication is provided by the GDS-SSO gem, and in the production environment an instance of Signon must be running in order to sign in.

In the development environment, the mock strategy is used by default. This removes the requirement for authentication, instead returning the first user in the database as the current user. For this to work, a user must exist - there's a user defined in db/seeds.rb which will be created with the bootstrap script.