workarea-api 4.4.6

data/admin/app/controllers/workarea/api/admin/discounts_controller.rb

@@ -0,0 +1,271 @@
+module Workarea
+  module Api
+    module Admin
+      class DiscountsController < Admin::ApplicationController
+        before_action :find_discount, except: [:index, :create, :bulk]
+
+        swagger_path '/discounts' do
+          operation :get do
+            key :summary, 'All Discounts'
+            key :description, 'Returns all discounts from the system'
+            key :operationId, 'listDiscounts'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :page
+              key :in, :query
+              key :description, 'Current page'
+              key :required, false
+              key :type, :integer
+              key :default, 1
+            end
+            parameter do
+              key :name, :sort_by
+              key :in, :query
+              key :description, 'Field on which to sort (see responses for possible values)'
+              key :required, false
+              key :type, :string
+              key :default, 'created_at'
+            end
+            parameter do
+              key :name, :sort_direction
+              key :in, :query
+              key :description, 'Direction for sort by'
+              key :type, :string
+              key :enum, %w(asc desc)
+              key :default, 'desc'
+            end
+
+            response 200 do
+              key :description, 'Discounts'
+              schema do
+                key :type, :object
+                property :discounts do
+                  key :type, :array
+                  items do
+                    key :'$ref', 'Workarea::Pricing::Discount'
+                  end
+                end
+              end
+            end
+          end
+
+          operation :post do
+            key :summary, 'Create Discount'
+            key :description, 'Creates a new discount.'
+            key :operationId, 'addDiscount'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :body
+              key :in, :body
+              key :description, 'Discount to add'
+              key :required, true
+              schema do
+                key :type, :object
+                property :discount do
+                  key :'$ref', 'Workarea::Pricing::Discount'
+                end
+              end
+            end
+
+            response 201 do
+              key :description, 'Discount created'
+              schema do
+                key :type, :object
+                property :discount do
+                  key :'$ref', 'Workarea::Pricing::Discount'
+                end
+              end
+            end
+
+            response 422 do
+              key :description, 'Validation failure'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :document do
+                  key :'$ref', 'Workarea::Pricing::Discount'
+                end
+              end
+            end
+          end
+        end
+
+        def index
+          @discounts = Pricing::Discount
+                          .all
+                          .order_by(sort_field => sort_direction)
+                          .page(params[:page])
+
+          respond_with discounts: @discounts
+        end
+
+        def create
+          attrs = params[:discount].presence || {}
+
+          @discount = NewDiscount.new_discount(attrs[:type], attrs.except(:type))
+          @discount.save!
+
+          respond_with(
+            { discount: @discount },
+            { status: :created,
+            location: discount_path(@discount) }
+          )
+        end
+
+        swagger_path '/discounts/{id}' do
+          operation :get do
+            key :summary, 'Find Discount by ID'
+            key :description, 'Returns a single discount'
+            key :operationId, 'showDiscount'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of discount to fetch'
+              key :required, true
+              key :type, :string
+            end
+
+            response 200 do
+              key :description, 'Discount details'
+              schema do
+                key :type, :object
+                property :discount do
+                  key :'$ref', 'Workarea::Pricing::Discount'
+                end
+              end
+            end
+
+            response 404 do
+              key :description, 'Discount not found'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :params do
+                  key :type, :object
+                  key :additionalProperties, true
+                end
+              end
+            end
+          end
+
+          operation :patch do
+            key :summary, 'Update a Discount'
+            key :description, 'Updates attributes on a discount'
+            key :operationId, 'updateDiscount'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of discount to update'
+              key :required, true
+              key :type, :string
+            end
+
+            parameter do
+              key :name, :body
+              key :in, :body
+              key :description, 'New attributes'
+              key :required, true
+              schema do
+                key :type, :object
+                property :discount do
+                  key :'$ref', 'Workarea::Pricing::Discount'
+                end
+              end
+            end
+
+            response 204 do
+              key :description, 'Discount updated successfully'
+            end
+
+            response 422 do
+              key :description, 'Validation failure'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :document do
+                  key :'$ref', 'Workarea::Pricing::Discount'
+                end
+              end
+            end
+
+            response 404 do
+              key :description, 'Discount not found'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :params do
+                  key :type, :object
+                  key :additionalProperties, true
+                end
+              end
+            end
+          end
+
+          operation :delete do
+            key :summary, 'Remove a Discount'
+            key :description, 'Remove a discount'
+            key :operationId, 'removeDiscount'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of discount to remove'
+              key :required, true
+              key :type, :string
+            end
+
+            response 204 do
+              key :description, 'Discount removed successfully'
+            end
+
+            response 404 do
+              key :description, 'Discount not found'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :params do
+                  key :type, :object
+                  key :additionalProperties, true
+                end
+              end
+            end
+          end
+        end
+
+        def show
+          respond_with discount: @discount
+        end
+
+        def update
+          @discount.update_attributes!(params[:discount])
+          respond_with discount: @discount
+        end
+
+        def destroy
+          @discount.destroy
+          head :no_content
+        end
+
+        private
+
+        def find_discount
+          @discount = Pricing::Discount.find(params[:id])
+        end
+      end
+    end
+  end
+end

data/admin/app/controllers/workarea/api/admin/email_signups_controller.rb

@@ -0,0 +1,108 @@
+module Workarea
+  module Api
+    module Admin
+      class EmailSignupsController < Admin::ApplicationController
+        swagger_path '/email_signups' do
+          operation :get do
+            key :summary, 'All Email Signups'
+            key :description, 'Returns all email signups from the system'
+            key :operationId, 'listEmailSignups'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :page
+              key :in, :query
+              key :description, 'Current page'
+              key :required, false
+              key :type, :integer
+              key :default, 1
+            end
+            parameter do
+              key :name, :sort_by
+              key :in, :query
+              key :description, 'Field on which to sort (see responses for possible values)'
+              key :required, false
+              key :type, :string
+              key :default, 'created_at'
+            end
+            parameter do
+              key :name, :sort_direction
+              key :in, :query
+              key :description, 'Direction for sort by'
+              key :type, :string
+              key :enum, %w(asc desc)
+              key :default, 'desc'
+            end
+
+            response 200 do
+              key :description, 'Email Signups'
+              schema do
+                key :type, :object
+                property :email_signups do
+                  key :type, :array
+                  items do
+                    key :'$ref', 'Workarea::Email::Signup'
+                  end
+                end
+              end
+            end
+          end
+        end
+
+        def index
+          @email_signups = Email::Signup
+                            .all
+                            .order_by(sort_field => sort_direction)
+                            .page(params[:page])
+
+          respond_with email_signups: @email_signups
+        end
+
+        swagger_path '/email_signups/{id}' do
+          operation :get do
+            key :summary, 'Find Email Signup by ID'
+            key :description, 'Returns a single email signup'
+            key :operationId, 'showEmailSignup'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of email signup to fetch'
+              key :required, true
+              key :type, :string
+            end
+
+            response 200 do
+              key :description, 'Email signup details'
+              schema do
+                key :type, :object
+                property :email_signup do
+                  key :'$ref', 'Workarea::Email::Signup'
+                end
+              end
+            end
+
+            response 404 do
+              key :description, 'Email signup not found'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :params do
+                  key :type, :object
+                  key :additionalProperties, true
+                end
+              end
+            end
+          end
+        end
+
+        def show
+          @email_signup = Email::Signup.find(params[:id])
+          respond_with email_signup: @email_signup
+        end
+      end
+    end
+  end
+end

data/admin/app/controllers/workarea/api/admin/fulfillments_controller.rb

@@ -0,0 +1,268 @@
+module Workarea
+  module Api
+    module Admin
+      class FulfillmentsController < Admin::ApplicationController
+        before_action :find_fulfillment, except: [:index, :create, :bulk]
+
+        swagger_path '/fulfillments' do
+          operation :get do
+            key :summary, 'All Fulfillments'
+            key :description, 'Returns all fulfillments from the system'
+            key :operationId, 'listFulfillments'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :page
+              key :in, :query
+              key :description, 'Current page'
+              key :required, false
+              key :type, :integer
+              key :default, 1
+            end
+            parameter do
+              key :name, :sort_by
+              key :in, :query
+              key :description, 'Field on which to sort (see responses for possible values)'
+              key :required, false
+              key :type, :string
+              key :default, 'created_at'
+            end
+            parameter do
+              key :name, :sort_direction
+              key :in, :query
+              key :description, 'Direction for sort by'
+              key :type, :string
+              key :enum, %w(asc desc)
+              key :default, 'desc'
+            end
+
+            response 200 do
+              key :description, 'Fulfillments'
+              schema do
+                key :type, :object
+                property :categories do
+                  key :type, :array
+                  items do
+                    key :'$ref', 'Workarea::Fulfillment'
+                  end
+                end
+              end
+            end
+          end
+        end
+
+        def index
+          @fulfillments = Fulfillment
+                            .all
+                            .order_by(sort_field => sort_direction)
+                            .page(params[:page])
+
+          respond_with fulfillments: @fulfillments
+        end
+
+        swagger_path '/fulfillments/{id}' do
+          operation :get do
+            key :summary, 'Find Fulfillment by ID'
+            key :description, 'Returns a single fulfillment'
+            key :operationId, 'showFulfillment'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of fulfillment to fetch'
+              key :required, true
+              key :type, :string
+            end
+
+            response 200 do
+              key :description, 'Fulfillment details'
+              schema do
+                key :'$ref', 'Workarea::Fulfillment'
+              end
+            end
+
+            response 404 do
+              key :description, 'Fulfillment not found'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :params do
+                  key :type, :object
+                  key :additionalProperties, true
+                end
+              end
+            end
+          end
+        end
+
+        def show
+          respond_with fulfillment: @fulfillment
+        end
+
+        swagger_path '/fulfillments/{id}/ship_items' do
+          operation :post do
+            key :summary, 'Mark Items as Shipped'
+            key :description, 'Marks items in a fulfillment as shipped (sent to customer)'
+            key :operationId, 'markItemsAsShipped'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of fulfillment'
+              key :required, true
+              key :type, :string
+            end
+
+            parameter do
+              key :name, :body
+              key :in, :body
+              key :required, true
+              schema do
+                key :type, :object
+                key :required, %i(tracking_number items)
+                property :tracking_number do
+                  key :type, :string
+                  key :description, 'Tracking number being shipped'
+                end
+                property :items do
+                  key :type, :array
+                  items do
+                    key :type, :object
+                    property :id do
+                      key :type, :string
+                      key :description, 'The order item ID for the item being shipped'
+                    end
+                    property :quantity do
+                      key :type, :integer
+                    end
+                  end
+                end
+              end
+            end
+
+            response 201 do
+              key :description, 'Fulfillment details'
+              schema do
+                key :type, :object
+                property :fulfillment do
+                  key :'$ref', 'Workarea::Fulfillment'
+                end
+              end
+            end
+
+            response 404 do
+              key :description, 'Fulfillment not found'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :params do
+                  key :type, :object
+                  key :additionalProperties, true
+                end
+              end
+            end
+          end
+        end
+
+        def ship_items
+          if @fulfillment.ship_items(params[:tracking_number], items)
+            respond_with(
+              { fulfillment: @fulfillment },
+              { location: fulfillment_path(@fulfillment) }
+            )
+          else
+            raise Mongoid::Errors::Validations.new(@fulfillment)
+          end
+        end
+
+        swagger_path '/fulfillments/{id}/cancel_items' do
+          operation :post do
+            key :summary, 'Mark Items as Canceled'
+            key :description, 'Marks items in a fulfillment as canceled (will not be sent to customer)'
+            key :operationId, 'markItemsAsCanceled'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of fulfillment'
+              key :required, true
+              key :type, :string
+            end
+
+            parameter do
+              key :name, :body
+              key :in, :body
+              key :required, true
+              schema do
+                key :type, :object
+                key :required, %i(items)
+                property :items do
+                  key :type, :array
+                  items do
+                    key :type, :object
+                    property :id do
+                      key :type, :string
+                      key :description, 'The order item ID for the item being canceled'
+                    end
+                    property :quantity do
+                      key :type, :integer
+                    end
+                  end
+                end
+              end
+            end
+
+            response 201 do
+              key :description, 'Fulfillment details'
+              schema do
+                key :type, :object
+                property :fulfillment do
+                  key :'$ref', 'Workarea::Fulfillment'
+                end
+              end
+            end
+
+            response 404 do
+              key :description, 'Fulfillment not found'
+              schema do
+                key :type, :object
+                property :problem do
+                  key :type, :string
+                end
+                property :params do
+                  key :type, :object
+                  key :additionalProperties, true
+                end
+              end
+            end
+          end
+        end
+
+        def cancel_items
+          if @fulfillment.cancel_items(items)
+            respond_with(
+              { fulfillment: @fulfillment },
+              { location: fulfillment_path(@fulfillment) }
+            )
+          else
+            raise Mongoid::Errors::Validations.new(@fulfillment)
+          end
+        end
+
+        private
+
+        def find_fulfillment
+          @fulfillment = Fulfillment.find(params[:id])
+        end
+
+        def items
+          Array(params[:items]).map(&:to_h)
+        end
+      end
+    end
+  end
+end