solidus_subscriptions-alpha 0.0.1

data/db/migrate/20160902221218_add_message_to_solidus_subscriptions_installment_details.rb

@@ -0,0 +1,5 @@
+class AddMessageToSolidusSubscriptionsInstallmentDetails < SolidusSupport::Migration[4.2]
+  def change
+    add_column :solidus_subscriptions_installment_details, :message, :string
+  end
+end

data/db/migrate/20160922164101_add_interval_length_and_units_to_subscription_line_items.rb

@@ -0,0 +1,8 @@
+class AddIntervalLengthAndUnitsToSubscriptionLineItems < SolidusSupport::Migration[4.2]
+  def change
+    add_column :solidus_subscriptions_line_items, :interval_units, :integer
+    add_column :solidus_subscriptions_line_items, :interval_length, :integer
+
+    remove_column :solidus_subscriptions_line_items, :interval
+  end
+end

data/db/migrate/20161006191003_add_skip_count_to_solidus_subscriptions_subscriptions.rb

@@ -0,0 +1,5 @@
+class AddSkipCountToSolidusSubscriptionsSubscriptions < SolidusSupport::Migration[4.2]
+  def change
+    add_column :solidus_subscriptions_subscriptions, :skip_count, :integer, default: 0, null: false
+  end
+end

data/db/migrate/20161006191127_add_successive_skip_count_to_solidus_subscriptions_subscriptions.rb

@@ -0,0 +1,5 @@
+class AddSuccessiveSkipCountToSolidusSubscriptionsSubscriptions < SolidusSupport::Migration[4.2]
+  def change
+    add_column :solidus_subscriptions_subscriptions, :successive_skip_count, :integer, default: 0, null: false
+  end
+end

data/db/migrate/20161014212649_allow_spree_line_item_id_to_be_null.rb

@@ -0,0 +1,5 @@
+class AllowSpreeLineItemIdToBeNull < SolidusSupport::Migration[4.2]
+  def change
+    change_column_null :solidus_subscriptions_line_items, :spree_line_item_id, true
+  end
+end

data/db/migrate/20161017155749_add_order_id_to_solidus_subscriptions_installment_details.rb

@@ -0,0 +1,6 @@
+class AddOrderIdToSolidusSubscriptionsInstallmentDetails < SolidusSupport::Migration[4.2]
+  def change
+    add_reference :solidus_subscriptions_installment_details, :order, index: true
+    add_foreign_key :solidus_subscriptions_installment_details, :spree_orders, column: :order_id
+  end
+end

data/db/migrate/20161017175509_remove_order_id_from_solidus_subscriptions_installments.rb

@@ -0,0 +1,6 @@
+class RemoveOrderIdFromSolidusSubscriptionsInstallments < SolidusSupport::Migration[4.2]
+  def change
+    remove_foreign_key :solidus_subscriptions_installments, column: :order_id
+    remove_column :solidus_subscriptions_installments, :order_id, :integer
+  end
+end

data/db/migrate/20161017201944_add_subscription_order_to_spree_orders.rb

@@ -0,0 +1,5 @@
+class AddSubscriptionOrderToSpreeOrders < SolidusSupport::Migration[4.2]
+  def change
+    add_column :spree_orders, :subscription_order, :boolean, default: false, null: false
+  end
+end

data/db/migrate/20161221155142_add_store_to_solidus_subscriptions_subscriptions.rb

@@ -0,0 +1,6 @@
+class AddStoreToSolidusSubscriptionsSubscriptions < SolidusSupport::Migration[4.2]
+  def change
+    add_reference :solidus_subscriptions_subscriptions, :store, index: true
+    add_foreign_key :solidus_subscriptions_subscriptions, :spree_stores, column: :store_id
+  end
+end

data/db/migrate/20161223152905_add_address_id_to_solidus_subscriptions_subscriptions.rb

@@ -0,0 +1,7 @@
+class AddAddressIdToSolidusSubscriptionsSubscriptions < SolidusSupport::Migration[4.2]
+  def change
+    add_reference :solidus_subscriptions_subscriptions, :shipping_address
+    add_index :solidus_subscriptions_subscriptions, :shipping_address_id, name: :index_subscription_shipping_address_id
+    add_foreign_key :solidus_subscriptions_subscriptions, :spree_addresses, column: :shipping_address_id
+  end
+end

data/db/migrate/20170106224713_change_line_item_max_installments_to_end_date.rb

@@ -0,0 +1,6 @@
+class ChangeLineItemMaxInstallmentsToEndDate < SolidusSupport::Migration[4.2]
+  def change
+    remove_column :solidus_subscriptions_line_items, :max_installments
+    add_column :solidus_subscriptions_line_items, :end_date, :date
+  end
+end

data/db/migrate/20170111224458_change_subscription_actionable_date_to_datetime.rb

@@ -0,0 +1,5 @@
+class ChangeSubscriptionActionableDateToDatetime < SolidusSupport::Migration[4.2]
+  def change
+    change_column :solidus_subscriptions_subscriptions, :actionable_date, :datetime
+  end
+end

data/db/migrate/20170111232801_change_inteval_actionable_date_to_datetime.rb

@@ -0,0 +1,5 @@
+class ChangeIntevalActionableDateToDatetime < SolidusSupport::Migration[4.2]
+  def change
+    change_column :solidus_subscriptions_installments, :actionable_date, :datetime
+  end
+end

data/db/migrate/20170112012407_add_config_options_to_subscriptions.rb

@@ -0,0 +1,7 @@
+class AddConfigOptionsToSubscriptions < SolidusSupport::Migration[4.2]
+  def change
+    add_column :solidus_subscriptions_subscriptions, :interval_length, :integer
+    add_column :solidus_subscriptions_subscriptions, :interval_units, :integer
+    add_column :solidus_subscriptions_subscriptions, :end_date, :datetime
+  end
+end

data/lib/generators/solidus_subscriptions/install/install_generator.rb

@@ -0,0 +1,30 @@
+module SolidusSubscriptions
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      class_option :auto_run_migrations, type: :boolean, default: false
+
+      def add_javascripts
+        append_file 'vendor/assets/javascripts/spree/frontend/all.js', "//= require spree/frontend/solidus_subscriptions\n"
+        append_file 'vendor/assets/javascripts/spree/backend/all.js', "//= require spree/backend/solidus_subscriptions\n"
+      end
+
+      def add_stylesheets
+        inject_into_file 'vendor/assets/stylesheets/spree/frontend/all.css', " *= require spree/frontend/solidus_subscriptions\n", before: /\*\//, verbose: true
+        inject_into_file 'vendor/assets/stylesheets/spree/backend/all.css', " *= require spree/backend/solidus_subscriptions\n", before: /\*\//, verbose: true
+      end
+
+      def add_migrations
+        run 'bundle exec rake railties:install:migrations FROM=solidus_subscriptions'
+      end
+
+      def run_migrations
+        run_migrations = options[:auto_run_migrations] || ['', 'y', 'Y'].include?(ask('Would you like to run the migrations now? [Y/n]'))
+        if run_migrations
+          run 'bundle exec rake db:migrate'
+        else
+          puts 'Skipping rake db:migrate, don\'t forget to run it!'
+        end
+      end
+    end
+  end
+end

data/lib/solidus_subscriptions.rb

@@ -0,0 +1,6 @@
+require 'solidus'
+require 'solidus_support'
+require "solidus_subscriptions/ability"
+require 'solidus_subscriptions/engine'
+require 'deface'
+require 'state_machines'

data/lib/solidus_subscriptions/ability.rb

@@ -0,0 +1,19 @@
+module SolidusSubscriptions
+  class Ability
+    include CanCan::Ability
+
+    def initialize(user)
+      alias_action :create, :read, :update, :destroy, to: :crud
+
+      if user.has_spree_role?('admin')
+        can(:manage, LineItem)
+        can(:manage, Subscription)
+      else
+        can([:crud, :skip, :cancel], Subscription, user_id: user.id)
+        can(:crud, LineItem) do |li, order|
+          li.order.user == user || li.order == order
+        end
+      end
+    end
+  end
+end

data/lib/solidus_subscriptions/config.rb

@@ -0,0 +1,97 @@
+module SolidusSubscriptions
+  module Config
+    class << self
+      # Processing Event handlers
+      # These handlers are pluggable, however it is highly encouraged that you
+      # subclass from the the dispatcher you are replacing, and call super
+      # from within the #dispatch method (if you override it)
+      #
+      # This handler is called when a susbcription order is successfully placed.
+      attr_writer :success_dispatcher_class
+      def success_dispatcher_class
+        @success_dispatcher_class ||= ::SolidusSubscriptions::SuccessDispatcher
+      end
+
+      # This handler is called when an order cant be placed for a group of
+      # installments
+      attr_writer :failure_dispatcher_class
+      def failure_dispatcher_class
+        @failure_dispatcher_class ||= ::SolidusSubscriptions::FailureDispatcher
+      end
+
+      # This handler is called when a payment fails on a subscription order
+      attr_writer :payment_failed_dispatcher_class
+      def payment_failed_dispatcher_class
+        @payment_failed_dispatcher_class ||= ::SolidusSubscriptions::PaymentFailedDispatcher
+      end
+
+      # This handler is called when installemnts cannot be fulfilled due to lack
+      # of stock
+      attr_writer :out_of_stock_dispatcher
+      def out_of_stock_dispatcher_class
+        @out_of_stock_dispatcher_class ||= ::SolidusSubscriptions::OutOfStockDispatcher
+      end
+
+      def default_gateway(&block)
+        return @gateway.call unless block_given?
+        @gateway = block
+      end
+    end
+
+    # Maximum number of times a user can skip their subscription before it
+    # must be processed
+    mattr_accessor(:maximum_successive_skips) { 1 }
+
+    # Limit on the number of times a user can skip thier subscription. Once
+    # this limit is reached, no skips are permitted
+    mattr_accessor(:maximum_total_skips) { nil }
+
+    # Time between an installment failing to be processed and the system
+    # retrying to fulfil it
+    mattr_accessor(:reprocessing_interval) { 1.day }
+
+    mattr_accessor(:minimum_cancellation_notice) { 1.day }
+
+    # Which queue is responsible for processing subscriptions
+    mattr_accessor(:processing_queue) { :default }
+
+    # SolidusSubscriptions::LineItem attributes which are allowed to
+    # be updated from user data
+    #
+    # This is useful in the case where certain fields should not be allowed to
+    # be modified by the user. This locks these attributes from being passed
+    # in to the orders controller (or the api controller).
+
+    # Ie. if a store does not want to allow users to configure the end date of
+    # a subscription. Add this to an initializer:
+
+    # ```
+    # SolidusSubscriptions::Config.subscription_line_item_attributes = [
+    #   :quantity,
+    #   :interval_length,
+    #   :interval_units,
+    #   :subscribable_id
+    # ]
+    # ```
+    # This configuration also easily allows the gem to be customized to track
+    # more information on the subcriptions line items.
+    mattr_accessor(:subscription_line_item_attributes) do
+      [
+        :quantity,
+        :subscribable_id,
+        :interval_length,
+        :interval_units,
+        :end_date
+      ]
+    end
+
+    # SolidusSubscriptions::Subscription attributes which are allowed to
+    # be updated from user data
+    mattr_accessor(:subscription_attributes) do
+      [
+        :actionable_date,
+        shipping_address_attributes: Spree::PermittedAttributes.address_attributes
+      ]
+    end
+  end
+end

data/lib/solidus_subscriptions/engine.rb

@@ -0,0 +1,56 @@
+module SolidusSubscriptions
+  class Engine < Rails::Engine
+    require 'spree/core'
+    require 'solidus_subscriptions/permitted_attributes'
+    require 'solidus_subscriptions/config'
+    require 'solidus_subscriptions/processor'
+
+    isolate_namespace SolidusSubscriptions
+    engine_name 'solidus_subscriptions'
+
+    # use rspec for tests
+    config.generators do |g|
+      g.test_framework :rspec
+    end
+
+    config.autoload_paths << config.root.join('app', 'jobs')
+
+    initializer 'configure spree subcription permitted attributes', after: 'require subscription lib helpers' do
+      PermittedAttributes.update_spree_permiteed_attributes
+    end
+
+    initializer 'solidus_subscriptions.configs', before: "require subscription lib helpers" do
+    end
+
+    initializer 'register_subscription_promotion_rule', after: 'spree.promo.register.promotion.rules' do |app|
+      app.config.spree.promotions.rules << 'SolidusSubscriptions::SubscriptionPromotionRule'
+      app.config.spree.promotions.rules << 'SolidusSubscriptions::SubscriptionOrderPromotionRule'
+    end
+
+    initializer 'subscriptions_backend' do
+      next unless Spree::Backend::Config.respond_to?(:menu_items)
+      Spree::Backend::Config.configure do |config|
+        config.menu_items << config.class::MenuItem.new(
+          [:subscriptions],
+          'repeat',
+          url: :admin_subscriptions_path,
+          condition: ->{ can?(:admin, SolidusSubscriptions::Subscription) }
+        )
+      end
+    end
+
+    def self.activate
+      Dir.glob(File.join(File.dirname(__FILE__), '../../app/decorators/**/*.rb')) do |c|
+        Rails.configuration.cache_classes ? require(c) : load(c)
+      end
+
+      Spree::Ability.register_ability(SolidusSubscriptions::Ability)
+    end
+
+    config.to_prepare(&method(:activate).to_proc)
+  end
+
+  def self.table_name_prefix
+    'solidus_subscriptions_'
+  end
+end

data/lib/solidus_subscriptions/permitted_attributes.rb

@@ -0,0 +1,36 @@
+# This module is responsible for managing what attributes can be updated
+# through the api. It also overrides Spree::Permitted attributes to allow the
+# solidus api to accept nested params for subscription models as well
+module SolidusSubscriptions
+  module PermittedAttributes
+    class << self
+      def update_spree_permiteed_attributes
+        Spree::PermittedAttributes.line_item_attributes << {
+          subscription_line_items_attributes: nested(
+            subscription_line_item_attributes
+          )
+        }
+
+        Spree::PermittedAttributes.user_attributes << {
+          subscriptions_attributes: nested(subscription_attributes)
+        }
+      end
+
+      def subscription_line_item_attributes
+        [Config.subscription_line_item_attributes]
+      end
+
+      def subscription_attributes
+        Config.subscription_attributes | [
+          { line_items_attributes: nested(subscription_line_item_attributes) - [:subscribable_id] }
+        ]
+      end
+
+      private
+
+      def nested(attributes)
+        attributes | [:id]
+      end
+    end
+  end
+end

data/lib/solidus_subscriptions/processor.rb

@@ -0,0 +1,108 @@
+# This class is responsible for finding subscriptions and installments
+# which need to be processed. It will group them together by user and attempts
+# to process them together. Subscriptions will also be grouped by their
+# shiping address id.
+#
+# This class passes the reponsibility of actually creating the order off onto
+# the consolidated installment class.
+#
+# This class generates `ProcessInstallmentsJob`s
+module SolidusSubscriptions
+  class Processor
+    class << self
+      # Find all actionable subscriptions and intallments, group them together
+      # by user, and schedule a processing job for the group as a batch
+      def run
+        batched_users_to_be_processed.each { |batch| new(batch).build_jobs }
+      end
+
+      private
+
+      def batched_users_to_be_processed
+        subscriptions = SolidusSubscriptions::Subscription.arel_table
+        installments = SolidusSubscriptions::Installment.arel_table
+
+        Spree::User.
+          joins(:subscriptions).
+          joins(
+            subscriptions.
+              join(installments, Arel::Nodes::OuterJoin).
+              on(subscriptions[:id].eq(installments[:subscription_id])).
+              join_sources
+          ).
+          where(
+            SolidusSubscriptions::Subscription.actionable.arel.constraints.reduce(:and).
+              or(SolidusSubscriptions::Installment.actionable.arel.constraints.reduce(:and))
+          ).
+          distinct.
+          find_in_batches
+      end
+    end
+
+    # @return [Array<Spree.user_class>]
+    attr_reader :users
+
+    # Get a new instance of the SolidusSubscriptions::Processor
+    #
+    # @param users [Array<Spree.user_class>] A list of users with actionable
+    #   subscriptions or installments
+    #
+    # @return [SolidusSubscriptions::Processor]
+    def initialize(users)
+      @users = users
+      @installments = {}
+    end
+
+    # Create `ProcessInstallmentsJob`s for the users used to initalize the
+    # instance
+    def build_jobs
+      users.map do |user|
+        installemts_by_address_and_user = installments(user).group_by do |i|
+          i.subscription.shipping_address_id
+        end
+
+        installemts_by_address_and_user.values.each do |grouped_installments|
+          ProcessInstallmentsJob.perform_later grouped_installments.map(&:id)
+        end
+      end
+    end
+
+    private
+
+    def subscriptions_by_id
+      @subscriptions_by_id ||= Subscription.
+        actionable.
+        includes(:line_items, :user).
+        where(user_id: user_ids).
+        group_by(&:user_id)
+    end
+
+    def retry_installments
+      @failed_installments ||= Installment.
+        actionable.
+        includes(:subscription).
+        where(solidus_subscriptions_subscriptions: { user_id: user_ids }).
+        group_by { |i| i.subscription.user_id }
+    end
+
+    def installments(user)
+      @installments[user.id] ||= retry_installments.fetch(user.id, []) + new_installments(user)
+    end
+
+    def new_installments(user)
+      ActiveRecord::Base.transaction do
+        subscriptions_by_id.fetch(user.id, []).map do |sub|
+          sub.successive_skip_count = 0
+          sub.advance_actionable_date
+          sub.cancel! if sub.pending_cancellation?
+          sub.deactivate! if sub.can_be_deactivated?
+          sub.installments.create!
+        end
+      end
+    end
+
+    def user_ids
+      @user_ids ||= users.map(&:id)
+    end
+  end
+end