Skip to content

District Housing lets caseworkers help clients apply for Section 8 housing by automatically filling out multiple PDF applications using one online form.

License

Notifications You must be signed in to change notification settings

charleshuang80/districthousing

 
 

Repository files navigation

Build Status

District Housing

District Housing lets caseworkers help clients apply for Section 8 housing by automatically filling out multiple PDF applications using one online form.

This is a Ruby on Rails application: knowledge of Ruby & Rails is recommended to work on the server component, and Codecademy's class is a great way to start.

This application uses the pdf-forms gem and pdftk.

Setup

The application can generate random seed data for testing. To get the application up and running, run these commands:

bundle install
rake db:setup
rails server

This will allow you to create an account, and start filling in applicants.

For testing with sample user data, you can run the following command, which will create a test user account with 30 fake applicants:

rake seed_applicants

The login for the test user is:

Username: [email protected]
Password: password

Code for DC has labeled additional PDFs to work with District Housing. These are not stored directly in the Git repository, but you can obtain them with the following command:

rake pull_pdfs

As a demo, the app can be found at http://districthousing.org/. Don't enter real data here, or rely on your data sticking around. It's likely to be reset and upgraded without warning.

Dependencies

PDFtk

Requires pdftk. On OS X, install homebrew and then run:

brew cask install pdftk

On Debian/Ubuntu:

sudo apt-get install pdftk

Wget

On OS X, use homebrew:

brew install wget

On Debian/Ubuntu:

sudo apt-get install wget

Installation with Cloud9

If you do not want to go through the trouble of installing Rails on your machine, you can easily set up the development environment with Cloud9. After forking the districthousing repo, sign up for a free Cloud9 account using your Github credentials.

Your fork of districthousing should appear on the left side of your Cloud9 dashboard under 'Projects on Github.' Select it and click 'Clone to Edit.' Choose the pre-configured Ruby on Rails environment. The districthousing fork will now be listed under 'My Projects.' Once cloned, click 'Start Editing.'

To continue using git, run the following in your workspace terminal:

git remote add districthousing '[email protected]:[github username]/districthousing'

Install pdftk using apt-get and ensure that you are using ruby-2.1.2. You should now be able to get the application up by running:

bundle install
rake db:setup pull_pdfs seed_applicants
rails s -b $IP -p $PORT

Navigate to http://districthousing-c9-[username].c9.io to see your app.

About

District Housing lets caseworkers help clients apply for Section 8 housing by automatically filling out multiple PDF applications using one online form.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 83.7%
  • Ruby 8.6%
  • HTML 3.9%
  • CSS 2.2%
  • JavaScript 1.1%
  • CoffeeScript 0.3%
  • Other 0.2%