Skip to content

Rails app for womensdirectory.org, a free online resource for women to find help in their community.

License

Notifications You must be signed in to change notification settings

Womens-Directory/womens-directory

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Women's Directory is a non-profit organization. Our website shows women in need where they can find help and critical resources in their communities.

This Rails app runs the Women's Directory production website.

Contributors

All Contributors

Thanks goes to these wonderful people (emoji key):

katjimeno
katjimeno

💻
Matt Lewis
Matt Lewis

💻 🚇
Amanda Rodgers
Amanda Rodgers

💻 🖋 💼

This project follows the all-contributors specification. Contributions of any kind welcome!

Features

  • Users can browse for locations that offer services helpful to women in need.
  • Locations are categorized (for example: shelters, food banks) so that women can quickly find what they need.
  • The app has three main views:
    • The homepage presents a complete list of categories.
    • The category page shows a list of all the locations that belong to that category.
    • The location page presents information about the location, such as location and contact information.
  • Users can submit feedback via the button located in the bottom-right corner of all pages. Feedback is sent to a configurable Discord channel for admins to review, and stored in the database.
  • Admin tools are available only once an admin user has signed in via /users/sign_in. They include:

Installation

WD uses Ruby 3.0.0, Node 16.14.0 and Postgres 14.

Start your Postgres server locally. On Mac, Postgres.app is a good option.

Install dependencies, prepare the assets, and create and seed the database:

bundle install
rails yarn:install
rails assets:precompile
rails db:setup

Usage

Start the server:

rails server

The database has already been seeded with demo categories and locations, as well as an admin user.

Sign into the app at localhost:3000/users/sign_in. Use the email address dev@womensdirectory.org to sign in as an admin.

Once you have signed in, go back to the homepage. The admin tools will be available under the Admin dropdown in the nav bar.

Deployment

This app is owned by the Women's Directory team in DigitalOcean. It is deployed as a DigitalOcean App.

Commits that land in the main branch are automatically deployed to production. The DigitalOcean App Platform watches for these commits. It builds a new image using Buildpack. It starts a new container from this image which replaces the previous WD container.

If you land code that includes database migrations, you must run them manually in the DigitalOcean console. After the new instance is live in production, go to the App's console and run rails db:migrate.

Environment Variables

Key Description
APP_DOMAIN The domain where the application lives (currently womens-directory-kgjo4.ondigitalocean.app)
DISCORD_WEBHOOK_URL The URL for a Discord channel's webhook, used for forwarding website feedback to WD staff
EMAIL_DOMAIN The send-from domain used for emails, authorized for use in SendGrid (usually womensdirectory.org)
GOOGLE_MAPS_API_KEY The API key for the Google Cloud project with access to geocoding
INSECURE If set, uses HTTP for URLs; if unset (default), uses HTTPS
SENDGRID_API_KEY The API key for sending emails via SendGrid

Permissions

Roles are created in user.rb. They are stored in a Postgres bigint (8 bytes) as an ordered bitfield, so do not reorder existing roles!

Roles are granted abilities which allow them to access specific kinds of data and perform specific operations. For example, a superadmin is allowed to do anything; a data_contributor is only allowed to create some kinds of records. Abilities are granted permissions in ability.rb.

Superadmins can manage permissions for non-superadmin users at /admin/user_permissions.

Support

Problems, suggestions, or contributions? Please open an issue or submit a pull request.

About

Rails app for womensdirectory.org, a free online resource for women to find help in their community.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published