Skip to content
hightechhostel edited this page Dec 11, 2015 · 3 revisions

Welcome to the start of tollmaster wiki!

Tollmaster is an open source Ruby on Rails project created by Digital Strategies to help make coworking spaces more easily accessible to the general public. Specifically, the app was developed for Nomad-A-What Travel Coworking in San Francisco. Nomad-A-What found that many customers wanted to informally try out coworking for a few hours and were not necessarily ready to commit to a $25 day pass. The Tollmaster app allows customers to tokenize their payment information to Stripe and access the space with just the touch of a button. At the end of the day, their charges are totaled and invoiced and sent to Stripe for processing.

Here is the basic workflow for the customer in our installation:

  1. Customer visits door.nomadawhat.com and logins in using their cell number.

  2. The app tokenizes their cell phone number to create a private dashboard URL which is sent to Twilio.

  3. Twilio then sends a text message to the user with their private dashboard URL. Now the users cell phone number has been verified and this is the first layer of security.

  4. The user follows the link contained in the text message received and the private dashboard URL is loaded in the users mobile browser. (The private dashboard URL will work on a laptop or other browser but it was intended to be used on a mobile browser).

  5. If this is the first time the user is using the app (i.e. their payment information has not been tokenized) then the app will display the signup form. This will ask the user their name, email address, and credit card information.

  6. Upon submission of the above form the app will validate the users input and credit card with Stripe. If successful, the user will be presented with a button that says "Checkin and Open Doors".

  7. When the user clicks the button the app will CURL a secret URL to buzz the entry doors. The secret URL is based on the hardware door controller being used. In our case, we used an ioBridge microcontroller (see below).

  8. The user is then presented with two buttons, "Open Doors" (used for double doors and repeat entries), and "Checkout". The user may open the doors as many times as they want while checked into the space.

  9. When the user is finished using the space, they click "Checkout" and their usage timer will stop. At this time an email will be sent to the user telling them the total time they used the space and the total charges.

  10. At the end of the day, the app will submit charges to Stripe for all users who used the space during that day.

WARNINGS: This app is not intended to provide unattended access to a coworking space or other buildings. It's always advisable to have someone onsite to monitor the people coming in and out of your space. At minimum, you should have CCTV monitoring and other security protocols in place.

While each user is validated with their cell phone and credit card number, it's possible the cell phone and credit card could be stolen. For this reason, you should take security measures to greet and monitor customers coming into the space.

Since any software is susceptible to hacking, it's HIGHLY RECOMMENDED that you have a hardware lockout on on your door controller that will limit access to the space even when the app is requesting access. In fact, the app currently does not have user time restrictions built in. Therefore, the app could allow unintended access to your space if you don't have a hardware lockout.

[HARDWARE INSTALLATION](HARDWARE INSTALLATION)

TO BE CONTINUED>>>>> email Darren via the nomadawhat.com website for more information in the meantime.

Clone this wiki locally