https://github.com/mobomo/houston

NO LONGER MAINTAINED - Mission control dashboard for your distributed team
https://github.com/mobomo/houston

Last synced: about 2 months ago
JSON representation

NO LONGER MAINTAINED - Mission control dashboard for your distributed team

• Host: GitHub
• URL: https://github.com/mobomo/houston
• Owner: mobomo
• Created: 2010-11-18T00:32:11.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2015-04-22T19:41:01.000Z (almost 10 years ago)
• Last Synced: 2024-03-25T22:59:28.779Z (10 months ago)
• Language: Ruby
• Homepage:
• Size: 7.04 MB
• Stars: 296
• Watchers: 30
• Forks: 25
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# This Project is no longer Maintained

As of April 22nd, 2015, Intridea no longer maintains this project.

# Welcome to Houston

Houston is a central hub for all things _your company,_ from upcoming projects to who's here:

- Plan projects on a beautiful interactive timeline

- See who's out this week and next

- Submit and approve leave requests

- Browse the company handbook

- Meant for project managers, CEO's, developers, designers—anyone part of your team's success!

## Setup

1. Copy `config/database.yml.template` to `config/database.yml` and edit it to match your PostgreSQL configuration

2. Run these commands in a terminal:

```

bundle install

bundle exec rake db:setup

```

3. Run `./script/rails s`

## Under the hood

Houston is built with:

- Rails 3.2

- Ruby 2.0

- Postgres

- Heroku

- D3, Sass, Coffeescript, and a whole lot more

## Getting started with Projects

Projects are added and managed via a Google spreadsheet that you create. The spreadsheet format allows you to easily forecast weekly hours from your team over several months.

To get started with a template, visit https://docs.google.com/a/intridea.com/spreadsheet/ccc?key=0AhF447tnvlZRdEd4elVJbWptS0hfS1RpSjQyZmVMMXc&usp=drive_web and **copy** the sheet to your own organization. Next:

1. While logged in as a SuperAdmin, visit **Schedules** from the navigation menu.

2. From the dropdown menu at the top of the page, select "Reload RAW data manually." This will _import_ all the projects and people from your spreadsheet.

3. That's it!

### Make it recurring:

You can configure your app to regularly import your spreadsheet by adding a cron job. Just ask the cron job to run the following rake task:

```

rake daily_pull_raw_data

```

## Getting started with Users

Users can be "bulk added" by simplying adding them to your Google spreadsheet. Upon import, those users will automagically get created. However, if you want to enable them to log into Houston, you'll have to visit **Users** from the menu and fill in their Google email addresses (be sure to use the email they use to log in, and *not* an email alias).

## Integration with HipChat Hubot for submitting FAQ's

* Configure the API key on your Houston instance by visiting **Settings**

* Add the key for Houston to your Hubot instance

  `heroku config:set HUBOT_DASHBOARD_API_KEY=SECRET_KEY`

* Add the houston hubot script to your Hubot instance

* Also set the dashboard url for your Hubot instance

  `heroku config:set HUBOT_DASHBOARD_URL=dashboard_url`

* Configure your Confluence account by visiting **Settings**

* HipChat Hubot commands are:

  * @hubot #tellme How do I submit a PTO request?

  * @hubot #tellyou # Use the leave request form.

  * @hubot #showme