rating 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 48063ae9a3d3e0ac0573471477dddae7834219fd
-  data.tar.gz: 20df48c7bb6af87d89ceddb6a5c2b029b7c751fe
+  metadata.gz: c384b931b0e023652ca3ae1025de72e2371f5c21
+  data.tar.gz: 01cefd2f71309f2a9a1dc09f01f058cc00322619
 SHA512:
-  metadata.gz: 2a4ed2ace00a53bc4076942fad4fa3c6fb402c24867ab4b80ea550d27b6b4874464bc2a7a68d8f009a3ef4afc42e1c79286906958a986f20d14eca3327490d31
-  data.tar.gz: '09c238d2ceed932e4f40a8304d3bfa5bc5ad276082a91be4c0e4f2b3addd89f1ed45ee188f976d811fc3dcdcd1a2e33c129e08d06ee7f6c2f7fd3c513ed3a031'
+  metadata.gz: 98af2a274b9fc2cca342546016ba431d58e718463ac773ec02f99bdb7830634e08a8fd8cadffba68ac3e047eba14407c29787dd913192b730b3d98a4b2bffd50
+  data.tar.gz: 4f8a8ae57dc1e14719739b3defbf850abb606c4d37d36d71922b11d91776ccd65866c9f2f17819ba5b9d046f91551ef70e216b9e28fd8b1fdd0cc437af36e12d

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+## v0.7.0
+
+### News
+
+- Support to configure `uniqueness` validation via YAML into Rating::Rate model;
+- Support to multiple scopes via `extra_scopes` option.
+
+### Updates
+
+- Reverts v0.6.0, since we need this validation because we cannot edit the Rate model by ourself.
+
 ## v0.6.0
 
 ### Updates

data/README.md

@@ -248,6 +248,28 @@ To order the rating you do the same thing:
 Article.order_by_rating scope: category_1
 ```
 
+### Extra Scopes
+
+Maybe you need to use more than one scope to make a rate, so you can use the `extra_scopes` options.
+This feature is enable **only** to restrict the rate, the rating calculation will **ignore** it.
+
+Example situation: I have a Profile (resource) that belongs to some Category (scope) and the Client (author) will rate
+this Profile based on each Lead (extra scope) this Profile made. The Client can vote just one time on each lead, but many
+times to that Profile. The Profile has a rating score based on all leads made on that Category.
+
+```ruby
+scope    = Category.first
+author   = Client.last
+resource = Profile.last
+lead     = Lead.last
+
+author.rate resource, 5, extra_scopes: { lead_id: lead.id }, scope: scope
+```
+
+* The extra scopes fields is not present into gem, so you cannot use `{ lead: lead }`, for example.
+
+All methods listed on [Scope](#scope) session allows `extra_scopes` as additional condition too.
+
 ### Records
 
 Maybe you want to recover all records with or without scope, so you can add the suffix `_records` on relations:
@@ -340,24 +362,34 @@ You should just to provide a `config/rating.yml` file with the following content
 
 ```yml
 rating:
-  rate_table: 'reviews'
-  rating_table: 'review_ratings'
+  rate_table: reviews
+  rating_table: review_ratings
 ```
 
 Now the rates will be written on `reviews` table over `rating_rates` and calculation will be on `review_ratings` over `rating_ratings`.
 You can change one table o both of them.
 
+### Validations
 
-## Validation
+#### Rate Uniqueness
 
-It is recommended that you add a validation to ensure that the author do not vote multiple times on the same resource and its scope.
-This validation is not inside the gem since you could want make your own custom validation.
+Since you can to use [Extra Scopes](#extra_scopes) to restrict rates and the original model `Rating::Rate` is inside gem, you can configure the uniqueness validation, from outside, to include this extra scopes.
 
-```ruby
-validates :author_id, uniqueness: {
-  case_sensitive: false,
-  scope:          %i[author_type resource_id resource_type scopeable_id scopeable_type]
-}
+```yml
+rating:
+  validations:
+    rate:
+      uniqueness:
+        case_sensitive: false
+
+        scope:
+          - author_type
+          - resource_id
+          - resource_type
+          - scopeable_id
+          - scopeable_type
+          - scope_1
+          - scope_2
 ```
 
 ## Love it!

data/lib/rating/config.rb

@@ -21,5 +21,18 @@ module Rating
     def rating_table
       @rating_table ||= config[__method__.to_s] || 'rating_ratings'
     end
+
+    def validations
+      @validations ||= begin
+        default_scope = %w[author_type resource_id resource_type scopeable_id scopeable_type]
+
+        {
+          rate: {
+            case_sensitive: config.dig('validations', 'rate', 'case_sensitive') || false,
+            scope:          config.dig('validations', 'rate', 'scope') || default_scope
+          }
+        }.deep_stringify_keys
+      end
+    end
   end
 end

data/lib/rating/models/rating/extension.rb

@@ -5,24 +5,36 @@ module Rating
     extend ActiveSupport::Concern
 
     included do
-      def rate(resource, value, author: self, metadata: {}, scope: nil)
-        Rate.create author: author, metadata: metadata, resource: resource, scopeable: scope, value: value
+      def rate(resource, value, author: self, extra_scopes: {}, metadata: {}, scope: nil)
+        Rate.create(
+          author:       author,
+          extra_scopes: extra_scopes,
+          metadata:     metadata,
+          resource:     resource,
+          scopeable:    scope,
+          value:        value
+        )
       end
 
-      def rate_for(resource, scope: nil)
-        Rate.rate_for author: self, resource: resource, scopeable: scope
+      def rate_for(resource, extra_scopes: {}, scope: nil)
+        Rate.rate_for author: self, extra_scopes: extra_scopes, resource: resource, scopeable: scope
       end
 
-      def rated?(resource, scope: nil)
-        !rate_for(resource, scope: scope).nil?
+      # TODO: use exists for performance
+      def rated?(resource, extra_scopes: {}, scope: nil)
+        !rate_for(resource, extra_scopes: extra_scopes, scope: scope).nil?
       end
 
-      def rates(scope: nil)
-        rates_records.where scopeable: scope
+      def rates(extra_scopes: {}, scope: nil)
+        attributes = { scopeable: scope }.merge(extra_scopes)
+
+        rates_records.where attributes
       end
 
-      def rated(scope: nil)
-        rated_records.where scopeable: scope
+      def rated(extra_scopes: {}, scope: nil)
+        attributes = { scopeable: scope }.merge(extra_scopes)
+
+        rated_records.where attributes
       end
 
       def rating(scope: nil)
@@ -62,13 +74,8 @@ module Rating
           dependent:  :destroy
 
         scope :order_by_rating, ->(column = :estimate, direction = :desc, scope: nil) {
-          scope_values = {
-            scopeable_id:   scope&.id,
-            scopeable_type: scope&.class&.base_class&.name
-          }
-
           includes(:rating_records)
-            .where(Rating.table_name => scope_values)
+            .where(Rating.table_name => { scopeable_id: scope&.id, scopeable_type: scope&.class&.base_class&.name })
             .order("#{Rating.table_name}.#{column} #{direction}")
         }
       end

data/lib/rating/models/rating/rate.rb

@@ -14,8 +14,14 @@ module Rating
     validates :author, :resource, :value, presence: true
     validates :value, numericality: { greater_than_or_equal_to: 1, less_than_or_equal_to: 100 }
 
-    def self.create(author:, metadata:, resource:, scopeable: nil, value:)
-      record = find_or_initialize_by(author: author, resource: resource, scopeable: scopeable)
+    validates :author_id, uniqueness: {
+      case_sensitive: ::Rating::Config.validations['rate']['case_sensitive'],
+      scope:          ::Rating::Config.validations['rate']['scope'].map(&:to_sym)
+    }
+
+    def self.create(author:, extra_scopes:, metadata:, resource:, scopeable: nil, value:)
+      attributes = { author: author, resource: resource, scopeable: scopeable }.merge(extra_scopes)
+      record     = find_or_initialize_by(attributes)
 
       return record if record.persisted? && value == record.value
 
@@ -27,8 +33,10 @@ module Rating
       record
     end
 
-    def self.rate_for(author:, resource:, scopeable: nil)
-      find_by author: author, resource: resource, scopeable: scopeable
+    def self.rate_for(author:, extra_scopes: {}, resource:, scopeable: nil)
+      attributes = { author: author, resource: resource, scopeable: scopeable }.merge(extra_scopes)
+
+      find_by attributes
     end
 
     private

data/lib/rating/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rating
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

data/spec/config/validations_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+RSpec.describe Rating::Config, '.validations' do
+  context 'when rating.yml does not exist' do
+    it do
+      expect(subject.validations).to eq({
+        rate: {
+          case_sensitive: false,
+          scope:          %w[author_type resource_id resource_type scopeable_id scopeable_type]
+        }
+      }.deep_stringify_keys)
+    end
+  end if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] != 'true'
+
+  context 'when rating.yml exists' do
+    it do
+      expect(subject.validations).to eq({
+        rate: {
+          case_sensitive: false,
+          scope:          %w[author_type resource_id resource_type scopeable_id scopeable_type scope_1 scope_2]
+        }
+      }.deep_stringify_keys)
+    end
+  end if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] == 'true'
+end

data/spec/models/extension/rate_for_spec.rb

@@ -8,7 +8,7 @@ RSpec.describe Rating::Extension, ':rate_for' do
 
   context 'with no scopeable' do
     it 'delegates to rate object' do
-      expect(Rating::Rate).to receive(:rate_for).with author: author, resource: article, scopeable: nil
+      expect(Rating::Rate).to receive(:rate_for).with author: author, extra_scopes: {}, resource: article, scopeable: nil
 
       author.rate_for article
     end
@@ -18,9 +18,24 @@ RSpec.describe Rating::Extension, ':rate_for' do
     let!(:category) { build :category }
 
     it 'delegates to rate object' do
-      expect(Rating::Rate).to receive(:rate_for).with author: author, resource: article, scopeable: category
+      expect(Rating::Rate).to receive(:rate_for).with author: author, extra_scopes: {}, resource: article, scopeable: category
 
       author.rate_for article, scope: category
     end
   end
+
+  context 'with extra_scopes' do
+    let!(:category) { build :category }
+
+    it 'delegates to rate object' do
+      expect(Rating::Rate).to receive(:rate_for).with(
+        author:       author,
+        extra_scopes: { scope_1: 'scope_1' },
+        resource:     article,
+        scopeable:    category
+      )
+
+      author.rate_for article, extra_scopes: { scope_1: 'scope_1' }, scope: category
+    end
+  end
 end

data/spec/models/extension/rate_spec.rb

@@ -9,7 +9,7 @@ RSpec.describe Rating::Extension, ':rate' do
   context 'with no scopeable' do
     it 'delegates to rate object' do
       expect(Rating::Rate).to receive(:create).with(
-        author: author, metadata: {}, resource: article, scopeable: nil, value: 3
+        author: author, extra_scopes: {}, metadata: {}, resource: article, scopeable: nil, value: 3
       )
 
       author.rate article, 3
@@ -21,7 +21,7 @@ RSpec.describe Rating::Extension, ':rate' do
 
     it 'delegates to rate object' do
       expect(Rating::Rate).to receive(:create).with(
-        author: author, metadata: {}, resource: article, scopeable: category, value: 3
+        author: author, extra_scopes: {}, metadata: {}, resource: article, scopeable: category, value: 3
       )
 
       author.rate article, 3, scope: category
@@ -31,7 +31,7 @@ RSpec.describe Rating::Extension, ':rate' do
   context 'with no metadata' do
     it 'delegates an empty hash to rate object' do
       expect(Rating::Rate).to receive(:create).with(
-        author: author, resource: article, metadata: {}, scopeable: nil, value: 3
+        author: author, extra_scopes: {}, resource: article, metadata: {}, scopeable: nil, value: 3
       )
 
       author.rate article, 3
@@ -39,14 +39,22 @@ RSpec.describe Rating::Extension, ':rate' do
   end
 
   context 'with metadata' do
-    let!(:category) { build :category }
-
     it 'delegates to rate object' do
       expect(Rating::Rate).to receive(:create).with(
-        author: author, metadata: { comment: 'comment' }, resource: article, scopeable: nil, value: 3
+        author: author, extra_scopes: {}, metadata: { comment: 'comment' }, resource: article, scopeable: nil, value: 3
       )
 
       author.rate article, 3, metadata: { comment: 'comment' }
     end
   end
+
+  context 'with extra_scopes' do
+    it 'delegates to rate object' do
+      expect(Rating::Rate).to receive(:create).with(
+        author: author, extra_scopes: { scope_1: 'scope_1' }, metadata: { comment: 'comment' }, resource: article, scopeable: nil, value: 3
+      )
+
+      author.rate article, 3, extra_scopes: { scope_1: 'scope_1' }, metadata: { comment: 'comment' }
+    end
+  end
 end

data/spec/models/extension/rated_question_spec.rb

@@ -3,36 +3,44 @@
 require 'rails_helper'
 
 RSpec.describe Rating::Extension, ':rated?' do
-  let!(:author)  { create :author }
-  let!(:article) { create :article }
+  let!(:author)   { create :author }
+  let!(:resource) { create :article }
 
   context 'with no scopeable' do
-    context 'when has no rate for the given resource' do
-      before { allow(author).to receive(:rate_for).with(article, scope: nil).and_return nil }
+    before { author.rate resource, 1 }
 
-      specify { expect(author.rated?(article)).to eq false }
+    context 'when has no rate for the given resource' do
+      specify { expect(author.rated?(create(:article))).to eq false }
     end
 
     context 'when has rate for the given resource' do
-      before { allow(author).to receive(:rate_for).with(article, scope: nil).and_return double }
-
-      specify { expect(author.rated?(article)).to eq true }
+      specify { expect(author.rated?(resource)).to eq true }
     end
   end
 
   context 'with scopeable' do
-    let!(:category) { build :category }
+    let!(:category) { create :category }
 
-    context 'when has no rate for the given resource' do
-      before { allow(author).to receive(:rate_for).with(article, scope: category).and_return nil }
+    before { author.rate resource, 1, scope: category }
 
-      specify { expect(author.rated?(article, scope: category)).to eq false }
+    context 'when has no rate for the given resource' do
+      specify { expect(author.rated?(resource, scope: create(:category))).to eq false }
     end
 
     context 'when has rate for the given resource' do
-      before { allow(author).to receive(:rate_for).with(article, scope: category).and_return double }
-
-      specify { expect(author.rated?(article, scope: category)).to eq true }
+      specify { expect(author.rated?(resource, scope: category)).to eq true }
     end
   end
+
+  context 'with extra scopes' do
+    before { author.rate resource, 1, extra_scopes: { scope_1: 'scope_1' } }
+
+    context 'when has no rate for the given resource with given extra scopes' do
+      specify { expect(author.rated?(resource, extra_scopes: { scope_1: 'missing' })).to eq false }
+    end
+
+    context 'when has rate for the given resource with given extra scopes' do
+      specify { expect(author.rated?(resource, extra_scopes: { scope_1: 'scope_1' })).to eq true }
+    end
+  end if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] == 'true'
 end

data/spec/models/extension/rated_spec.rb

@@ -37,4 +37,12 @@ RSpec.describe Rating::Extension, ':rated' do
       expect(Rating::Rate.where(resource: article_1).count).to eq 0
     end
   end
+
+  context 'with extra scopes' do
+    let!(:extra_scopes_rate) { author_1.rate article_1, 1, extra_scopes: { scope_1: 'scope_1' } }
+
+    it 'returns records considering the extra scopes' do
+      expect(author_1.rated(extra_scopes: { scope_1: 'scope_1' })).to eq [extra_scopes_rate]
+    end
+  end if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] == 'true'
 end

data/spec/models/extension/rates_spec.rb

@@ -37,4 +37,12 @@ RSpec.describe Rating::Extension, ':rates' do
       expect(Rating::Rate.where(resource: article_1).count).to eq 0
     end
   end
+
+  context 'with extra scopes' do
+    let!(:extra_scopes_rate) { author_1.rate article_1, 1, extra_scopes: { scope_1: 'scope_1' } }
+
+    it 'returns records considering the extra scopes' do
+      expect(article_1.rates(extra_scopes: { scope_1: 'scope_1' })).to eq [extra_scopes_rate]
+    end
+  end if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] == 'true'
 end

data/spec/models/rate/create_spec.rb

@@ -7,7 +7,7 @@ RSpec.describe Rating::Rate, ':create' do
   let!(:article) { create :article }
 
   context 'with no scopeable' do
-    before { described_class.create author: author, metadata: {}, resource: article, value: 3 }
+    before { described_class.create author: author, extra_scopes: {}, metadata: {}, resource: article, value: 3 }
 
     context 'when rate does not exist yet' do
       it 'creates a rate entry' do
@@ -32,7 +32,7 @@ RSpec.describe Rating::Rate, ':create' do
     context 'when rate already exists' do
       let!(:author_2) { create :author }
 
-      before { described_class.create author: author_2, metadata: {}, resource: article, value: 4 }
+      before { described_class.create author: author_2, extra_scopes: {}, metadata: {}, resource: article, value: 4 }
 
       it 'creates one more rate entry' do
         rates = described_class.where(author: [author, author_2]).order('created_at asc')
@@ -67,7 +67,16 @@ RSpec.describe Rating::Rate, ':create' do
   context 'with scopeable' do
     let!(:category) { create :category }
 
-    before { described_class.create author: author, metadata: {}, resource: article, scopeable: category, value: 3 }
+    before do
+      described_class.create(
+        author:       author,
+        extra_scopes: {},
+        metadata:     {},
+        resource:     article,
+        scopeable:    category,
+        value:        3
+      )
+    end
 
     context 'when rate does not exist yet' do
       it 'creates a rate entry' do
@@ -94,7 +103,16 @@ RSpec.describe Rating::Rate, ':create' do
     context 'when rate already exists' do
       let!(:author_2) { create :author }
 
-      before { described_class.create author: author_2, metadata: {}, resource: article, scopeable: category, value: 4 }
+      before do
+        described_class.create(
+          author:       author_2,
+          extra_scopes: {},
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        4
+        )
+      end
 
       it 'creates one more rate entry' do
         rates = described_class.where(author: [author, author_2]).order('created_at asc')
@@ -132,7 +150,7 @@ RSpec.describe Rating::Rate, ':create' do
   context 'with metadata' do
     context 'with nil value' do
       it 'creates a rate entry ignoring metadata' do
-        described_class.create author: author, metadata: nil, resource: article, value: 3
+        described_class.create author: author, extra_scopes: {}, metadata: nil, resource: article, value: 3
 
         rate = described_class.last
 
@@ -145,7 +163,7 @@ RSpec.describe Rating::Rate, ':create' do
 
     context 'with empty value' do
       it 'creates a rate entry ignoring metadata' do
-        described_class.create author: author, metadata: '', resource: article, value: 3
+        described_class.create author: author, extra_scopes: {}, metadata: '', resource: article, value: 3
 
         rate = described_class.last
 
@@ -158,7 +176,13 @@ RSpec.describe Rating::Rate, ':create' do
 
     context 'with hash value' do
       it 'creates a rate entry with metadata included' do
-        described_class.create author: author, metadata: { comment: 'comment' }, resource: article, value: 3
+        described_class.create(
+          author:       author,
+          extra_scopes: {},
+          metadata:     { comment: 'comment' },
+          resource:     article,
+          value:        3
+        )
 
         rate = described_class.last
 
@@ -169,4 +193,170 @@ RSpec.describe Rating::Rate, ':create' do
       end
     end
   end
+
+  context 'with extra scopes' do
+    let!(:category) { create :category }
+
+    it 'creates a rate entry' do
+      described_class.create(
+        author:       author,
+        extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+        metadata:     {},
+        resource:     article,
+        scopeable:    category,
+        value:        1
+      )
+
+      rate = described_class.last
+
+      expect(rate.author).to    eq author
+      expect(rate.resource).to  eq article
+      expect(rate.scope_1).to   eq 'scope_1'
+      expect(rate.scope_2).to   eq 'scope_2'
+      expect(rate.scopeable).to eq category
+      expect(rate.value).to     eq 1
+    end
+
+    it 'creates a rating entry' do
+      described_class.create(
+        author:       author,
+        extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+        metadata:     {},
+        resource:     article,
+        scopeable:    category,
+        value:        1
+      )
+
+      rating = Rating::Rating.last
+
+      expect(rating.average).to   eq 1
+      expect(rating.estimate).to  eq 1
+      expect(rating.resource).to  eq article
+      expect(rating.scopeable).to eq category
+      expect(rating.sum).to       eq 1
+      expect(rating.total).to     eq 1
+    end
+
+    context 'when rate already exists' do
+      before do
+        described_class.create(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        1
+        )
+      end
+
+      it 'updates the rate entry' do
+        described_class.create(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        2
+        )
+
+        rates = described_class.all
+
+        expect(rates.size).to eq 1
+
+        rate = rates[0]
+
+        expect(rate.author).to    eq author
+        expect(rate.resource).to  eq article
+        expect(rate.scope_1).to   eq 'scope_1'
+        expect(rate.scope_2).to   eq 'scope_2'
+        expect(rate.scopeable).to eq category
+        expect(rate.value).to     eq 2
+      end
+
+      it 'updates the unique rating entry' do
+        described_class.create(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        2
+        )
+
+        ratings = Rating::Rating.all
+
+        expect(ratings.size).to eq 1
+
+        rating = ratings[0]
+
+        expect(rating.average).to   eq 2
+        expect(rating.estimate).to  eq 2
+        expect(rating.resource).to  eq article
+        expect(rating.scopeable).to eq category
+        expect(rating.sum).to       eq 2
+        expect(rating.total).to     eq 1
+      end
+    end
+
+    context 'when rate already exists but with at least one extra scope different' do
+      before do
+        described_class.create(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        1
+        )
+
+        described_class.create(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_missing' },
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        2
+        )
+      end
+
+      it 'creates a new rate entry' do
+        rates = described_class.all
+
+        expect(rates.size).to eq 2
+
+        rate = rates[0]
+
+        expect(rate.author).to    eq author
+        expect(rate.resource).to  eq article
+        expect(rate.scope_1).to   eq 'scope_1'
+        expect(rate.scope_2).to   eq 'scope_2'
+        expect(rate.scopeable).to eq category
+        expect(rate.value).to     eq 1
+
+        rate = rates[1]
+
+        expect(rate.author).to    eq author
+        expect(rate.resource).to  eq article
+        expect(rate.scope_1).to   eq 'scope_1'
+        expect(rate.scope_2).to   eq 'scope_missing'
+        expect(rate.scopeable).to eq category
+        expect(rate.value).to     eq 2
+      end
+
+      it 'updates the unique rating entry' do
+        ratings = Rating::Rating.all
+
+        expect(ratings.size).to eq 1
+
+        rating = ratings[0]
+
+        expect(rating.average).to   eq 1.5
+        expect(rating.estimate).to  eq 1.5
+        expect(rating.resource).to  eq article
+        expect(rating.scopeable).to eq category
+        expect(rating.sum).to       eq 3
+        expect(rating.total).to     eq 2
+      end
+    end
+  end if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] == 'true'
 end

data/spec/models/rate/rate_for_spec.rb

@@ -8,14 +8,16 @@ RSpec.describe Rating::Rate, ':rate_for' do
 
   context 'with no scopeable' do
     context 'when rate does not exist' do
-      specify { expect(described_class.rate_for(author: author, resource: article)).to eq nil }
+      it { expect(described_class.rate_for(author: author, resource: article)).to eq nil }
     end
 
-    context 'when rate does not exist' do
-      before { described_class.create author: author, metadata: {}, resource: article, value: 3 }
+    context 'when rate exists' do
+      let!(:record) do
+        described_class.create author: author, extra_scopes: {}, metadata: {}, resource: article, value: 3
+      end
 
       it 'returns the record' do
-        expect(described_class.rate_for(author: author, resource: article)).to eq described_class.last
+        expect(described_class.rate_for(author: author, resource: article)).to eq record
       end
     end
   end
@@ -24,17 +26,80 @@ RSpec.describe Rating::Rate, ':rate_for' do
     let!(:category) { create :category }
 
     context 'when rate does not exist' do
-      specify { expect(described_class.rate_for(author: author, resource: article, scopeable: category)).to eq nil }
+      it do
+        expect(described_class.rate_for(author: author, resource: article, scopeable: category)).to eq nil
+      end
     end
 
-    context 'when rate does not exist' do
-      before { described_class.create author: author, metadata: {}, resource: article, scopeable: category, value: 3 }
+    context 'when rate exists' do
+      let!(:record) do
+        described_class.create(
+          author:       author,
+          extra_scopes: {},
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        3
+        )
+      end
 
       it 'returns the record' do
         query = described_class.rate_for(author: author, resource: article, scopeable: category)
 
-        expect(query).to eq described_class.last
+        expect(query).to eq record
       end
     end
   end
+
+  context 'with extra scopes' do
+    let!(:category) { create :category }
+
+    context 'when matches all attributes including the extra scopes' do
+      let!(:record) do
+        described_class.create(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        1
+        )
+      end
+
+      it 'returns the record' do
+        result = described_class.rate_for(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+          resource:     article,
+          scopeable:    category
+        )
+
+        expect(result).to eq record
+      end
+    end
+
+    context 'when matches all attributes but at least one extra scopes' do
+      before do
+        described_class.create(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_2' },
+          metadata:     {},
+          resource:     article,
+          scopeable:    category,
+          value:        1
+        )
+      end
+
+      it 'does not return the record' do
+        result = described_class.rate_for(
+          author:       author,
+          extra_scopes: { scope_1: 'scope_1', scope_2: 'scope_missing' },
+          resource:     article,
+          scopeable:    category
+        )
+
+        expect(result).to eq nil
+      end
+    end
+  end if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] == 'true'
 end

data/spec/models/rate_spec.rb

@@ -18,4 +18,11 @@ RSpec.describe Rating::Rate do
   it do
     is_expected.to validate_numericality_of(:value).is_less_than_or_equal_to(100).is_less_than_or_equal_to 100
   end
+
+  it do
+    scopes = %i[author_type resource_id resource_type scopeable_id scopeable_type]
+    scopes += %i[scope_1 scope_2] if ENV['CONFIG_ENABLED_WITH_EXTRA_SCOPES'] == 'true'
+
+    expect(object).to validate_uniqueness_of(:author_id).scoped_to(scopes).case_insensitive
+  end
 end

data/spec/support/db/migrate/add_extra_fields_on_rating_rates_table.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+class AddExtraScopesOnRatingRatesTable < ActiveRecord::Migration[5.0]
+  def change
+    add_column :rating_rates, :scope_1, :string
+    add_column :rating_rates, :scope_2, :string
+
+    remove_index :rating_rates, %i[author_id author_type resource_id resource_type scopeable_id scopeable_type]
+  end
+end

data/spec/support/migrate.rb

@@ -14,3 +14,4 @@ CreateRatingTable.new.change
 CreateReviewRatingsTable.new.change
 CreateReviewsTable.new.change
 AddCommentOnRatingRatesTable.new.change
+AddExtraScopesOnRatingRatesTable.new.change

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rating
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Washington Botelho
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-26 00:00:00.000000000 Z
+date: 2018-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -148,6 +148,7 @@ files:
 - lib/rating/version.rb
 - spec/config/rate_table_spec.rb
 - spec/config/rating_table_spec.rb
+- spec/config/validations_spec.rb
 - spec/factories/article.rb
 - spec/factories/author.rb
 - spec/factories/category.rb
@@ -178,6 +179,7 @@ files:
 - spec/support/common.rb
 - spec/support/database_cleaner.rb
 - spec/support/db/migrate/add_comment_on_rating_rates_table.rb
+- spec/support/db/migrate/add_extra_fields_on_rating_rates_table.rb
 - spec/support/db/migrate/create_articles_table.rb
 - spec/support/db/migrate/create_authors_table.rb
 - spec/support/db/migrate/create_categories_table.rb
@@ -220,6 +222,7 @@ specification_version: 4
 summary: A true Bayesian rating system with scope and cache enabled.
 test_files:
 - spec/config/rate_table_spec.rb
+- spec/config/validations_spec.rb
 - spec/config/rating_table_spec.rb
 - spec/models/rate/rate_for_spec.rb
 - spec/models/rate/create_spec.rb
@@ -256,6 +259,7 @@ test_files:
 - spec/support/db/migrate/create_review_ratings_table.rb
 - spec/support/db/migrate/create_articles_table.rb
 - spec/support/db/migrate/add_comment_on_rating_rates_table.rb
+- spec/support/db/migrate/add_extra_fields_on_rating_rates_table.rb
 - spec/support/db/migrate/create_reviews_table.rb
 - spec/support/db/migrate/create_comments_table.rb
 - spec/support/database_cleaner.rb