workarea-api-admin 4.4.6

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

@@ -0,0 +1,232 @@
+module Workarea
+  module Api
+    module Admin
+      class CategoryProductRulesController < Admin::ApplicationController
+        before_action :find_category
+        before_action :find_product_rule, except: [:index, :create]
+
+        swagger_path '/categories/{id}/product_rules' do
+          operation :get do
+            key :summary, 'All Category Product Rules'
+            key :description, 'Returns all product rules for a category'
+            key :operationId, 'listCategoryProductRules'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'category ID'
+              key :required, true
+              key :type, :string
+            end
+
+            response 200 do
+              key :description, 'Category product rules'
+              schema do
+                key :type, :object
+                property :product_rules do
+                  key :type, :array
+                  items do
+                    key :'$ref', 'Workarea::ProductRule'
+                  end
+                end
+              end
+            end
+          end
+
+          operation :post do
+            key :summary, 'Create Category Product Rule'
+            key :description, 'Creates a new category product rule.'
+            key :operationId, 'addCategoryProductRule'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'category ID'
+              key :required, true
+              key :type, :string
+            end
+
+            parameter do
+              key :name, :body
+              key :in, :body
+              key :description, 'Rule to add'
+              key :required, true
+              schema do
+                key :type, :object
+                property :product_rule do
+                  key :'$ref', 'Workarea::ProductRule'
+                end
+              end
+            end
+
+            response 201 do
+              key :description, 'Product rule created'
+              schema do
+                key :type, :object
+                property :product_rule do
+                  key :'$ref', 'Workarea::ProductRule'
+                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::ProductRule'
+                end
+              end
+            end
+          end
+        end
+
+        def index
+          respond_with product_rules: @category.product_rules
+        end
+
+        def create
+          @product_rule = @category.product_rules.create!(params[:product_rule])
+          respond_with(
+            { product_rule: @product_rule },
+            { status: :created,
+            location: category_product_rules_path(@category.id) }
+          )
+        end
+
+        swagger_path '/categories/{category_id}/product_rules/{id}' do
+          operation :patch do
+            key :summary, 'Update a category product rule'
+            key :description, 'Updates attributes on a category product rule'
+            key :operationId, 'updateCategoryProductRule'
+
+            parameter do
+              key :name, :category_id
+              key :in, :path
+              key :description, 'ID of category'
+              key :required, true
+              key :type, :string
+            end
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of category product rule 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 :product_rule do
+                  key :'$ref', 'Workarea::ProductRule'
+                end
+              end
+            end
+
+            response 204 do
+              key :description, 'Category product rule 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::ProductRule'
+                end
+              end
+            end
+
+            response 404 do
+              key :description, 'Category or product rule 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 Category Product Rule'
+            key :description, 'Remove a category product rule'
+            key :operationId, 'removeCategoryProductRule'
+
+            parameter do
+              key :name, :category_id
+              key :in, :path
+              key :description, 'ID of category'
+              key :required, true
+              key :type, :string
+            end
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of category product rule to remove'
+              key :required, true
+              key :type, :string
+            end
+
+            response 204 do
+              key :description, 'Category product rule removed successfully'
+            end
+
+            response 404 do
+              key :description, 'Category or product rule 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 update
+          @product_rule.update_attributes!(params[:product_rule])
+          respond_with product_rule: @product_rule
+        end
+
+        def destroy
+          @product_rule.destroy
+          head :no_content
+        end
+
+        private
+
+        def find_category
+          @category = Catalog::Category.find(params[:category_id])
+        end
+
+        def find_product_rule
+          @product_rule = @category.product_rules.find(params[:id])
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,299 @@
+module Workarea
+  module Api
+    module Admin
+      class ContentAssetsController < Admin::ApplicationController
+        before_action :find_asset, except: [:index, :create, :bulk]
+
+        swagger_path '/content_assets' do
+          operation :get do
+            key :summary, 'All Content Assets'
+            key :description, 'Returns all content assets from the system'
+            key :operationId, 'listContentAssets'
+            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, 'Content assets'
+              schema do
+                key :type, :object
+                property :assets do
+                  key :type, :array
+                  items do
+                    key :'$ref', 'Workarea::Content::Asset'
+                  end
+                end
+              end
+            end
+          end
+
+          operation :post do
+            key :summary, 'Create Content Asset'
+            key :description, 'Creates a new content asset.'
+            key :operationId, 'addContentAsset'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :body
+              key :in, :body
+              key :description, 'Content asset to add'
+              key :required, true
+              schema do
+                key :type, :object
+                property :asset do
+                  key :'$ref', 'Workarea::Content::Asset'
+                end
+              end
+            end
+
+            response 201 do
+              key :description, 'Content asset created'
+              schema do
+                key :type, :object
+                property :asset do
+                  key :'$ref', 'Workarea::Content::Asset'
+                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::Content::Asset'
+                end
+              end
+            end
+          end
+        end
+
+        def index
+          @assets = Content::Asset
+                      .all
+                      .order_by(sort_field => sort_direction)
+                      .page(params[:page])
+
+          respond_with assets: @assets
+        end
+
+        def create
+          @asset = Content::Asset.create!(params[:asset])
+          respond_with(
+            { asset: @asset },
+            { status: :created,
+            location: content_asset_path(@asset) }
+          )
+        end
+
+        swagger_path '/content_assets/{id}' do
+          operation :get do
+            key :summary, 'Find Content Asset by ID'
+            key :description, 'Returns a single content asset'
+            key :operationId, 'showContentAsset'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of content asset to fetch'
+              key :required, true
+              key :type, :string
+            end
+
+            response 200 do
+              key :description, 'Content asset details'
+              schema do
+                key :'$ref', 'Workarea::Content::Asset'
+              end
+            end
+
+            response 404 do
+              key :description, 'Content asset 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 Content Asset'
+            key :description, 'Updates attributes on a content asset'
+            key :operationId, 'updateContentAsset'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of content asset 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 :asset do
+                  key :'$ref', 'Workarea::Content::Asset'
+                end
+              end
+            end
+
+            response 204 do
+              key :description, 'Content asset 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::Content::Asset'
+                end
+              end
+            end
+
+            response 404 do
+              key :description, 'Content asset 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 Content Asset'
+            key :description, 'Remove a content asset'
+            key :operationId, 'removeContentAsset'
+
+            parameter do
+              key :name, :id
+              key :in, :path
+              key :description, 'ID of content asset to remove'
+              key :required, true
+              key :type, :string
+            end
+
+            response 204 do
+              key :description, 'Content asset removed successfully'
+            end
+
+            response 404 do
+              key :description, 'Content asset 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 asset: @asset
+        end
+
+        def update
+          @asset.update_attributes!(params[:asset])
+          respond_with asset: @asset
+        end
+
+        swagger_path '/content_assets/bulk' do
+          operation :patch do
+            key :summary, 'Bulk Upsert Content Assets'
+            key :description, 'Creates new content assets or updates existing ones in bulk.'
+            key :operationId, 'upsertContentAssets'
+            key :produces, ['application/json']
+
+            parameter do
+              key :name, :body
+              key :in, :body
+              key :description, 'Array of content assets to upsert'
+              key :required, true
+              schema do
+                key :type, :array
+                items do
+                  key :'$ref', 'Workarea::Content::Asset'
+                end
+              end
+            end
+
+            response 204 do
+              key :description, 'Upsert received'
+            end
+          end
+        end
+
+        def bulk
+          @bulk = Api::Admin::BulkUpsert.create!(
+            klass: Content::Asset,
+            data: params[:assets].map(&:to_h)
+          )
+
+          head :no_content
+        end
+
+        def destroy
+          @asset.destroy
+          head :no_content
+        end
+
+        private
+
+        def find_asset
+          @asset = Content::Asset.find(params[:id])
+        end
+      end
+    end
+  end
+end