Rails SaaS and SSO solution
Ruby JavaScript
Latest commit 4fe610f Aug 3, 2009 @maccman fix nil error
Failed to load latest commit information.
config Updated rails Mar 19, 2009
doc Corrected screenshot extension Dec 23, 2008
lib Fixed some issues with subscription renewall time - hardcode it to a … Mar 9, 2009
script first commit Dec 23, 2008
test first commit Dec 23, 2008
README Cron job typo in readme Jan 17, 2009
Rakefile first commit Dec 23, 2008


== Welcome to Saasy

Saasy is a Rails app that bills and authenticates, so you don't have to.
The idea is that you host Saasy on a subdomain, and communicate with it using SSO/REST protocols. 
That means you're free to do more interesting coding.

*At the moment this is alpha code - use at your own risk*

I'd like to thank Made by Many (http://madebymany.co.uk) for supporting this project.

Alex MacCaw 


== Screenshots
* Billing         - http://github.com/maccman/saasy/tree/master/doc/Saasy_Billing.png
* Sign up         - http://github.com/maccman/saasy/tree/master/doc/Saasy_Signup.png
* Edit profile    - http://github.com/maccman/saasy/tree/master/doc/Sassy_Edit_Profile.png
* Example Invoice - http://github.com/maccman/saasy/tree/master/doc/invoice.pdf

== Overview

* Subscription management
* Recurring billing
* Credit card management
* User authentication and SSO

== Features

* No local credit card storage
* Automated billing script that should be run nightly
* Configurable subscription plans (price/duration)
* SSL protection for account creation (and when updating CC info)
* Account can have multiple users, interface for adding more
* Trial ending mailer
* Invoice mailer
* Automated notification and retry of failed renewals
* Plan upgrade/downgrades
* PDF invoices
* Forgot password retrieval
* OpenID support
* Shared secret SSO
* Credit card verification
* REST API for users and subscriptions

== Getting Started

# cp config/database.example.yml config/database.yml
# cp config/application.example.yml config/application.yml
# cp config/subscription.example.yml config/subscription.yml
# rake db:schema:load
# Setup a cron job to run `rake subs:daily` daily
# configure application.yml
# configure subscriptions.yml
# script/server -p 3001

== Gateways
Currently the following gateways are supported:
* Braintree
* TrustCommerce
* PaymentExpress

== Choosing a Gateway

Braintree seems to be a good choice, and they're friendly to Railers to:
* http://groups.google.com/group/rails-business/msg/53da3705df6063a2

== Test transactions

As far as I could tell, Braintree are the only Gateway that lets you
test transactions without signing up.
* http://dev.braintreepaymentsolutions.com/test-transaction/

== SSO (single sign on)

I've implemented a simple SSO using shared secrets.
have a look at lib/sso.rb for more information.

== Gotchas

I've made some extensions to various plugins/libs which I've
yet to push back:

* Extended ActiveMerchant's Braintree and Trust Commerce gateways (see initializers)
* Edited acts_as_state_machine:
  * Added named_scope 'in_state'
  * Stopped it overriding any states I specified before creation
  * Make it update all the attributes on save, not just the state column
* Used the Rails 2.2 version of prawnto (http://github.com/filiptepper/prawnto/tree/master) 
* Edited ssl_requirement so that it's disabled in development/test mode.
* Rails error_messages_for now uses spans, instead of divs, to be standards compliant
* Add a float component to Prawn (see initializers)