Code repository for Alaska Fee Agent Assister, an application for assisting fee agents in Alaska with the benefits interview process by Code for America.
Install Homebrew.
Install Heroku CLI.
brew install heroku/brew/heroku
Install and start PostgreSQL.
brew install postgresql
brew services start postgresql
This application is built using Ruby on Rails.
Your system will require Ruby to develop on the application.
The required Ruby version is listed in the .ruby-version file.
If you do not have this binary, use this guide to get set up on MacOS.
- Clone this repo
- Ask the team for the RAILS_MASTER_KEY
- Add it to a new file
config/master.key
- Run
bin/setup
- Run the server(s):
rails s
- Visit your local server
- Run tests, Rubocop, bundle audit, and Brakeman:
rake
- Secrets - We store all secrets in credentials.yml.enc. Locally you will need a
config/master.key
file with the master key in it (stored in LastPass). To edit runEDITOR=vi bin/rails credentials:edit
- Environment config - We store non-sensitive environment configuration in environment variables. In development, environment variables are loaded from
.env
. When adding an environment, be sure to update the.env
file andapp.json
(used by Heroku for review apps).
This application is a long questionnaire. You will probably want to work on parts of it without completing the whole application.
After booting the server and filling out the first few questions,
go to http://localhost:3000/screens
to jump around.
For development purposes, we generally just run rspec
.
- Use
match_html
to test that two HTML strings match, excluding whitespace, order of attributes, etc.:
expect(rendered).to match_html <<-HTML
<table class="foo bar">
<tr>
<td>Hi!</td>
</tr>
</table>
HTML
This application was designed using an Atomic design system.
The styleguide can be viewed at GetCalFresh Styleguide.
- Staging: Deployed automatically on successful builds from
master
.
CircleCI is currently set up to deploy green builds to staging.
A fillable PDF for Alaska's benefit programs - GEN 50C - Fillable.pdf