nschmidtg/simpla

Simpla es un sistema de monitoreo y planificación para municipios de Chile

Simpla

• Author: Nicolás Schmidt nschmidtg@gmail.com
• Company: Centro de Políticas Públicas de la Pontificia Universidad Católica de Chile
• Website: simpla.cl
• License: GNU Affero GPL v3.0

Based on the source code of Ollert App:

• Author: Larry Price larry@larry-price.com
• Company: Software Engineering Professionals, Inc.
• Website: ollertapp.com
• License: GNU Affero GPL v3.0

Development

You almost certainly want to be using a Unix-based operating system. Some dependencies will be necessary before you can run the application. On Ubuntu:

# sudo apt-get install libxslt-dev libxml2-dev build-essential libqtwebkit-dev

Note: You may need more packages. If you do, please edit this document and add them to the command above.

Requirements

• ruby-2.2.0 - Install using RVM, be aware of this issue
• mongodb - Check out this very helpful page
• bundler - gem install bundler
• npm - sudo apt-get install nodejs npm

In the project root folder, you should:

• bundle install
  • Installs the required ruby gems
• npm install
  • Installs the required node packages

Create a file called .env in the root project folder. The format of the .env file is simply:

ENVIRONMENT_VARIABLE=This is the value
ANOTHER_VARIABLE=Another value

Environment variables:

• PUBLIC_KEY
  • required
  • Retrieve a public key from Trello by visiting https://trello.com/1/appKey/generate
• TRELLO_TEST_DISPLAY_NAME
  • required
  • Display name to use while running cukes (this is your @<username> from Trello)
• TRELLO_TEST_USERNAME
  • required
  • Username to use while running cukes
• TRELLO_TEST_PASSWORD
  • required
  • Password to use while running cukes
• MEMBER_TOKEN
  • required
  • this value is used to run the integration tests. To generate this value go to 'https://trello.com/1/authorize?key=[PUBLIC_KEY]&scope=read%2Cwrite&name=SimplaIntegrationTests&expiration=never&response_type=tokenafter'
• DOMAIN_FORGOT
  • required
  • The domain of the server for redirecting. For local environment use localhost:4000/.
• MAIL_FORGOT
  • required
  • Email from where the emails will be sent.
• PASS_FORGOT
  • required
  • Password of the email from where the emails will be sent.
• RACK_ENV
  • optional
  • You should set this to development. Other options include testing and production.

Run rake to start the application on localhost:4000. This will fork two processes: a rack server (probably unicorn) and grunt watch (to constantly compile and minify Sass and javascript files).