Navigator FE

app/assets/stylesheets/components/button_to.scss

@@ -1,11 +1,15 @@
+.one-login-header__nav__link.button-to-as-link {
+  color: inherit;
+}
+
 .button-to-as-link {
   padding: 0;
   background: none;
   border: none;
   outline: none;
   box-shadow: none;
 
-  color: inherit;
+  color: #1d70b8;
   font-family: inherit;
   font-size: inherit;
   line-height: inherit;

app/controllers/claims_controller.rb

@@ -4,6 +4,7 @@ class ClaimsController < BasePublicController
   skip_before_action :send_unstarted_claimants_to_the_start, only: [:new, :create]
   before_action :initialize_session_slug_history
   before_action :check_page_is_in_sequence, only: [:show, :update]
+  before_action :check_page_is_permissible, only: [:show]
   before_action :set_backlink_path, only: [:show, :update]
   before_action :check_claim_not_in_progress, only: [:new]
   before_action :clear_claim_session, only: [:new], unless: -> { journey.start_with_magic_link? }
@@ -35,7 +36,41 @@ def start_new
 
   private
 
-  delegate :slugs, :current_slug, :previous_slug, :next_slug, :next_required_slug, to: :page_sequence
+  delegate :slugs, :next_required_slug, to: :page_sequence
+
+  def navigator
+    @navigator ||= Journeys::Navigator.new(
+      current_slug: params[:slug],
+      slug_sequence: page_sequence.slug_sequence,
+      params:,
+      session:
+    )
+  end
+  helper_method :navigator
+
+  def current_slug
+    if journey.use_navigator?
+      params[:slug]
+    else
+      page_sequence.current_slug
+    end
+  end
+
+  def next_slug
+    if journey.use_navigator?
+      navigator.next_slug
+    else
+      page_sequence.next_slug
+    end
+  end
+
+  def previous_slug
+    if journey.use_navigator?
+      navigator.previous_slug
+    else
+      page_sequence.previous_slug
+    end
+  end
 
   def redirect_to_existing_claim_journey
     # If other journey sessions is empty, then the claimant has hit the landing
@@ -74,6 +109,8 @@ def persist_claim
   end
 
   def check_page_is_in_sequence
+    return if journey.use_navigator?
+
     unless correct_journey_for_claim_in_progress?
       clear_claim_session
       return redirect_to new_claim_path(request.query_parameters)
@@ -84,11 +121,21 @@ def check_page_is_in_sequence
     redirect_to claim_path(current_journey_routing_name, next_required_slug) unless page_sequence.has_completed_journey_until?(params[:slug])
   end
 
+  def check_page_is_permissible
+    return unless journey.use_navigator?
+
+    unless navigator.permissible_slug?
+      redirect_to claim_path(current_journey_routing_name, navigator.furthest_permissible_slug)
+    end
+  end
+
   def initialize_session_slug_history
     session[:slugs] ||= []
   end
 
   def update_session_with_current_slug
+    return if journey.use_navigator?
+
     if @form.nil? || @form.valid?
       session[:slugs] << params[:slug] unless Journeys::PageSequence::DEAD_END_SLUGS.include?(params[:slug])
     else

app/forms/email_verification_form.rb

@@ -8,7 +8,7 @@ class EmailVerificationForm < Form
   validate :otp_must_be_valid, if: :sent_one_time_password_at?
 
   before_validation do
-    self.one_time_password = one_time_password.gsub(/\D/, "")
+    self.one_time_password = (one_time_password || "").gsub(/\D/, "")
   end
 
   def save

app/forms/journeys/further_education_payments/check_your_answers_part_one_form.rb

@@ -0,0 +1,9 @@
+module Journeys
+  module FurtherEducationPayments
+    class CheckYourAnswersPartOneForm < Form
+      def save
+        true
+      end
+    end
+  end
+end

app/forms/journeys/further_education_payments/information_provided_form.rb

@@ -0,0 +1,9 @@
+module Journeys
+  module FurtherEducationPayments
+    class InformationProvidedForm < Form
+      def save
+        true
+      end
+    end
+  end
+end

app/forms/journeys/further_education_payments/select_provision_form.rb

@@ -13,12 +13,15 @@ def save
         return unless valid?
 
         journey_session.answers.assign_attributes(
-          possible_school_id:,
           school_id: possible_school_id
         )
         journey_session.save!
       end
 
+      def completed?
+        journey_session.answers.school_id.present?
+      end
+
       private
 
       def results

app/forms/mobile_verification_form.rb

@@ -7,7 +7,7 @@ class MobileVerificationForm < Form
   validate :otp_validate
 
   before_validation do
-    self.one_time_password = one_time_password.gsub(/\D/, "")
+    self.one_time_password = (one_time_password || "").gsub(/\D/, "")
   end
 
   def save

app/forms/postcode_search_form.rb

@@ -1,17 +1,36 @@
 class PostcodeSearchForm < Form
   attribute :postcode, :string
+  attribute :skip_postcode_search, :boolean
 
-  validates :postcode, presence: {message: "Enter a real postcode"}, length: {maximum: 11, message: "Postcode must be 11 characters or less"}
-  validate :postcode_is_valid, if: -> { postcode.present? }
-  validate :postcode_has_address, if: -> { postcode.present? }
+  validates :postcode,
+    presence: {message: "Enter a real postcode"},
+    length: {maximum: 11, message: "Postcode must be 11 characters or less"},
+    if: -> { !skip_postcode_search? }
+
+  validate :postcode_is_valid, if: -> { !skip_postcode_search? && postcode.present? }
+  validate :postcode_has_address, if: -> { !skip_postcode_search && postcode.present? }
 
   def save
     return false if invalid?
 
-    journey_session.answers.assign_attributes(postcode:)
+    if skip_postcode_search
+      journey_session.answers.assign_attributes(skip_postcode_search:)
+    else
+      journey_session.answers.assign_attributes(skip_postcode_search: false)
+      journey_session.answers.assign_attributes(postcode:)
+    end
+
     journey_session.save!
   end
 
+  def completed?
+    journey_session.answers.skip_postcode_search || journey_session.answers.ordnance_survey_error
+  end
+
+  def skip_postcode_search?
+    skip_postcode_search
+  end
+
   private
 
   def address_data

app/forms/select_home_address_form.rb

@@ -3,7 +3,8 @@ class SelectHomeAddressForm < Form
   attribute :address_line_1, :string
   attribute :postcode, :string
 
-  validates :address, presence: true
+  validates :address, presence: true, unless: -> { skip_postcode_search? }
+  validate :address_selected, if: -> { skip_postcode_search? }
 
   def address_data
     return [] if postcode.blank?
@@ -29,4 +30,18 @@ def save
 
     journey_session.save!
   end
+
+  def completed?
+    skip_postcode_search? || valid?
+  end
+
+  private
+
+  def skip_postcode_search?
+    journey_session.answers.skip_postcode_search
+  end
+
+  def address_selected
+    errors.add(:address) if journey_session.answers.address_line_1.blank?
+  end
 end

app/models/journeys/base.rb

@@ -37,11 +37,19 @@ def slug_sequence
     end
 
     def form(journey_session:, params:, session:)
-      form = SHARED_FORMS.deep_merge(forms).dig(params[:controller].split("/").last, params[:slug])
+      form = all_forms.dig(params[:controller].split("/").last, params[:slug])
 
       form&.new(journey: self, journey_session:, params:, session:)
     end
 
+    def form_class_for_slug(slug:)
+      all_forms.dig("claims", slug)
+    end
+
+    def slug_for_form(form:)
+      all_forms["claims"].invert[form.class]
+    end
+
     def forms
       defined?(self::FORMS) ? self::FORMS : {}
     end
@@ -78,5 +86,15 @@ def journey_name
     def pii_attributes
       SessionAnswers.pii_attributes
     end
+
+    def use_navigator?
+      false
+    end
+
+    private
+
+    def all_forms
+      SHARED_FORMS.deep_merge(forms)
+    end
   end
 end

app/models/journeys/further_education_payments.rb

@@ -26,6 +26,8 @@ module FurtherEducationPayments
         "engineering-manufacturing-courses" => EngineeringManufacturingCoursesForm,
         "maths-courses" => MathsCoursesForm,
         "physics-courses" => PhysicsCoursesForm,
+        "check-your-answers-part-one" => CheckYourAnswersPartOneForm,
+        "information-provided" => InformationProvidedForm,
         "teaching-qualification" => TeachingQualificationForm,
         "poor-performance" => PoorPerformanceForm,
         "check-your-answers" => CheckYourAnswersForm,
@@ -40,5 +42,9 @@ module FurtherEducationPayments
     def requires_student_loan_details?
       true
     end
+
+    def use_navigator?
+      true
+    end
   end
 end

app/models/journeys/further_education_payments/slug_sequence.rb

@@ -115,16 +115,46 @@ def slugs
             sequence.delete("physics-courses")
           end
 
+          if answers.school_id.present?
+            sequence.delete("select-provision")
+          end
+
+          if answers.email_verified == true
+            sequence.delete("email-verification")
+          end
+
           if answers.provide_mobile_number == false
             sequence.delete("mobile-number")
             sequence.delete("mobile-verification")
           end
 
+          if answers.mobile_verified == true
+            sequence.delete("mobile-verification")
+          end
+
           if answers.ordnance_survey_error == true
             sequence.delete("select-home-address")
           end
+
+          if answers.skip_postcode_search == true
+            sequence.delete("select-home-address")
+          end
+
+          if !eligibility_checker.ineligible?
+            sequence.delete("ineligible")
+          end
         end
       end
+
+      private
+
+      def eligibility_checker
+        @eligibility_checker ||= journey::EligibilityChecker.new(journey_session:)
+      end
+
+      def journey
+        Journeys.for_routing_name(journey_session.journey)
+      end
     end
   end
 end