{"id":22282669,"url":"https://github.com/carbonfive/aquae","last_synced_at":"2025-03-25T19:45:01.873Z","repository":{"id":22210964,"uuid":"25543619","full_name":"carbonfive/aquae","owner":"carbonfive","description":"Where do you get your water from and what is the health of our water systems?","archived":false,"fork":false,"pushed_at":"2014-11-20T21:54:06.000Z","size":608,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":70,"default_branch":"master","last_synced_at":"2025-01-30T17:37:05.688Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://acquae.us","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/carbonfive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-21T20:11:58.000Z","updated_at":"2014-11-20T21:54:06.000Z","dependencies_parsed_at":"2022-08-20T22:10:52.168Z","dependency_job_id":null,"html_url":"https://github.com/carbonfive/aquae","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carbonfive%2Faquae","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carbonfive%2Faquae/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carbonfive%2Faquae/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carbonfive%2Faquae/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/carbonfive","download_url":"https://codeload.github.com/carbonfive/aquae/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245534543,"owners_count":20631285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-03T16:34:49.958Z","updated_at":"2025-03-25T19:45:01.851Z","avatar_url":"https://github.com/carbonfive.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aquae\n\nAquae helps you understand where your water come sfrom and the health of our water systems.\n\nReservoirs are at the lowest levels we've seen in more than a decade but it's hard to find out what it really means.\nMany people don't even know where their water comes from and it's not always easy to find out.\n\nWe want to help answer important questions about water in an easy to understand manner.\n\n# Development\n\n## Getting Started\n\n### Requirements\n\nTo run the specs or fire up the server, be sure you have these installed:\n\n* Ruby 2.1 (see [.ruby-version](.ruby-version)).\n* PostgreSQL 9.x (```brew install postgresql```) with superuser 'postgres' with no password (```createuser -s postgres```).\n* PhantomJS for Capybara and Javascript testing (```brew install phantomjs```).\n\n### First Time Setup\n\nAfter cloning, run these commands to install missing gems and prepare the database.\n\n    $ gem install bundler\n    $ bundle\n    $ rake db:setup db:sample_data\n\nNote, ```rake db:sample_data``` loads a small set of data for development. Check out [db/sample_data.rb](db/sample_data.rb)\nfor details.\n\n### Running the Specs\n\nTo run all Ruby and Javascript specs.\n\n    $ rake\n\n### Running the Application Locally\n\n    $ foreman start\n    $ open http://localhost:3000\n\n## Conventions\n\n### Git\n\n* Branch ```master``` is auto-deployed to production.\n* Create feature branches off of ```master``` using the naming convention ```(features|chores|bugs)/a-brief-description-######```, where ###### is the tracker id.\n* Rebase your branch before merging into ```master``` to produce clean merge bubbles.\n* Retain merge commits for multi-commit branches when merging into ```master``` (e.g. ```git merge --no-ff branchname```).\n* Craft atomic commits that make sense on their own and can be easily cherry-picked or reverted if necessary.\n\n### Code Style\n\nGenerally speaking, follow the [Ruby Style Guide](https://github.com/bbatsov/ruby-style-guide). Additionally, these are other guidelines adopted by the team:\n\n**Always use double quotes for test/spec descriptions, unless the subject is a class/module.**\n\n```ruby\ndescribe SomeController do\n  context \"when logged in as an admin\" do\n    describe \"#some_method\" do\n      it \"does some thing\"\n    end\n  end\nend\n````\n\n## Additional/Optional Development Details\n\n### Using Guard\n\nGuard is configured to run ruby and jasmine specs, and also listen for livereload connections.\n\n    $ bundle exec guard\n\n### Using Mailcatcher\n\n    $ gem install mailcatcher\n    $ mailcatcher\n    $ open http://localhost:1080/\n\nLearn more at [mailcatcher.me](http://mailcatcher.me/). And please don't add mailcatcher to the Gemfile.\n\n### Continuous Integration and Deployment with CircleCI\n\nThis project is configured for continuous integration and deployment with CircleCI and Heroku.\n\nCheck out [circle.yml](circle.yml) and [bin/deploy.sh](bin/deploy.sh) for details.\n\n# Server Environments\n\n### Hosting\n\nProduction is hosted on Heroku.\n\n### Environment Variables\n\nSeveral common features and operational parameters can be set using environment variables.\n\n**Required**\n\n* ```SECRET_KEY_BASE``` - Secret key base for verfying signed cookies. Should be 30+ random characters and secret!\n\n**Optional**\n\n* ```HOSTNAME``` - Canonical hostname for this application. Other incoming requests will be redirected to this hostname.\n* ```BASIC_AUTH_PASSWORD``` - Enable basic auth with this password.\n* ```BASIC_AUTH_USER``` - Set a basic auth username (not required, password enables basic auth).\n* ```PORT``` - Port to listen on (default: 3000).\n* ```UNICORN_WORKERS``` - Number of unicorn workers to spawn (default: development 1, otherwise 3).\n* ```UNICORN_BACKLOG``` - Depth of unicorn backlog (default: 16).\n\n### Third Party Services\n\n* Heroku for hosting.\n* CircleCI for continuous integration and deployment.\n* Mapbox for custom mapping.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarbonfive%2Faquae","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarbonfive%2Faquae","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarbonfive%2Faquae/lists"}