CASA (Court Appointed Special Advocate) is a role fulfilled by a trained volunteer sworn into a county-level juvenile dependency court system to advocate on behalf of a youth in the corresponding county's foster care system. CASA is also the namesake role of the national organization, CASA, which exists to cultivate and supervise volunteers carrying out this work – with county level chapters (operating relatively independently of each other) across the country.
We are very happy to have you. If you have problems or questions, the fastest way to an answer is in slack https://rubyforgood.herokuapp.com/ #casa channel
ALL open issues on the issue board https://github.com/rubyforgood/casa/projects/1 are fair game unless they are already assigned to a contributor. Assign an issue to yourself or comment on it "I am working on this issue".
PRs which are not for an issue but which improve the codebase by adding a test or improving the code are also welcome!
A maintainer will be keeping an eye on issues and merging PRs at least once a day. Some PRs may be rejected if they make non-useful readme changes or similar changes. We want to merge your PRs! :)
See also our contributing guide 💖
PG CASA (Prince George's County CASA in Maryland) seeks a volunteer management system to:
- provide volunteers with a portal for logging activity
- oversee volunteer activity
- generate reports on volunteer activity
How CASA works:
- Foster Youth (or case worker associated with Foster Youth) requests a CASA Volunteer.
- CASA chapter pairs Youth with Volunteer.
- Volunteer spends significant time getting to know and supporting the youth, including at court appearances.
- Case Supervisor oversees CASA Volunteer paired with Foster Youth and monitors, tracks, and advises on all related activities.
- At PG CASA, the minimum volunteer commitment is one year (this varies by CASA chapter, in San Francisco the minimum commitment is ~ two years). Many CASA volunteers remain in a Youth's life well beyond their youth. The lifecycle of a volunteer is very long, so there's a lot of activity for chapters to track!
Why?
Many adults circulate in and out of a Foster Youth's life, but very few of them (if any) remain. CASA volunteers are by design, unpaid, unbiased, and consistent adult figures for Foster Youth who are not bound to support them by fiscal or legal requirements.
Project Terminology
- Foster Youth = CasaCase
- CASA Volunteer = Volunteer
- Case Supervisor = Case Supervisor
- CASA Administrator = Superadmin
Project Considerations
- PG CASA is operating under a very tight budget. Right now, they manually input volunteer data into a volunteer management software built specifically for CASA, but upgrading their account for multiple user licenses to allow volunteers to self-log activity data is beyond their budget. Hence why we are building as lightweight a solution as possible that can sustain itself with Ruby for Good's support.
- While the scope of this platform's use is currently only for PG County CASA, we are building with a mind toward multitenancy so this platform could prospectively be used by CASA chapters across the country. We consider PG CASA an early beta tester of this platform.
More information:
Learn more about PG CASA here.
You can read the complete role description of a CASA volunteer in Prince George's County as well.
See DOCKER.md for instructions on setting up your environment using Docker. For non-Docker installations, follow the instructions below.
You need Ruby, bundler, node.js, yarn, postgres, and chromedriver.
Ruby
- Install a ruby version manager: rvm or rbenv
- when you cd into the project directory, let your version manager install the ruby version in
.ruby-version. Right now that's Ruby 2.7.1 gem install bundler
node.js
- (Recommended) Install nvm, which is a node version manager.
- Install a current LTS version of Node. 12.16.2 works.
- Install yarn. On Ubuntu, make sure you install it from the official Yarn repo instead of cmdtest.
PostgreSQL ("postgres")
- Make sure that postgres is installed.
- On a Mac, you can use brew install postgres OR brew postgresql-upgrade-database if you have an older version of postgres, or use Postgres.app.
- If you're on Ubuntu/WSL, use
sudo apt-get install libpq-devso the gem can install. Use the Postgres repo for Ubuntu or WSL to get the server and client tools. - If you're on Fedora/Cent Os use
sudo dnf install libpq-devel. If you prefer choose package of libpq-devel via rpm
Chromedriver
- If you use the Chrome browser, that is enough. If not, install the current stable release of chromedriver for your operating system so the browser-based Ruby feature/integration tests can run. Installing
chromium-browseris enough, even in WSL.
(on a Mac or Linux machine)
git clone https://github.com/rubyforgood/casa.gitclone the repo to your local machine. You should create a fork in GitHub if you don't have permission to commit directly to this repo, though. See our contributing guide for more detailed instructions.cd casa/bundle installto install all the Ruby dependencies.yarn installto install all the Javascript dependencies.bin/rails db:setuprequires running local postgres, with a role created for whatever user you're running rails as
Running Tests
bin/rails specto run the Ruby test suiteyarn testto run the Javascript test suite
Test coverage is run by simplecov on all builds and aggregated by CodeClimate
Running the development server
bin/rails db:seedload sample data into the databasebin/rails serverrun server
Cleaning up before you commit
bundle exec standardrb --fixauto-fix Ruby linting issues more linter infobundle exec erblint --lint-all --autocorrectERB linteryarn lint:fixto run the JS linter and fix isses
If you have any troubles running tests, check out the files in .github/workflow/ which is what makes the CI build run.
If additional work arises from your commit that is outside the scope of the issue it resolves, please open a new issue and either:
- assign it to yourself if you'd like to take it on
- or add it to the to-do column without an assignee so someone else can pick up this new issue.
Local email
We are using Letter Opener in development to receive mail. All emails sent in development should open in a new tab in the browser.
Post-deployment tasks
We are using After Party to run post-deployment tasks. These tasks may include one-time necessary updates to the database. Run the tasks manually by:
bundle exec rake after_party:run
Alternatively, every time you pull the main branch, run:
bin/update
which will run any database migrations, update gems and yarn packages, and run the after party post-deployment tasks.
There is a doc directory at the top level that includes:
- an
architecture-decisionsdirectory containing important architectural decisions and entity relationship diagrams of various models (see the article Architectural Decision Records describing this approach). - Code of Conduct
- CONTRIBUTING.md
- CYPRESS.md
- DOCKER.md
- LINUX_SETUP.md
- SECURITY.md
- If your rake/rake commands hang forever instead of running, try:
rails app:update:bin - There is currently no option for a user to sign up and create an account through the UI. This is intentional. If you want to log in, use a pre-seeded user account and its credentials.
- If you are on windows and see the error "Requirements support for mingw is not implemented yet" then use https://rubyinstaller.org/ instead
- If you are on Ubuntu in Windows Subsystem for Linux (WSL) and
rbenv installindicates that the Ruby version is unavailable, you might be using Ubuntu's default install ofruby-build, which only comes with old installs of Ruby (ending before 2.6.) You should uninstall rvm and ruby-build's apt packages (apt remove rvm ruby-build) and install them with Git like this:
git clone https://github.com/rbenv/rbenv.git ~/.rbenvecho 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrcecho 'eval "$(rbenv init -)"' >> ~/.bashrcexec $SHELLgit clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
You'll probably hit a problem where ruby-version reads ruby-2.7.1 but the install available to you is called 2.7.1. If you do, install rbenv-alias and create an alias between the two.
See db/seeds for seed data. Test data includes the below
- [email protected] / 123456 https://<URL>.herokuapp.com/
- [email protected] / 123456 https://<URL>.herokuapp.com/
- [email protected] / 123456 https://<URL>.herokuapp.com/
- [email protected] / 123456 https://<URL>.herokuapp.com/all_casa_admins/sign_in
In the emails listed above, the number 1 corresponds to a casa_org_id. To log in to a different casa_org's instance, change the casa_org_id number in the email, and add a hyphen and numerical value to the end.
Example: To log into CASA Org 2's instance, use the following email: [email protected]. In this example, the number 2 corresponds to the casa_org, and the number 1 corresponds to the user.
When pull requests are merged, the code auto-deploys to QA (because of a heroku setting)
https://casa-qa.herokuapp.com/
If you would like to help run quality assurance, please check out the Merged to QA section of our project board. For each ticket in this column, log into the QA environment to confirm whether or not this change has indeed been made and is working as intended. If yes, please add the label: working-in-qa to the ticket. If it is not, please add the label: not-working-in-qa to the ticket. If you discover bugs in this process, please file an issue for it, add the label: bug, and add it to the To do column. ***This is a great task for PM contributors looking to familiarize themselves with the application and project board.
Deploy to Staging is manual. Training of new users is done in staging.
https://casa-r4g-staging.herokuapp.com/
We have real users in production!
If you represent a CASA organization which wants to use this, please contact us! [email protected]
Follow this Deployment Checklist
We are currently using https://app.bugsnag.com/ to track errors in staging. Errors post to slack at #casa-bots.
This app sends email for user signup and deactivation. We use https://www.sendinblue.com/ because we get 300 free emails a day, which is more than we expect to need.
Sendinblue has historically sometimes been very slow (6 hours) in delivering email, but sometimes it delivers within a minute or two. Be wary.
You log into sendinblue via the "log in with google" option. Sean has the credentials for this and hopefully we never need to change them.
We are not using Mailgun because they limited us to only 5 recipients without a paid plan. We looked at using Sendgrid but our account is currently locked for unknown reasons.
Preview all emails at http://localhost:3000/rails/mailers/volunteer_mailer as configured by volunteer_mailer_preview.rb
Namecheap, Heroku
Most conversation happens in the #casa channel of the Ruby For Good slack. Get access here: https://rubyforgood.herokuapp.com/
You can also open an issue or comment on an issue on github and a maintainer will reply to you.
We have a weekly team office hours / hangout on Wednesday 6-8pm Pacific time where we do pair/mob programming and talk about issues. Please stop by!
We have a weekly stakeholder call with PG CASA staff on Wednesday at 8:30am Pacific time where we show off progress and discuss launch plans. Feel free to join!
Join info for all public meetings is posted in the rubyforgood slack in the #casa channel
First CASA supervisor training: 12 August 2020 🎉