dvla-application_helper 5.1.5

data/lib/dvla/application_helper/builders/V3/base_uodl_v3_application_builder.rb

@@ -0,0 +1,342 @@
+module DVLA
+  module Application
+    class BaseUODLV3ApplicationBuilder
+      def initialize
+        @applicant = nil
+        @application_id = SecureRandom::uuid
+        @application_status = 'Preparing'
+        @bfpo_address = false
+        @change_of_address = false
+        @customer_id = nil
+        @driver_id = nil
+        @extend_application_deadline = false
+        @free_key_address = false
+        @identity_confidence_level = 'MEDIUM'
+        @organ_donor = nil
+        @payments = nil
+        @product_type = 'Driving Licence'
+        @processable = false
+        @phone_number = false
+        @transaction_outcome = nil
+        @unique_images = false
+        @update_reason = nil
+        @welsh_language = false
+      end
+
+      # Marks the application as processable, doing this will ensure that real services are used to create the
+      # application. For example, the channel api will process the tasks rather than stub data being provided.
+      # Whilst this results in a more complete application, this option is more expensive.
+      # Avoid excessive use in QA tests.
+      # @return [Builder]
+      def processable
+        @processable = true
+        self
+      end
+
+      # Marks the application as non-processable. This will result in the application being created using the test application endpoint.
+      # These applications cannot be actioned via the task service.
+      # This is typically the default option to be used.
+      # @return [Builder]
+      def non_processable
+        @processable = false
+        self
+      end
+
+      # APE uses very specific generated uuid to test with, the inspectable hooks filter the last 12 integers to return specific responses
+      # @param application_id [UUID]
+      def with_application_id(application_id)
+        @application_id = application_id
+        self
+      end
+
+      # The application will be made for the given customer
+      # @param customer_id [String] The customer ID to use
+      # @return [Builder]
+      def with_customer_id(customer_id)
+        @customer_id = customer_id
+        self
+      end
+
+      # The application will be made for the given driver
+      # @param driver_id [String] The driver ID to use
+      # @return [Builder]
+      def with_driver_id(driver_id)
+        @driver_id = driver_id
+        self
+      end
+
+      # The application will contain a specific application status.
+      # How this state is reached will depend on if the application has been marked as processable or not.
+      # If processable is used here, we will also contain all actions.
+      # @param application_status [String] The application status the application should be in.
+      # @param update_reason [String] The reason for the change in status.
+      # @return [Builder].
+      def with_application_status(application_status, update_reason = nil)
+        @application_status = application_status
+        @update_reason = update_reason
+        self
+      end
+
+      # The application will be updated with a call to action field which is used to extend an application
+      def extend_application_deadline
+        @extend_application_deadline = true
+        self
+      end
+
+      # The application will contain the provided payments.
+      # @param payments [PaymentObject] Payment status.
+      # @return [Builder]
+      def with_payments(payments)
+        @payments = payments
+        self
+      end
+
+      # The application will contain the provided applicant data.
+      # @param applicant [ApplicantObject] Application data.
+      # @return [Builder]
+      def with_applicant(applicant)
+        @applicant = applicant
+        self
+      end
+
+      # The application will contain a bfpo address.
+      # @return [Builder]
+      def with_bfpo_address
+        @bfpo_address = true
+        self
+      end
+
+      # The application will contain a free key address.
+      # @return [Builder]
+      def with_free_key_address
+        @free_key_address = true
+        self
+      end
+
+      # The application will contain a change of address.
+      # @return [Builder]
+      def with_change_of_address
+        @change_of_address = true
+        self
+      end
+
+      # Sets the organ donor status of the application.
+      # By default, no organ donation is made
+      # Passing true will cause all_organs to be selected.
+      # Passing false will ensure no organs are selected.
+      # @param donor [boolean] Organ donor status.
+      # @return [Builder]
+      def is_organ_donor(donor)
+        @organ_donor = donor
+        self
+      end
+
+      def is_welsh_language
+        @welsh_language = true
+        self
+      end
+
+      # The application will contain a phone number.
+      # @return [Builder]
+      def has_phone_number
+        @phone_number = true
+        self
+      end
+
+      def with_low_confidence_level
+        @identity_confidence_level = 'LOW'
+        self
+      end
+
+      # Allows specific product type to be passed in
+      # Used during APE testing for inspectable hooks
+      # @param product [Enum] one of: [Vehicles,Driving Licence,Test]
+      # @return [Builder]
+      def with_product_type(product)
+        if !Settings.test.product_type.include?(product)
+          raise "Unknown Product_type: #{product}, must be one of: #{Settings.test.product_type}"
+        end
+        @product_type = product
+        self
+      end
+
+      # The application will contain unique imageIds
+      # Allows images to be interacted with during test, e.g. deleted
+      def unique_images
+        @unique_images = true
+        self
+      end
+
+      def with_transaction_outcome(outcome)
+        @transaction_outcome = outcome
+        self
+      end
+
+      def build
+        # Sense check to ensure AWS credentials are present.
+        DVLA::Application.check_aws_credentials
+
+        check_application_validity
+
+        factory = if @processable
+                    FM[:uodl_v3_processable_application]
+                  else
+                    non_processable_application_factory
+                  end
+
+        # pass in uodl_v3 FM factory to build data attribute
+        app = factory.build(attributes: { data: FM[:uodl_v3_application_data].build }) do |b|
+          @driver_id = default_application_driver_id if @driver_id.nil?
+          update_driver_id!(b)
+
+          update_main_properties!(b)
+
+          b.data.customer_context = application_customer_context
+          update_customer_context!(b)
+
+          update_applicant!(b)
+
+          update_address!(b)
+
+          update_organ_donor!(b)
+
+          update_payments!(b)
+
+          update_no_fee!(b) unless @no_fee_application.nil?
+
+          b.images = application_images
+
+          calculate_default_update_reason
+
+          set_application_specific_fields!(b)
+        end
+
+        process_application_tasks(app)
+        process_application(app)
+
+        extend_deadline(app) if @extend_application_deadline
+
+        DVLA::Application::ApplicationDomain.retrieve_application_by_app_id(application_id: app.application_id)
+      end
+
+      # -- Overridable methods used by sub-types --
+
+      def check_application_validity
+        # Allows a sub-type to optionally run checks on the flags of the application before building any resourcses
+      end
+
+      def non_processable_application_factory
+        raise 'The specific application type builder should override this method and return the factory specific to the application type'
+      end
+
+      def default_application_driver_id
+        raise 'The specific application type builder should override this method and return the driver id specific for the application type, this usually is hardcoded in channel-api-stub'
+      end
+
+      def application_images
+        raise 'The specific application type builder should override this method and return the images needed for the specific application type'
+      end
+
+      def application_customer_context
+        raise 'The specific application type builder should override this method and return the customer context of the specific application type'
+      end
+
+      def set_application_specific_fields!(app)
+        # Allows a sub-type to populate or override specific fields of an application
+      end
+
+      def process_application_tasks(app)
+        # Allows a sub-type to advance any tasks specific of the application type
+      end
+
+    private
+      # -- Methods allowing specific actions that occur during the application build process --
+      def update_main_properties!(app)
+        app.application_id = @application_id
+        app.customer_id = @customer_id if @customer_id
+        unless @processable
+          app.data_schema = Settings.application.v3_schema
+          app.product_type = @product_type
+        end
+      end
+
+      def update_driver_id!(app)
+        if @processable && @driver_id
+          app.driver_id = @driver_id
+        elsif @driver_id
+          app.product_id = @driver_id
+          app.product_key = @driver_id
+        end
+      end
+
+      def update_customer_context!(app)
+        if !@processable && !@transaction_outcome.nil?
+          app.data.customer_context[:transactionOutcome] = @transaction_outcome
+          app.data.customer_context[:customerIntent] = @transaction_outcome
+        end
+      end
+
+      def update_address!(app)
+        new_address = if @change_of_address || @free_key_address
+                        { unstructuredAddress: FM[:application_unstructured_address].build }
+                      elsif @bfpo_address
+                        { bfpoAddress: FM[:bfpo_address].build }
+                      end
+        unless new_address.nil?
+          # Dynamically add updateAddress field into object
+          app.data.instance_variable_set(:@updateAddress, { newAddress: new_address })
+        end
+      end
+
+      def update_applicant!(app)
+        app.data.applicant = @applicant if @applicant
+        app.data.applicant[:phoneNumber] = Faker::PhoneNumber.phone_number if @phone_number
+        app.data.applicant[:languagePreference] = 'Welsh' if @welsh_language
+        app.data.applicant[:identityTokenData][:confidenceLevel] = @identity_confidence_level
+      end
+
+      def update_organ_donor!(app)
+        app.data.organ_donor = if @organ_donor
+                                 set_any_organs(any_organs_bool: @organ_donor)
+                               elsif @application_status == 'Rejected'
+                                 FM[:organ_donor_d90_response].build(attributes: { kidneys: true })
+                               elsif @application_status == 'Returned'
+                                 FM[:organ_donor_d90_response].build(attributes: { cornea: true })
+                               elsif @application_status == 'Unapproved'
+                                 FM[:organ_donor_d90_response].build(attributes: { heart: true })
+                               else
+                                 {}
+                               end
+      end
+
+      def update_payments!(app)
+        if !@processable && !@payments.nil?
+          app.payments = @payments
+        end
+      end
+
+      def update_no_fee!(app)
+        app.no_fee_application = true if @no_fee_application
+      end
+
+      def calculate_default_update_reason
+        if !@processable && !@application_status.nil? && @application_status == 'Cancelled'
+          @update_reason = @update_reason || 'Timed out'
+        end
+      end
+
+      def process_application(app)
+        if !@processable
+          DVLA::Application::ApplicationStatusProcessor.process_to(app.application_id, @application_status, update_reason: @update_reason)
+        end
+      end
+
+      # updates call to action date on domain
+      def extend_deadline(app)
+        extend_date = Time.now + 21.days
+        DVLA::Application.logger.info("Updating application call to action deadline date to: #{extend_date}".blue)
+        DVLA::Application::ApplicationDomain.update_call_to_action_deadline_date(application_id: app.application_id, call_to_action_deadline_date: extend_date.utc.iso8601)
+      end
+    end
+  end
+end

data/lib/dvla/application_helper/builders/V3/cop_v3_application_builder.rb

@@ -0,0 +1,56 @@
+require_relative('../photo_signature_builder_mixin.rb')
+
+module DVLA
+  module Application
+    class COPV3ApplicationBuilder < BaseUODLV3ApplicationBuilder
+      # Including all properties and methods needed to support photos
+      include DVLA::Application::PhotoBuilderMixin
+
+      def initialize
+        init_photo_properties
+        super
+      end
+
+      # Some builder methods are automatically included from PhotoBuilderMixin
+
+      # -- Overridden methods --
+    private
+
+      # Defining the non-processable application factory that the BaseUODLV3ApplicationBuilder will use
+      def non_processable_application_factory
+        FM[:cop_application]
+      end
+
+      # Defining the default driver_id, used to pass the validation in channel-api-stub
+      def default_application_driver_id
+        Settings.test.driver_id.optional_cop
+      end
+
+      # Defining the data to put in customer_context
+      def application_customer_context
+        {
+          customerIntent: 'Change of photo',
+          transactionOutcome: 'Change of photo',
+          applicationsEligibilityResponse: [{
+                                              applicationType: 'update-ordinary-licence',
+                                              isRequired: true,
+                                              availableActions: [
+                                                actionType: 'update-photo',
+                                                isRequired: true,
+                                              ],
+                                            }],
+        }
+      end
+
+      # Creating the images that the BaseUODLV3ApplicationBuilder will include in the app
+      def application_images
+        generate_photo_images(@processable, @unique_images)
+      end
+
+      # Advance and submits the tasks based on the photo review state specified
+      def process_application_tasks(app)
+        process_photo_tasks(app) if @processable
+      end
+    end
+  end
+end

data/lib/dvla/application_helper/builders/V3/dup_v3_application_builder.rb

@@ -0,0 +1,78 @@
+require_relative('../photo_signature_builder_mixin.rb')
+require_relative('../dup_rep_builder_mixin.rb')
+
+module DVLA
+  module Application
+    class DUPV3ApplicationBuilder < BaseUODLV3ApplicationBuilder
+      # Including all properties and methods needed to support photos and signatures in the case of a Paper DUP
+      include DVLA::Application::PhotoSignatureBuilderMixin
+      include DVLA::Application::DupRepBuilderMixin
+
+      def initialize
+        dup_rep_init_properties
+        init_photo_signature_properties
+        super
+      end
+
+      # -- Builder methods --
+
+      # Some builder methods are automatically included from PhotoSignatureBuilderMixin and DupRepBuilderMixin
+
+      # Acts as if the licence owner has a paper licence.
+      # The application will be eligible to be changed from a paper licence to a plastic one
+      # It will also upload a photo and a signature with the application, and enable the flags to control these images and their tasks
+      # Sets the driver id to the specific id required for channel api stub to recognise
+      # @return [DUPV3ApplicationBuilder]
+      def with_paper_to_plastic_driver_id
+        @eligibility_paper_to_plastic = true
+        @driver_id = Settings.test.driver_id.paper_duplicate
+        self
+      end
+
+      # -- Overridden methods --
+    private
+
+      # Defining the non-processable application factory that the BaseUODLV3ApplicationBuilder will use
+      def non_processable_application_factory
+        FM[:dup_application]
+      end
+
+      # Defining the default driver_id, used to pass the validation in channel-api-stub
+      def default_application_driver_id
+        Settings.test.driver_id.always_duplicate
+      end
+
+      # Defining the data to put in customer_context
+      def application_customer_context
+        {
+          customerIntent: 'Duplicate licence',
+          transactionOutcome: 'Duplicate licence',
+          applicationsEligibilityResponse: [{
+                                              applicationType: 'update-ordinary-licence',
+                                              isRequired: true,
+                                              availableActions: [
+                                                actionType: 'update-photo',
+                                                isRequired: false,
+                                              ],
+                                            }],
+        }
+      end
+
+      def set_application_specific_fields!(app)
+        # Ensure DUP always has a reason for not providing licence
+        app.data.unable_to_prove_licence_possession_reason = 'LOST_OR_STOLEN'
+
+        unless @unable_to_prove_licence_possession_reason.nil?
+          app.data.unable_to_prove_licence_possession_reason = @unable_to_prove_licence_possession_reason
+        end
+
+        if @eligibility_paper_to_plastic
+          app.data.customer_context[:applicationsEligibilityResponse][0][:availableActions].push({
+                                                                                                  actionType: 'inform-paper-to-plastic',
+                                                                                                  isRequired: true,
+                                                                                              })
+        end
+      end
+    end
+  end
+end

data/lib/dvla/application_helper/builders/V3/exc_v3_application_builder.rb

@@ -0,0 +1,56 @@
+require_relative('../photo_signature_builder_mixin.rb')
+
+module DVLA
+  module Application
+    class EXCV3ApplicationBuilder < BaseUODLV3ApplicationBuilder
+      # Including all properties and methods needed to support photos and signatures
+      include DVLA::Application::PhotoSignatureBuilderMixin
+
+      def initialize
+        init_photo_signature_properties
+        super
+      end
+
+      # Some builder methods are automatically included from PhotoSignatureBuilderMixin
+
+      # -- Overridden methods --
+    private
+
+      # Defining the non-processable application factory that the BaseUODLV3ApplicationBuilder will use
+      def non_processable_application_factory
+        FM[:exc_application]
+      end
+
+      # Defining the default driver_id, used to pass the validation in channel-api-stub
+      def default_application_driver_id
+        Settings.test.driver_id.always_exchange
+      end
+
+      # Defining the data to put in customer_context
+      def application_customer_context
+        {
+            customerIntent: 'Paper to photocard',
+            transactionOutcome: 'Paper to photocard',
+            applicationsEligibilityResponse: [{
+              applicationType: 'update-ordinary-licence',
+              isRequired: true,
+              availableActions: [
+                actionType: 'inform-paper-to-plastic',
+                isRequired: true,
+              ],
+            }],
+        }
+      end
+
+      # Creating the images that the BaseUODLV3ApplicationBuilder will include in the app
+      def application_images
+        generate_photo_signature_images(@processable, @unique_images)
+      end
+
+      # Advance and submits the tasks based on the phot and signature review state specified
+      def process_application_tasks(app)
+        process_photo_signature_tasks(app) if @processable
+      end
+    end
+  end
+end

data/lib/dvla/application_helper/builders/V3/rep_v3_application_builder.rb

@@ -0,0 +1,81 @@
+require_relative('../photo_signature_builder_mixin.rb')
+require_relative('../dup_rep_builder_mixin.rb')
+
+module DVLA
+  module Application
+    class REPV3ApplicationBuilder < BaseUODLV3ApplicationBuilder
+      # Including all properties and methods needed to support photos and signatures in the case of a Paper DUP
+      include DVLA::Application::PhotoSignatureBuilderMixin
+      include DVLA::Application::DupRepBuilderMixin
+
+
+      def initialize
+        @unable_to_prove_licence_possession_reason = nil
+        @eligibility_paper_to_plastic = false
+        @change_of_address = true
+        init_photo_signature_properties
+        super
+      end
+
+      # -- Builder methods --
+
+      # Some builder methods are automatically included from PhotoSignatureBuilderMixin
+
+
+      # Acts as if the licence owner has a paper licence.
+      # The application will be eligible to be changed from a paper licence to a plastic one and therefore have a normal fee
+      # It will also upload a photo and a signature with the application, and enable the flags to control these images and their tasks
+      # Sets the driver id to the specific id required for channel api stub to recognise
+      # @return [REPV3ApplicationBuilder]
+      def with_paper_to_plastic_driver_id
+        @eligibility_paper_to_plastic = true
+        @driver_id = Settings.test.driver_id.paper_replacement
+        self
+      end
+
+      # -- Overridden methods --
+    private
+
+      # Defining the non-processable application factory that the BaseUODLV3ApplicationBuilder will use
+      def non_processable_application_factory
+        FM[:rep_application]
+      end
+
+      # Defining the default driver_id, used to pass the validation in channel-api-stub
+      def default_application_driver_id
+        Settings.test.driver_id.always_replacement
+      end
+
+      # Defining the data to put in customer_context
+      def application_customer_context
+        {
+          customerIntent: 'Change of details',
+          transactionOutcome: 'Change of details',
+          applicationsEligibilityResponse: [{
+                                              applicationType: 'update-ordinary-licence',
+                                              isRequired: true,
+                                              availableActions: [
+                                                actionType: 'update-address',
+                                                isRequired: true,
+                                              ],
+                                            }],
+        }
+      end
+
+      def set_application_specific_fields!(app)
+        unless @unable_to_prove_licence_possession_reason.nil?
+          app.data.unable_to_prove_licence_possession_reason = @unable_to_prove_licence_possession_reason
+        end
+
+        app.no_fee_application = true
+
+        if @eligibility_paper_to_plastic
+          app.data.customer_context[:applicationsEligibilityResponse][0][:availableActions].push({
+                                                                                                actionType: 'inform-paper-to-plastic',
+                                                                                                isRequired: true,
+                                                                                              })
+        end
+      end
+    end
+  end
+end

data/lib/dvla/application_helper/builders/V3/tyr_v3_application_builder.rb

@@ -0,0 +1,59 @@
+require_relative('../photo_signature_builder_mixin.rb')
+
+module DVLA
+  module Application
+    class TYRV3ApplicationBuilder < BaseUODLV3ApplicationBuilder
+      # Including all properties and methods needed to support photos
+      include DVLA::Application::PhotoBuilderMixin
+
+      def initialize
+        @no_fee_application = false
+        init_photo_properties
+        super
+      end
+
+      # The application will be a no fee application
+      # @param no_fee [Boolean] If the application should be no-fee. Defaults to true.
+      # @return [TYRV3ApplicationBuilder]
+      def set_no_fee_application(no_fee: true)
+        @no_fee_application = no_fee
+        self
+      end
+
+    # -- Overridden methods --
+    private
+
+      def application_images
+        generate_photo_images(@processable, @unique_images)
+      end
+
+      def application_customer_context
+        {
+          customerIntent: 'Ten year renewal',
+          transactionOutcome: 'Ten year renewal',
+          applicationsEligibilityResponse: [{
+                                              applicationType: 'update-ordinary-licence',
+                                              isRequired: true,
+                                              availableActions: [
+                                                actionType: 'update-photo',
+                                                isRequired: true,
+                                              ],
+                                            }],
+        }
+      end
+
+      def non_processable_application_factory
+        FM[:tyr_application]
+      end
+
+      def default_application_driver_id
+        Settings.test.driver_id.mandatory_tyr
+      end
+
+      def process_application_tasks(app)
+        process_photo_tasks(app) if @processable
+      end
+
+    end
+  end
+end