- What are we building?
- Getting setup
- Running the test suite
- Running the App Locally
- User Roles
- Regional Admin (has access to all communities within their regions)
- Community Admin Role (has access to everything scoped to their Community)
- Community Volunteer Role (has limited access to their community)
- Community Accompaniment Leader Role (only applicable to Primary communities)
- Remote Clinic Lawyer Role
- How are we building it?
- Maintenance
- Contributing
- Code of Conduct
- Questions?
- Contributors
The New Sanctuary Coalition is a network of congregations, organizations, and individuals standing publicly in solidarity with families and communities resisting detention and deportation. This internal database software facilitates NSC's core programs and allows them to operate at increasing scale.
NSC's programs include:
- Accompaniment Program: pairs undocumented people with a group of trained volunteers to accompany them to their immigration hearings and check-ins with ICE.
- Pro-se Clinic: a weekly clinic where undocumented people work with trained volunteers and lawyers to prepare documents (asylum applications, juvenile visas, etc.) to fight their immigration case.
- Anti-Detention Program: works with detained immigrants across the US and their families to fight for their release.
Learn More
- About New Sanctuary Coalition: http://www.newsanctuarynyc.org/
- About how this project supports NSC's work (Strange Loop, 2019): https://www.youtube.com/watch?v=5htAAL0cc_w
- About this project (5by5 Ruby on Rails Podcast): https://5by5.tv/rubyonrails/284
- ruby (see Gemfile for version)
- postgres
For local development, create a .env file in the root directory of the application and copy the environment variables contained in .env.example into your newly created .env file.
If you are using docker to run the application (as described below), add POSTGRES_PASSWORD=password to your .env file.
Docker is a way for you to run this application on your machine without changing any of your local settings or installing anything new (besides Docker itself).
More instructions here.
gem install bundler
bundle install
This app uses a Postgresql database. Instructions diverge based on your operating system.
Install Postgres.app: https://postgresapp.com
I recommend running Postgres in a docker container. To run Postgres on docker, you can do the following:
docker pull postgres:9.6
docker run --name new_sanctuary -p "127.0.0.1:5432:5432" -e POSTGRES_PASSWORD=password -d postgres:9.6NOTE: If you are using psql instead of Postgres.app, create your user this way:
$ createuser postgres --createdb
$ psql
psql (10.2)
Type "help" for help.
yourname=# ALTER USER postgres WITH PASSWORD 'password';
To run initial migrations and seed the DB:
cp config/database.yml.sample config/database.yml
rake db:setup
To switch from using docker back to using the rails server locally, run:
cp config/database.yml.sample config/database.yml
rspec
CircleCI is set up for the app, and will run the full test suite when you push to github. There are still some flappy specs, unfortunately :/ ...so, if the specs pass locally, but not on CircleCI, feel free to leave a note when you create your PR.
rails server- Can do everything that a Community Admin can do for the communities in their regions
- Can view, create, edit communities in their regions
Login as a Regional Admin with:
- username: [email protected]
- password: Password1234
- Can view friends, create new friend records, edit friend records, and delete friend records
- Can view users, invite users, edit users, and delete users
- Can create activities for a friend (and can edit them)
- Can create, edit, and remove asylum application drafts for a friend
- Can share friend records with specific users (In the 'Asylum' tab when editing a friend, the 'Volunteers with Access' field)
- Can view, create, edit sanctuaries
- Can view create, edit lawyers
IF the Community is 'primary' (ie. primary = true), additionally:
- Can view create, edit locations
- Can view create, edit judges
- Can generate reports
- Can create, edit, delete NSC events (ie. trainings and workshops) and can take attendance of volunteers and friends attending the event
- Can view an index of upcoming and past Activities and Accompaniments
Login as an Admin of a Primary Community with:
- username: [email protected]
- password: Password1234
Login as an Admin of a Non-Primary Community with:
- username: [email protected]
- password: Password1234
- Can receive an invitation (emailed) and follow the link to create a volunteer account
- Can view friend records that have been shared with them
- Can add other users to friend records that have been shared with them
- Can create, edit, and remove asylum application drafts
IF the Community is 'primary' (ie. primary = true), additionally:
- Can view limited details about friend activities (ie. accompaniments) this week and next week
- Can RSVP to attend a friend activity (ie. accompaniment) and can edit their RSVP
Login as an Volunteeer for a Primary Community with:
- username: [email protected]
- password: Password1234
Login as an Volunteeer for a Non-Primary Community with:
- username: [email protected]
- password: Password1234
- Can do everything a volunteer can do
- Can view contact information about friends and volunteers involved in accompaniments
- Can create report for accompaniments they attend
Login as an Accompaniment Leader with:
- username: [email protected]
- password: Password1234
- Can be assigned Friends from a non-primary Community
- Can view assigned Friends and drafts of their application
- Can add reviews to drafts of applications and can approve drafts of applications
Login as a Remote Clinic Lawyer with:
- username: [email protected]
- password: Password1234
Aiming to cover the functionality we build with:
- model tests
- feature tests to cover the main pathways through the app
- controller specs (ONLY for authorization)
We have a staging app here with seed data: https://frozen-sea-20640.herokuapp.com The data is refeshed occassionally, but activities/accompaniments are likely to be out of date.
We are using Skylight for performance monitoring.
When making changes to the README of this project, make sure to run the following:
rake toc
This will ensure the Table of Contents for this project is properly updated.
- Add a comment on your chosen Github issue to let other contributors know that you have 'claimed' it.
- Fork the repo and download a clone of the forked repo: https://guides.github.com/activities/forking/
- Create a feature branch off master.
- Complete feature with tests!
- Check CircleCI to make sure tests are passing.
- Make a pull request and tag CZagrobelny to review.
- CZagrobelny will QA and leave feedback (usually within a few days of when the PR is opened) and merge into master upon approval of the pull request.
It can be really helpful to get notifications when new issues are opened! Here is how you subscribe to notifications:
- Questions about a PR, tag CZagrobelny in a comment on the PR
- Other questions, email [email protected]
We have an amazing group of contributors and organizations working to build out the software!
- Individual Contributors: https://github.com/CZagrobelny/new_sanctuary_asylum/graphs/contributors
- Ruby for Good: https://rubyforgood.org
- Progressive Hacknight: http://www.progressivehacknight.org
- Write/Speak/Code: https://www.writespeakcode.com