https://github.com/maccman/saasy

Rails SaaS and SSO solution
https://github.com/maccman/saasy

Last synced: 15 days ago
JSON representation

Rails SaaS and SSO solution

• Host: GitHub
• URL: https://github.com/maccman/saasy
• Owner: maccman
• License: mit
• Created: 2008-12-18T14:47:14.000Z (almost 16 years ago)
• Default Branch: master
• Last Pushed: 2009-08-03T14:52:27.000Z (over 15 years ago)
• Last Synced: 2024-08-01T16:37:02.372Z (3 months ago)
• Language: Ruby
• Homepage: http://madebymany.co.uk
• Size: 8.15 MB
• Stars: 522
• Watchers: 8
• Forks: 60
• Open Issues: 2
• Metadata Files:
  • Readme: README
  • License: MIT-LICENSE

Awesome Lists containing this project

README

        
== 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 

http://eribium.org 

[email protected]

== 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)