auction_fun_core 0.8.7 → 0.8.9

data/lib/auction_fun_core/contracts/auction_context/pre_auction/auction_start_reminder_contract.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module AuctionFunCore
+  module Contracts
+    module AuctionContext
+      module PreAuction
+        # The AuctionStartReminderContract class validates the scheduled reminder for the auction start.
+        # It checks if the auction associated with the provided auction ID has not started yet and validates accordingly.
+        #
+        # @example Validating auction reminder
+        #   contract = AuctionFunCore::Contracts::AuctionContext::PreAuction::AuctionStartReminderContract.new
+        #   attributes = { auction_id: 123 }
+        #   result = contract.call(attributes)
+        #   if result.success?
+        #     puts "Reminder setup is valid."
+        #   else
+        #     puts "Failed to validate reminder: #{result.errors.to_h}"
+        #   end
+        #
+        class AuctionStartReminderContract < Contracts::ApplicationContract
+          # Scope for internationalization (i18n) entries specific to errors in this contract.
+          I18N_SCOPE = "contracts.errors.custom.auction_context.pre_auction.auction_start_reminder"
+
+          # Default repository initialization to retrieve auction data.
+          option :auction_repository, default: proc { Repos::AuctionContext::AuctionRepository.new }
+
+          # Defines the necessary parameters and their types.
+          params do
+            required(:auction_id).filled(:integer)
+          end
+
+          # Validation rule to ensure the referenced auction exists.
+          rule(:auction_id) do |context:|
+            context[:auction] ||= auction_repository.by_id(value)
+            key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:auction]
+          end
+
+          # Additional validation to confirm the auction has not started yet.
+          rule do |context:|
+            next if context[:auction].present? && context[:auction].not_started?
+
+            key(:base).failure(I18n.t("auction_already_started", scope: I18N_SCOPE))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/auction_fun_core/contracts/auction_context/processor/finish/closed_contract.rb

@@ -6,34 +6,46 @@ module AuctionFunCore
       module Processor
         module Finish
           ##
-          # Contract class for finishing closed auctions.
+          # This class is designed for validate the finishing closed auctions. It ensures that
+          # the auction to be closed exists, is of the correct kind ('closed'), and is in the correct
+          # status ('running') to be finalized.
+          #
+          # @example Validating a closed auction
+          #   contract = AuctionFunCore::Contracts::AuctionContext::Processor::Finish::ClosedContract.new
+          #   attributes = { auction_id: 123 }
+          #   result = contract.call(attributes)
+          #   if result.success?
+          #     puts "Auction can be finished."
+          #   else
+          #     puts "Failed to finish auction: #{result.errors.to_h}"
+          #   end
           #
           class ClosedContract < Contracts::ApplicationContract
+            # Internationalization (i18n) scope for error messages.
             I18N_SCOPE = "contracts.errors.custom.auction_context.processor.finish"
 
+            # Repository initialized to retrieve auction data for validation.
             option :auction_repository, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
+            # Parameters specifying the required input types and fields.
             params do
               required(:auction_id).filled(:integer)
             end
 
-            # Validation for auction.
-            # Validates if the auction exists in the database.
+            # Validates the existence of the auction.
             rule(:auction_id) do |context:|
               context[:auction] ||= auction_repository.by_id(value)
               key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:auction]
             end
 
-            # Validation for kind.
-            #
+            # Validates the kind of the auction to ensure it is 'closed'.
             rule do |context:|
               next if context[:auction].present? && context[:auction].kind == "closed"
 
               key(:base).failure(I18n.t("invalid_kind", scope: I18N_SCOPE))
             end
 
-            # Validation for status.
-            #
+            # Validates the status of the auction to ensure it is 'running'.
             rule do |context:|
               next if context[:auction].present? && context[:auction].status == "running"
 

data/lib/auction_fun_core/contracts/auction_context/processor/finish/penny_contract.rb

@@ -6,35 +6,47 @@ module AuctionFunCore
       module Processor
         module Finish
           ##
-          # Contract class for finishing penny auctions.
+          # This class is designed for validate the finishing penny auctions. It ensures that
+          # the auction to be penny exists, is of the correct kind ('penny'), and is in the correct
+          # status ('running') to be finalized.
+          #
+          # @example Validating a penny auction
+          #   contract = AuctionFunCore::Contracts::AuctionContext::Processor::Finish::PennyContract.new
+          #   attributes = { auction_id: 123 }
+          #   result = contract.call(attributes)
+          #   if result.success?
+          #     puts "Auction can be finished."
+          #   else
+          #     puts "Failed to finish auction: #{result.errors.to_h}"
+          #   end
           #
           class PennyContract < Contracts::ApplicationContract
+            # Internationalization (i18n) scope for error messages.
             I18N_SCOPE = "contracts.errors.custom.auction_context.processor.finish"
 
+            # Repository initialized to retrieve auction data for validation.
             option :auction_repository, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
+            # Parameters specifying the required input types and fields.
             params do
               required(:auction_id).filled(:integer)
             end
 
-            # Validation for auction.
-            # Validates if the auction exists in the database.
+            # Validates the existence of the auction.
             rule(:auction_id) do |context:|
               context[:auction] ||= auction_repository.by_id(value)
 
               key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:auction]
             end
 
-            # Validation for kind.
-            #
+            # Validates the kind of the auction to ensure it is 'penny'.
             rule do |context:|
               next if context[:auction].present? && context[:auction].kind == "penny"
 
               key(:base).failure(I18n.t("invalid_kind", scope: I18N_SCOPE))
             end
 
-            # Validation for status.
-            #
+            # Validates the status of the auction to ensure it is 'running'.
             rule do |context:|
               next if context[:auction].present? && context[:auction].status == "running"
 

data/lib/auction_fun_core/contracts/auction_context/processor/finish/standard_contract.rb

@@ -6,35 +6,47 @@ module AuctionFunCore
       module Processor
         module Finish
           ##
-          # Contract class for finishing standard auctions.
+          # This class is designed for validate the finishing standard auctions. It ensures that
+          # the auction to be standard exists, is of the correct kind ('standard'), and is in the correct
+          # status ('running') to be finalized.
+          #
+          # @example Validating a standard auction
+          #   contract = AuctionFunCore::Contracts::AuctionContext::Processor::Finish::StandardContract.new
+          #   attributes = { auction_id: 123 }
+          #   result = contract.call(attributes)
+          #   if result.success?
+          #     puts "Auction can be finished."
+          #   else
+          #     puts "Failed to finish auction: #{result.errors.to_h}"
+          #   end
           #
           class StandardContract < Contracts::ApplicationContract
+            # Internationalization (i18n) scope for error messages.
             I18N_SCOPE = "contracts.errors.custom.auction_context.processor.finish"
 
+            # Repository initialized to retrieve auction data for validation.
             option :auction_repository, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
+            # Parameters specifying the required input types and fields.
             params do
               required(:auction_id).filled(:integer)
             end
 
-            # Validation for auction.
-            # Validates if the auction exists in the database.
+            # Validates the existence of the auction.
             rule(:auction_id) do |context:|
               context[:auction] ||= auction_repository.by_id(value)
 
               key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:auction]
             end
 
-            # Validation for kind.
-            #
+            # Validates the kind of the auction to ensure it is 'standard'.
             rule do |context:|
               next if context[:auction].present? && context[:auction].kind == "standard"
 
               key(:base).failure(I18n.t("invalid_kind", scope: I18N_SCOPE))
             end
 
-            # Validation for status.
-            #
+            # Validates the status of the auction to ensure it is 'running'.
             rule do |context:|
               next if context[:auction].present? && context[:auction].status == "running"
 

data/lib/auction_fun_core/contracts/auction_context/processor/pause_contract.rb

@@ -5,18 +5,30 @@ module AuctionFunCore
     module AuctionContext
       module Processor
         ##
-        # Contract class for pause auction.
+        # This class is designed to validate pausing an auction. It ensures
+        # that the auction exists in the database and checks that only auctions with
+        # a "running" status can be paused.
+        #
+        # @example Pausing an auction
+        #   contract = AuctionFunCore::Contracts::AuctionContext::Processor::PauseContract.new
+        #   attributes = { auction_id: 123 }
+        #   result = contract.call(attributes)
+        #   if result.success?
+        #     puts "Auction paused successfully."
+        #   else
+        #     puts "Failed to pause auction: #{result.errors.to_h}"
+        #   end
         #
         class PauseContract < Contracts::ApplicationContract
+          # Repository initialized to retrieve auction data for validation.
           option :auction_repository, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
+          # Parameters specifying the required input types and fields.
           params do
             required(:auction_id).filled(:integer)
           end
 
-          # Validation for auction.
-          # Validates if the auction exists in the database and check if  only auctions
-          # with a "running" status can be paused.
+          # Validates the existence of the auction and its status.
           rule(:auction_id) do |context:|
             context[:auction] ||= auction_repository.by_id(value)
             key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:auction]

data/lib/auction_fun_core/contracts/auction_context/processor/start_contract.rb

@@ -5,28 +5,40 @@ module AuctionFunCore
     module AuctionContext
       module Processor
         ##
-        # Contract class for start auctions.
+        # This class is designed to validate the initiation of auctions. It ensures
+        # the auction exists and is of a valid kind, and also manages specific rules for auctions
+        # that require a stopwatch, such as penny auctions.
+        #
+        # @example Starting an auction
+        #   contract = AuctionFunCore::Contracts::AuctionContext::Processor::StartContract.new
+        #   attributes = { auction_id: 123, kind: "penny", stopwatch: 30 }
+        #   result = contract.call(attributes)
+        #   if result.success?
+        #     puts "Auction started successfully."
+        #   else
+        #     puts "Failed to start auction: #{result.errors.to_h}"
+        #   end
         #
         class StartContract < Contracts::ApplicationContract
           include AuctionFunCore::Business::Configuration
 
+          # Repository initialized to retrieve auction data for validation.
           option :auction_repo, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
+          # Parameters specifying the required input types and fields.
           params do
             required(:auction_id).filled(:integer)
             required(:kind).value(included_in?: AUCTION_KINDS)
             optional(:stopwatch).filled(:integer)
           end
 
-          # Validation for auction.
-          # Validates if the auction exists in the database.
+          # Validates the existence of the auction.
           rule(:auction_id) do |context:|
             context[:auction] ||= auction_repo.by_id(value)
             key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:auction]
           end
 
-          # Validation for stopwatch.
-          #
+          # Validates the requirements for the stopwatch in penny auctions.
           rule(:stopwatch) do
             # Must be filled if auction kind is type penny.
             key.failure(I18n.t("contracts.errors.filled?")) if !key? && values[:kind] == "penny"

data/lib/auction_fun_core/contracts/auction_context/processor/unpause_contract.rb

@@ -5,18 +5,30 @@ module AuctionFunCore
     module AuctionContext
       module Processor
         ##
-        # Contract class for unpause auction.
+        # This class is designed to validate the resumption of auctions.
+        # It ensures that the auction exists in the database and checks that the auction
+        # is currently in a "paused" status, allowing it to be unpaused.
+        #
+        # @example Unpausing an auction
+        #   contract = AuctionFunCore::Contracts::AuctionContext::Processor::UnpauseContract.new
+        #   attributes = { auction_id: 123 }
+        #   result = contract.call(attributes)
+        #   if result.success?
+        #     puts "Auction resumed successfully."
+        #   else
+        #     puts "Failed to resume auction: #{result.errors.to_h}"
+        #   end
         #
         class UnpauseContract < Contracts::ApplicationContract
+          # Repository initialized to retrieve auction data for validation.
           option :auction_repository, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
+          # Parameters specifying the required input types and fields.
           params do
             required(:auction_id).filled(:integer)
           end
 
-          # Validation for auction.
-          # Validates if the auction exists in the database and and checks if the
-          # auction has a paused status.
+          # Validates the existence of the auction and checks its status.
           rule(:auction_id) do |context:|
             context[:auction] ||= auction_repository.by_id(value)
             key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:auction]

data/lib/auction_fun_core/contracts/bid_context/create_bid_closed_contract.rb

@@ -3,13 +3,27 @@
 module AuctionFunCore
   module Contracts
     module BidContext
-      # Contract class to create new bids.
+      # This class validates the creation of new bids for closed-type auctions.
+      # It ensures the bid is placed by a valid user on a valid auction that is open for bids, and that
+      # the bid value meets or exceeds the starting bid required by the auction.
+      # Furthermore, only one bid per participant is allowed.
+      #
+      # @example Creating a bid for a closed auction
+      #   contract = AuctionFunCore::Contracts::BidContext::CreateBidClosedContract.new
+      #   attributes = { auction_id: 123, user_id: 2, value_cents: 10000 }
+      #   result = contract.call(attributes)
+      #   if result.success?
+      #     puts "Bid created successfully."
+      #   else
+      #     puts "Failed to create bid: #{result.errors.to_h}"
+      #   end
       class CreateBidClosedContract < Contracts::ApplicationContract
+        # Repositories initialized to retrieve data for validation.
         option :user_repository, default: proc { Repos::UserContext::UserRepository.new }
         option :auction_repository, default: proc { Repos::AuctionContext::AuctionRepository.new }
         option :bid_repository, default: proc { Repos::BidContext::BidRepository.new }
 
-        # @param [Hash] opts Sets an allowed list of parameters, as well as some initial validations.
+        # Parameters specifying the required input types and fields.
         params do
           required(:auction_id).filled(:integer)
           required(:user_id).filled(:integer)
@@ -21,9 +35,7 @@ module AuctionFunCore
           end
         end
 
-        # Validation for auction.
-        # validate whether the given auction is valid at the database level.
-        # validate if the auction is open to receive bids
+        # Validates the auction's validity and status for receiving bids.
         rule(:auction_id) do |context:|
           context[:auction] ||= auction_repository.by_id(value)
 
@@ -42,9 +54,7 @@ module AuctionFunCore
           end
         end
 
-        # Validation for user.
-        # Validate whether the given user is valid at the database level.
-        # Validates if user has already placed a bid
+        # Validates the user's existence and checks if they have already placed a bid.
         rule(:user_id) do |context:|
           context[:user] ||= user_repository.by_id(value)
 
@@ -57,8 +67,7 @@ module AuctionFunCore
           end
         end
 
-        # Validation for value bid.
-        # The bid amount must be greater than or equal to the starting bid.
+        # Validates that the bid amount is greater than or equal to the auction's starting bid.
         rule(:value_cents) do |context:|
           unless rule_error?(:user_id)
             closed_auction_bid_value_is_gteq_initial_bid?(key, value, context[:auction].initial_bid_cents)
@@ -67,7 +76,7 @@ module AuctionFunCore
 
         private
 
-        # Checks if bid amount must be greater than or equal to the starting bid.
+        # Helper method to check if the bid amount meets the minimum required bid.
         def closed_auction_bid_value_is_gteq_initial_bid?(key, value_cents, minimal_bid_cents)
           return unless value_cents < minimal_bid_cents
 

data/lib/auction_fun_core/contracts/bid_context/create_bid_penny_contract.rb

@@ -3,12 +3,25 @@
 module AuctionFunCore
   module Contracts
     module BidContext
-      # Contract class to create new bids.
+      # This class validates the creation of new bids for penny-type auctions.
+      # It guarantees that the bid can only be made within the correct status of this type of auction,
+      # in addition, the participant must have sufficient balance in their wallet to place a new bid.
+      #
+      # @example Creating a bid for a penny auction
+      #   contract = AuctionFunCore::Contracts::BidContext::CreateBidPennyContract.new
+      #   attributes = { auction_id: 123, user_id: 2 }
+      #   result = contract.call(attributes)
+      #   if result.success?
+      #     puts "Bid created successfully."
+      #   else
+      #     puts "Failed to create bid: #{result.errors.to_h}"
+      #   end
       class CreateBidPennyContract < Contracts::ApplicationContract
+        # Repositories initialized to retrieve data for validation.
         option :user_repo, default: proc { Repos::UserContext::UserRepository.new }
         option :auction_repo, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
-        # @param [Hash] opts Sets an allowed list of parameters, as well as some initial validations.
+        # Parameters specifying the required input types and fields.
         params do
           required(:auction_id).filled(:integer)
           required(:user_id).filled(:integer)
@@ -19,9 +32,7 @@ module AuctionFunCore
           end
         end
 
-        # Validation for auction.
-        # validate whether the given auction is valid at the database level.
-        # validate if the auction is open to receive bids
+        # Validates the auction's validity, kind, and status for receiving bids.
         rule(:auction_id) do |context:|
           context[:auction] ||= auction_repo.by_id(value)
 
@@ -40,9 +51,7 @@ module AuctionFunCore
           end
         end
 
-        # Validation for user.
-        # Validate whether the given user is valid at the database level.
-        # Validates if user has enough balance to bid.
+        # Validates the user's existence and ensures they have enough balance to bid.
         rule(:user_id) do |context:|
           context[:user] ||= user_repo.by_id(value)
 
@@ -59,7 +68,7 @@ module AuctionFunCore
 
         private
 
-        # Checks if user has enough balance to bid.
+        # Helper method to check if the user has sufficient balance to place a bid in a penny auction.
         def penny_auction_check_user_has_balance?(key, auction_bid_cents, balance_cents)
           key.failure(I18n.t("contracts.errors.custom.bids.insufficient_balance")) if balance_cents < auction_bid_cents
         end

data/lib/auction_fun_core/contracts/bid_context/create_bid_standard_contract.rb

@@ -3,12 +3,25 @@
 module AuctionFunCore
   module Contracts
     module BidContext
-      # Contract class to create new bids.
+      # This class validates the creation of new bids for standard-type auctions.
+      # It ensures the bid is placed by a valid user on a valid auction that is open for bids,
+      # and that the bid value meets or exceeds the minimum bid required by the auction.
+      #
+      # @example Creating a bid for a standard auction
+      #   contract = AuctionFunCore::Contracts::BidContext::CreateBidStandardContract.new
+      #   attributes = { auction_id: 1, user_id: 2, value_cents: 5000 }
+      #   result = contract.call(attributes)
+      #   if result.success?
+      #     puts "Bid created successfully."
+      #   else
+      #     puts "Failed to create bid: #{result.errors.to_h}"
+      #   end
       class CreateBidStandardContract < Contracts::ApplicationContract
+        # Repositories initialized to retrieve data for validation.
         option :user_repo, default: proc { Repos::UserContext::UserRepository.new }
         option :auction_repo, default: proc { Repos::AuctionContext::AuctionRepository.new }
 
-        # @param [Hash] opts Sets an allowed list of parameters, as well as some initial validations.
+        # Parameters specifying the required input types and fields.
         params do
           required(:auction_id).filled(:integer)
           required(:user_id).filled(:integer)
@@ -20,9 +33,7 @@ module AuctionFunCore
           end
         end
 
-        # Validation for auction.
-        # validate whether the given auction is valid at the database level.
-        # validate if the auction is open to receive bids
+        # Validates the auction's validity, kind, and status for receiving bids.
         rule(:auction_id) do |context:|
           context[:auction] ||= auction_repo.by_id(value)
 
@@ -41,22 +52,20 @@ module AuctionFunCore
           end
         end
 
-        # Validation for user.
-        # Validate whether the given user is valid at the database level.
+        # Validates the user's existence in the database.
         rule(:user_id) do |context:|
           context[:user] ||= user_repo.by_id(value)
           key.failure(I18n.t("contracts.errors.custom.not_found")) unless context[:user]
         end
 
-        # Validation for value bid.
-        # must be greater than or equal to the auction's minimal bid.
+        # Validates that the bid amount is greater than or equal to the auction's minimum bid.
         rule(:value_cents) do |context:|
           standard_auction_valid_bid?(key, value, context[:auction].minimal_bid_cents)
         end
 
         private
 
-        # Checks if the bid amount is greather than or equal to minimum bid.
+        # Helper method to check if the bid amount meets the minimum required bid.
         def standard_auction_valid_bid?(key, value_cents, minimal_bid_cents)
           return if value_cents >= minimal_bid_cents
 

data/lib/auction_fun_core/contracts/staff_context/authentication_contract.rb

@@ -3,12 +3,27 @@
 module AuctionFunCore
   module Contracts
     module StaffContext
-      # Contract class to authenticate staff.
+      # This class is designed to authenticate staff members.
+      # It validates the login and password, checking their format and verifying them against the database records.
+      #
+      # @example Authenticating a staff member
+      #   contract = AuctionFunCore::Contracts::StaffContext::AuthenticationContract.new
+      #   attributes = { login: 'staff@example.com', password: 'securePassword123' }
+      #   result = contract.call(attributes)
+      #   if result.success?
+      #     puts "Authentication successful."
+      #   else
+      #     puts "Authentication failed: #{result.errors.to_h}"
+      #   end
+      #
       class AuthenticationContract < ApplicationContract
+        # Scope for internationalization (i18n) entries specific to errors in this contract.
         I18N_SCOPE = "contracts.errors.custom.default"
 
+        # Repositories initialized to retrieve data for validation.
         option :staff_repository, default: proc { Repos::StaffContext::StaffRepository.new }
 
+        # Parameters specifying the required input types and fields.
         params do
           required(:login)
           required(:password)
@@ -18,12 +33,11 @@ module AuctionFunCore
           end
         end
 
+        # Additional rules for validating the format of login and password.
         rule(:login).validate(:login_format)
         rule(:password).validate(:password_format)
 
-        # Validation for login.
-        # Searches for the staff in the database from the login, and, if found,
-        # compares the entered password.
+        # Validates the presence of the staff member in the database and checks if the password matches.
         rule do |context:|
           next if (rule_error?(:login) || schema_error?(:login)) || (rule_error?(:password) || schema_error?(:password))
 

data/lib/auction_fun_core/contracts/staff_context/registration_contract.rb

@@ -3,13 +3,27 @@
 module AuctionFunCore
   module Contracts
     module StaffContext
-      # Contract class to create new staff.
+      # This class is designed to create staff members.
+      # It validates the parameters, ensuring their format and uniqueness.
+      #
+      # @example Registering a new staff member
+      #   contract = AuctionFunCore::Contracts::StaffContext::RegistrationContract.new
+      #   attributes = { name: 'John Doe', email: 'john.doe@example.com', phone: '1234567890' }
+      #   result = contract.call(attributes)
+      #   if result.success?
+      #     puts "Staff member registered successfully."
+      #   else
+      #     puts "Failed to register staff member: #{result.errors.to_h}"
+      #   end
+      #
       class RegistrationContract < ApplicationContract
+        # Scope for internationalization (i18n) entries specific to errors in this contract.
         I18N_SCOPE = "contracts.errors.custom.default"
 
+        # Repositories initialized to retrieve data for validation.
         option :staff_repository, default: proc { Repos::StaffContext::StaffRepository.new }
 
-        # @param [Hash] opts Sets an allowed list of parameters, as well as some initial validations.
+        # Parameters specifying the required input types and fields.
         params do
           required(:name)
           required(:email)
@@ -19,27 +33,25 @@ module AuctionFunCore
             result.to_h.compact
           end
 
-          # Normalize and add default values
+          # Normalizes and adds default values after coercion.
           after(:value_coercer) do |result|
             result.update(email: result[:email].strip.downcase) if result[:email]
             result.update(phone: result[:phone].tr_s("^0-9", "")) if result[:phone]
           end
         end
 
+        # Validates the format of the staff member's name.
         rule(:name).validate(:name_format)
 
-        # Validation for email.
-        # It must validate the format and uniqueness in the database.
+        # It ensures email format and checks for uniqueness in the database.
         rule(:email).validate(:email_format)
         rule(:email) do
-          # Email should be unique on database
           if !rule_error?(:email) && staff_repository.exists?(email: value)
             key.failure(I18n.t(:taken, scope: I18N_SCOPE))
           end
         end
 
-        # Validation for phone.
-        # It must validate the format and uniqueness in the database.
+        # It ensures phone format and checks for uniqueness in the database.
         rule(:phone).validate(:phone_format)
         rule(:phone) do
           if !rule_error?(:phone) && staff_repository.exists?(phone: value)