saasy 0.0.1

data/CHANGELOG.md

@@ -0,0 +1,114 @@
+0.8.2
+
+Added a uniqueness validation and database constraint for member_id/project_id on permissions. This prevents somebody from being added to the same project twice, which would display it multiple times in the project index and dropdown. When upgrading, make sure this index is in place:
+
+    remove_index :permissions, :name => [:membership_and_project]
+    add_index :permissions, [:membership_id, :project_id], :name => [:membership_and_project], :unique => true
+
+You'll need to make sure that no existing duplicates exist before applying the unique index.
+
+0.8.1
+
+Fixed a missing translation key.
+
+0.8.0
+
+Added a notification for trials that just ended. When upgrading, you'll need to
+add to add a boolean notified_of_completed_trial column to the accounts table,
+which should be NOT NULL and default to false. These notifications go out with
+the daily Saucy jobs.
+
+0.7.3
+
+Added a uniqueness constraint for keyword on accounts/projects. When upgrading,
+projects should ensure that there is a unique index on these columns. The
+projects index needs to be scoped to an account ID, so that index should be on
+both columns (account_id and keyword).
+
+0.7.2
+
+Don't bother to show the account selection on the project form if the user is only an
+admin on one account
+
+0.7.1
+
+Introduce a project dropdown, include it with:
+
+    render :partial => "shared/project_dropdown"
+
+Saucy provides the javascript for this dropdown, but not the CSS or the image 
+for the dropdown.  The Javascript depends on jQuery.
+
+Also, adds the ability to move a project to another project that you are an
+admin on.
+
+0.7.0
+
+Split Saucy::Configuration.mailer_sender into support_email_address and manager_email_address.
+
+0.6.1
+
+Fix for this known bug in Rails 3.0.7
+
+    https://rails.lighthouseapp.com/projects/8994/tickets/6757-hashfrom_xml-chokes-on-empty-cdata
+
+0.6.0
+
+Upgrading to, and making an explicit dependency on Clearance ~> 0.11.0. You can
+get an overview of the important changes to clearance here:
+
+    https://github.com/thoughtbot/clearance/wiki/upgrading-clearance
+
+0.5.5
+
+Fixes for account and project keywords containing special characters, generated by signup
+
+0.5.4
+
+Changes from an archive project link to a checkbox on the project form.
+
+0.5.3
+
+Removes uniqueness constraint on account names
+
+0.5.2
+
+Simplifies the signup process to asking users for just an email and password. 
+Overall this should be seamless upgrade but you may have made other changes in
+your application which might conflict, just pay attention when you upgrade.
+
+You'll defintely want to make sure you regerate the saucy features with this upgrade:
+
+    rails g saucy:features
+
+0.5.1
+
+Add an index to the archived column for projects
+
+0.5.0
+
+Added the ability to archive projects. Archived projects are not included in
+an accounts `projects_count`.
+
+To upgrade to this version add the following column to the projects table:
+
+    add_column :projects, :archived, :boolean, :default => false, :null => false
+    add_index :projects, :archived
+
+This version adds a list of archived projects to the projects index of an
+account. An introduced headers to these two lists. Archived projects have
+a "View Project" link, which is how the user can view an archived project. 
+You will probably want to style this list, headers, and link.
+
+It also adds an Archive/Unarchive link on the project's edit page. You will probably
+want to style these links.
+
+It is up to your application to provide any additional logic about what
+limitations are present for archived projects (for example, not being able to
+create new comments on them).
+
+0.4.10
+
+A user following an invite link who is already signed in and whose email
+address matches the one in the invite automatically accepts the invite when
+following the link.

data/Gemfile

@@ -0,0 +1,26 @@
+source "http://rubygems.org"
+gem "cucumber"
+gem "aruba"
+gem "rake"
+gem "rspec-rails", :require => false
+gem "rails", ">= 3.0.3"
+gem "thin"
+gem "clearance", "~> 0.11.0"
+gem "shoulda", :require => false
+gem "bourne", :require => false
+gem "sqlite3", :require => false
+gem "factory_girl", :require => false
+gem "sinatra"
+gem "sham_rack"
+gem "braintree"
+gem "timecop"
+
+# used by the rails app in cucumber
+gem "cucumber-rails", :require => false
+gem "capybara", :require => false
+gem "factory_girl_rails", :require => false
+gem "formtastic", :require => false
+gem "database_cleaner", :require => false
+gem "dynamic_form", :require => false
+gem "launchy", :require => false
+gem "jquery-rails", :require => false

data/README.md

@@ -0,0 +1,118 @@
+Saucy
+=====
+
+Saucy is a Rails engine for monthly subscription-style SaaS apps.
+
+Example scenarios covered by Saucy:
+
+* I sign up for "Free" plan under new account "thoughtbot"
+* I am an admin and can be reached at "dan@example.com"
+* I create a project "Hoptoad"
+* I upgrade to the "Basic" plan and my credit card is charged
+* I now have permissions to add users and projects to the "thoughtbot" account
+* I invite "joe@example.com" to "Hoptoad"
+* I create a project "Trajectory"
+* I invite "mike@example.com" to "Trajectory"
+
+Installation
+------------
+
+In your Gemfile:
+
+    gem "saucy"
+
+After you bundle, run the generator:
+
+    rails generate saucy:install
+
+You will want to include the `ensure_active_account` `before_filter` in any controller actions that you want to protect if the user is using an past due paid account.
+
+You will want to customize the from email addresses.
+
+Support email address for your application:
+
+    Saucy::Configuration.support_email_address = "support@example.com"
+
+Personalizable emails such as trial expiration notice and activation encouragement are sent from a product manager personal address:
+
+    Saucy::Configuration.manager_email_address = "manager@example.com"
+
+If you have an account with Braintree with multiple merchant accounts you'll want to configure the merchant account for this application:
+
+Saucy::Configuration.merchant_account_id = 'your merchant account id'
+
+In addition, there are a number of strings such as application name, support url, automated emails, etc. that are provided and customized with i18n translations.  You can customize these in your app, and you can see what they are by looking at config/locales/en.yml in saucy.
+
+There is a `saucy:daily` rake task which should be run on a regular basis to send receipts and payment processing problem emails.
+
+Saucy accounts become "activated" once an initial setup step is complete. This could be creating the first bug for a bug tracker, or setting up a client gem for a server API. Once the application detects that the account is activate, it should set "activated" to true on the account. This will prevent followup emails being sent to users that have already set up their accounts.
+
+Development environment
+-----------------------
+
+Plans need to exist for users to sign up for. In db/seeds.rb:
+
+    %w(free expensive mega-expensive).each do |plan_name|
+      Plan.find_or_create_by_name(plan_name)
+    end
+
+Then run: rake db:seed
+
+Test environment
+----------------
+
+Generate the Braintree Fake for your specs:
+
+    rails generate saucy:specs
+
+Generate feature coverage:
+
+    rails generate saucy:features
+
+To use seed data in your Cucumber, add this to features/support/seed.rb:
+
+    require Rails.root.join('db','seeds')
+
+Customization
+-------------
+
+By default Saucy uses and provides a `saucy.html.erb` layout. To change the 
+layout for a controller inside of saucy, add a line like this to your 
+config/application.rb:
+
+    config.saucy.layouts.accounts.index = "custom"
+
+In addition to just the normal yield, your layout should yield the following 
+items in order to get everything from saucy views:
+
+* :header
+* :subnav
+
+To extend the ProjectsController:
+
+    class ProjectsController < ApplicationController
+      include Saucy::ProjectsController
+
+      def edit
+        super
+        @deleters = @project.deleters
+      end
+    end
+
+To define additional limit meters, or override existing limit meters, create the
+partials:
+
+    app/views/limits/_#{limitname}_meter.html.erb
+
+You can override all the views by generating them into your app and customizing them there:
+
+    rails g saucy:views
+
+## Gotchas
+
+Make sure you don't do this in ApplicationController:
+
+    before_filter :authenticate
+
+Saucy's internal controllers don't skip any before filters.
+

data/Rakefile

@@ -0,0 +1,38 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rake'
+require 'rake/gempackagetask'
+require 'cucumber/rake/task'
+require 'rspec/core/rake_task'
+
+desc 'Default: run all tests'
+task :default => [:spec, :cucumber]
+
+Cucumber::Rake::Task.new(:cucumber) do |t|
+  t.fork = true
+  t.cucumber_opts = ['--format', (ENV['CUCUMBER_FORMAT'] || 'progress')]
+end
+
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "spec/**/*_spec.rb"
+  t.rspec_opts = "--format progress"
+end
+
+eval("$specification = begin; #{IO.read('saucy.gemspec')}; end")
+Rake::GemPackageTask.new($specification) do |package|
+  package.need_zip = true
+  package.need_tar = true
+end
+
+gem_file = "pkg/#{$specification.name}-#{$specification.version}.gem"
+
+desc "Build and install the latest gem"
+task :install => :gem do
+  sh("gem install --local #{gem_file}")
+end
+
+desc "Build and release the latest gem"
+task :release => :gem do
+  sh("gem push #{gem_file}")
+end
+

data/app/controllers/accounts_controller.rb

@@ -0,0 +1,68 @@
+class AccountsController < ApplicationController
+  before_filter :authorize, :only => [:index, :edit, :update]
+  before_filter :authorize_admin, :except => [:new, :create, :index]
+  before_filter :ensure_active_account, :only => [:edit, :update]
+  layout Saucy::Layouts.to_proc
+
+  def new
+    @plan = Plan.find(params[:plan_id])
+    @signup = Signup.new
+    Saucy::Configuration.notify("plan_viewed", :request => request,
+                                               :plan    => @plan)
+  end
+
+  def create
+    @plan = Plan.find(params[:plan_id])
+    @signup = Signup.new(params[:signup])
+    @signup.user = current_user
+    @signup.plan = @plan
+    if @signup.save
+      Saucy::Configuration.notify("account_created", :request => request,
+                                                     :account => @signup.account)
+      flash[:success] = "Account was created."
+      sign_in @signup.user
+      redirect_to new_account_project_path(@signup.account)
+    else
+      render :action => 'new'
+    end
+  end
+
+  def index
+    if current_user.projects.size == 1
+      flash.keep
+      redirect_to project_path(current_user.projects.first)
+    else
+      @accounts = current_user.accounts
+    end
+  end
+
+  def edit
+    @account = current_account
+  end
+
+  def update
+    @account = current_account
+    if @account.update_attributes(params[:account])
+      flash[:success] = 'Account was updated.'
+      redirect_to edit_profile_url
+    else
+      render :action => :edit
+    end
+  end
+
+  def destroy
+    current_account.destroy
+    flash[:success] = "Your account has been deleted."
+    redirect_to root_url
+  end
+
+  private
+
+  def current_account
+    Account.find_by_keyword!(params[:id])
+  end
+
+  def current_account?
+    params[:id].present?
+  end
+end

data/app/controllers/billings_controller.rb

@@ -0,0 +1,25 @@
+class BillingsController < ApplicationController
+  before_filter :authorize_admin, :except => [:show]
+  layout Saucy::Layouts.to_proc
+
+  def show
+  end
+
+  def edit
+    @account = current_account
+
+    @account.cardholder_name = @account.credit_card.cardholder_name
+    @account.billing_email = @account.customer.email
+    @account.expiration_month = @account.credit_card.expiration_month
+    @account.expiration_year = @account.credit_card.expiration_year
+  end
+
+  def update
+    @account = current_account
+    if @account.save_customer_and_subscription!(params[:account])
+      redirect_to account_billing_path(@account), :notice => t('.update.notice', :default => "Billing information updated successfully")
+    else
+      render :edit
+    end
+  end
+end

data/app/controllers/invitations_controller.rb

@@ -0,0 +1,65 @@
+class InvitationsController < ApplicationController
+  before_filter :authorize_admin, :except => [:show, :update]
+  before_filter :ensure_account_within_users_limit, :only => [:new, :create]
+  skip_before_filter :authorize, :only => [:show, :update]
+  layout Saucy::Layouts.to_proc
+
+  def new
+    assign_projects
+    @invitation = Invitation.new
+    render
+  end
+
+  def create
+    @invitation = Invitation.new(params[:invitation])
+    @invitation.account = current_account
+    @invitation.sender  = current_user
+    if @invitation.save
+      flash[:success] = "User invited."
+      redirect_to account_memberships_url(current_account)
+    else
+      assign_projects
+      render :action => 'new'
+    end
+  end
+
+  def show
+    with_invitation { render }
+  end
+
+  def update
+    with_invitation do
+      if @invitation.accept(params[:invitation])
+        sign_in @invitation.user
+        redirect_to root_url
+      else
+        render :action => 'show'
+      end
+    end
+  end
+
+  private
+
+  def assign_projects
+    @projects = current_account.projects_by_name
+  end
+
+  def with_invitation
+    @invitation = Invitation.find_by_code!(params[:id])
+    if @invitation.used?
+      flash[:error] = t("invitations.show.used",
+                        :default => "That invitation has already been used.")
+      redirect_to root_url
+    elsif signed_in? && current_user.email == @invitation.email
+      if @invitation.accept({:existing_user => current_user})
+        redirect_to root_url
+      end
+    else
+      yield
+    end
+  end
+
+  def ensure_account_within_users_limit
+    ensure_account_within_limit("users")
+  end
+end