Wautils2. This is a rewrite of
wild_apricot_python_flask_utils, but since it is
mostly ruby that didn't seem like a very good repo to stash this app.
Watto provides an utility interface to the Nova Labs Wild Apricot account for a few custom tasks that we need in the Maker Space. This is primariliy for class instructors and shop stewards to manage sign offs.
Recomend using a ruby version manager such as RVM or [rbenv](https://github.com/rbenv/rbenv], but this project doesn't have any preferences.
Clone the repo, create a .env file with the necessary envrionment variables
(see .env-example for the options).
Then to install the dependencies and setup the database:
./bin/setup
Then to get a local web server:
./bin/server
Running the tests:
./bin/rspec
This app doesn't make much sense without a Wild Aprocot account.
Authentication is done via OAuth with Wild Apricot.
The following models are kept in sync with Wild Apricot
| Rails Model | Wild Apricot Model | Description |
|---|---|---|
| User | Contact | Contact or member. |
| Field | Field | Field description and type |
| FieldUserValue | Value | A users value for a field, may be multiple for a field if it is MultipleChoice. |
| FieldAllowedValue | AllowedValues | Allowed options for a Field, e.g. multiple choice options. |
| Event | Event | Event with time and place. |
| EventRegistration | EventRegistration | A person registered for an event. |
Sync of these models can happen via a command line task:
./bin/rails wa:sync
Or individual resource collections:
./bin/rails wa:users
./bin/rails wa:events
To see all the options run:
./bin/rails -T
Watto uses Google Sheets as a data source for the waitlist features.
Required Environment Variables. Add the following to your .env:
WAITLIST_GOOGLE_SHEET_ID=... # Google Sheet ID (from the URL)
GOOGLE_CREDENTIALS_JSON=... # JSON credentials for a service account
Setup Steps
- Create a Google Cloud service account
- Enable the Google Sheets API in the Google Cloud project.
- Download the JSON credentials and put the body of the file in the
GOOGLE_CREDENTIALS_JSONenv var. - Share your spreadsheet with the service account's email (e.g., watto@your-project-id.iam.gserviceaccount.com).
- Make sure your spreadsheet includes the available_classes, active_waitlist, and completed tabs.
MIT. See LICENSE.
"Mind tricks don't work on me." -- Watto