ludamillion / casa

Volunteer management system for nonprofit CASA, which serves foster youth in counties across America.

CASA Project and Organization Overview

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.

• Welcome contributors!
  • About this project
• Developing! ✨🛠✨
  • Installation
    • General Setup Instructions
    • Platform Specific Installation Instructions
      • Ubuntu and WSL
  • Running the App / Verifying Installation
• Other Documentation
  • Common issues
• Communication and Collaboration
• History

Welcome contributors!

We are very happy to have you! CASA and Ruby for Good are committed to welcoming new contrinbutors of all skill levels.

We highly recommend that you join us in slack https://rubyforgood.herokuapp.com/ #casa channel to ask questions quickly and hear about office hours (currently Wednesday 6-8pm Pacific), stakeholder news, and upcoming new issues.

Issues on the issue board https://github.com/rubyforgood/casa/projects/1 in the TODO column are fair game. An issue can be claimed by commenting on it.

Pull requests which are not for an issue but which improve the codebase are also welcome! Feel free to make github issues for bugs and improvements. A maintainer will be keeping an eye on issues and PRs every day or three.

See also our contributing guide 💖 ✨

About this project

CASA is a national organization with many regional chapters. We currenly work with Prince George's County CASA in Maryland and Montgomery CASA Maryland

This system provides value by:

• providing volunteers with a portal for logging activity
• allow supervisors to oversee volunteer activity
• generate reports on volunteer activity for admins to use in grant proposals

Read about the product sense that guides our approach to this work.

How CASA works:

• A foster youth is represented as a CASA case.
• The CASA case is assigned to a volunteer.
• The volunteer records their efforts spent on the CASA case as case contacts.
• Supervisors oversee CASA volunteers by monitoring, tracking, and advising them on CASA case 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). A volunteer's lifecycle is very long, so there's a lot of activity for chapters to organize.

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 for PG County CASA and Montgomery county CASA, we are building with a mind toward multitenancy so this platform could prospectively be used by other CASA chapters across the country.

More information:

The complete role description of a CASA volunteer in Prince George's County.

Developing! ✨🛠✨

Installation

General Setup Instructions

Ruby

1. Install a ruby version manager: rvm or rbenv
2. when you cd into the project directory, let your version manager install the ruby version in .ruby-version. Right now that's Ruby 3.0.2
3. gem install bundler

node.js

1. (Recommended) Install nvm, which is a node version manager.
2. Install a current LTS version of Node. lts/fermium works.
3. Install yarn. On Ubuntu, make sure you install it from the official Yarn repo instead of cmdtest.

PostgreSQL ("postgres")

1. Make sure that postgres is installed.

• If you're on Ubuntu/WSL, use sudo apt-get install libpq-dev so 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
• If you're on Windows, use the official installer and accept all defaults. Alternatively, a Chocolatey package is available with choco install postgresql.

Chrome Browser

1. The Spec tests uses Chrome Browser and Chromedriver for some of the tests. A current version of chromedriver will be installed when bundle install is run. TO install Chrome, see Chrome Install.

Another option is to install the Chromium browser for your operating system so the browser-based Ruby feature/integration tests can run. Installing chromium-browser is enough, even in WSL (Windows subsystem for Linux)

Downloading the Project (on a Mac or Linux machine)

1. git clone https://github.com/rubyforgood/casa.git clone 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.

Installing Packages

1. cd casa/
2. bundle install install ruby dependencies.
3. yarn install javascript dependencies.

Database Setup

1. bin/rails db:setup create schema requires running local postgres, with a role created for whatever user you're running rails as
2. bin/rails db:seed:replant generates test data (can be rerun to regenerate test data)

Webpacker One Time Setup bundle exec rails webpacker:compile

Platform Specific Installation Instructions

• Docker
• Linux
• Mac(Help Wanted)
• Windows(Help Wanted)
• Windows Subsystem for Linux(WSL) (Help Wanted)

Ubuntu and WSL

1. If you are on Ubuntu in Windows Subsystem for Linux (WSL) and rbenv install indicates that the Ruby version is unavailable, you might be using Ubuntu's default install of ruby-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 ~/.rbenv
• echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
• echo 'eval "$(rbenv init -)"' >> ~/.bashrc
• exec $SHELL
• git 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.2 but the install available to you is called 2.7.2. If you do, install rbenv-alias and create an alias between the two.

Common issues

1. If your rails/rake commands hang forever instead of running, try: rails app:update:bin
2. 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.
3. If you are on windows and see the error "Requirements support for mingw is not implemented yet" then use https://rubyinstaller.org/ instead
4. Install imagemagick to see images locally. Instructions: https://imagemagick.org/script/download.php

Running the App / Verifying Installation

1. bin/rails server or bin/rails s to start the local webserver

Running Tests

• run the ruby test suite bin/rails spec

• run the javascript test suite yarn test

• run cypress tests

  bundle exec rails server -b 0.0.0.0 -p 4040
  npm run test:cypress --exit-code 0
  

If you have trouble running tests, check out CI scripts in .github/workflows/ for sample commands. Test coverage is run by simplecov on all builds and aggregated by CodeClimate

Cleaning up before you pull request

1. bundle exec standardrb --fix auto-fix Ruby linting issues more linter info
2. bundle exec erblint --lint-all --autocorrect ERB linter
3. yarn lint:fix to run the JS linter and fix isses
4. rake factory_bot:lint if you have been editing factories and want to find factories and traits which produce invalid objects

If additional work arises from your pull request that is outside the scope of the issue it resolves, please open a 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.

To see local email previews, check out http://localhost:3000/rails/mailers

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.

Other Documentation

Check out the wiki

There is a doc directory at the top level that includes:

• an architecture-decisions directory containing important architectural decisions and entity relationship diagrams of various models (see the article Architectural Decision Records describing this approach).
• Code of Conduct
• CYPRESS.md
• productsense.md(for team leads & product interested contributors)
• SECURITY.md

Communication and Collaboration

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! (Zoom link in slack)

We have a weekly stakeholder call with CASA stakeholders on Wednesday at 8:30am Pacific time where we show off progress and discuss launch plans. Feel free to join! (Zoom link in slack)

Join info for all public meetings is posted in the rubyforgood slack in the #casa channel

Feedback

We are very interested in your feedback! Please give us some :) https://forms.gle/1D5ACNgTs2u9gSdh9