Helpful

Support that makes you better at support.

Helpful is an open product that's being build by a fantastic group of people on Assembly. Anybody can join in building this product and earn a stake of the profit.

Getting started

You need Ruby 2.0.0, Postgres, Redis and the Heroku Toolbelt installed locally to run Helpful.

# Install dependent gems
$ bundle install

# Setup the database
$ cp config/database.yml.example config/database.yml
# edit config/database.
$ bin/rake db:setup

# Install & Setup dependencies (for Mac)
$ brew install elasticsearch
$ cp -s /usr/local/Cellar/elasticsearch/X.XX.X /usr/local/Cellar/elasticsearch/latest
$ brew install redis
$ cp -s /usr/local/Cellar/redis/X.XX.X /usr/local/Cellar/elasticsearch/redis

# Configure the environment
$ cp .env.example .env
# edit .env

If you are running redis and elasticsearch already:

$ foreman start

If you are not running redis and elasticsearch seperately and would like to run them in the same session:

$ cp Procfile.dev.example Procfile.dev
# edit Procfile.dev

# Start the server
$ foreman start -f Procfile.dev
# open localhost:5000 in your browser

Send a test message to the app

$ rake seed:message from=some_email@test.com
# open localhost:5000 in your browser

Configuring Search (Elastic Search)

On OS X:

brew install elasticsearch
elasticsearch -f
rake search:reindex
foreman start

Configuring Analytics (Segment.io)

You can get some analytics from your app by configuring a Segment.io secret key in .env:

SEGMENT_SECRET=XXXXXXXXXXXX

Configuring Email

Sending with Gmail

In development.rb, add:

config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
    address:              'smtp.gmail.com',
    port:                 587,
    domain:               'example.com',
    user_name:            'your_gmail_username',
    password:             'your_gmail_password',
    authentication:       'plain',
    enable_starttls_auto: true
}

Recieving with Mailgun (optional)

Setting up Mailgun in development takes a little work but allows you to use the actual email workflow used in production.

Register for a free account at https://mailgun.com.
Get your Mailgun API key from https://mailgun.com/cp it starts with "key-" and add it to your .env file as MAILGUN_API_KEY.
Get your Mailgun test subdomain from the same page and add it to your .env file as INCOMING_EMAIL_DOMAIN.
In order to recieve webhooks from Mailgun we need to expose our development instance to the outside world. We can use a tool called Ngrok for this. Download and setup Ngrok by following the instructions on the Ngrok site.
Run rake mailgun to make sure everything is setup right. It should prompt you to create a route using rake mailgun:create_route.
Run rake mailgun:create_route and when prompted enter your Ngrok address as the domain name.
Send a test email to helpful@INCOMING_EMAIL_DOMAIN and you should see it appear in the helpful account.

Contributing

There are a couple of steps you need to take before contributing:

Go to https://assemblymade.com and sign up.
Link your GitHub account to your Assembly account
Create a new WIP at https://assemblymade.com/support-foo/wips. Think of WIPs as GitHub issues.

Then just go ahead, fork the repo & issue a pull request. You're on your way to having a stake in Helpful.

onlymejosh / helpful-web