LG-15440 We couldnt find records matching your address screen (#12066)

* add address errors page

* add address proofing exception redirect

* add changelog

changelog: User-Facing Improvements, Doc Auth, add we couldnt find your address screen

* linty mclinterson

* refactor rate limiter code in session_errors_controller

* rename rate limiter to resolution_rate_limiter

* changed to resolution result instead of residential_resolution_result

* add address_exception to resolution result

* move address fail check to verify_info_concern

* linty mclinterson

* rate limiter fixups

* redirect to address warning if there is ONLY an address exception

* lint fix

Author: theabrad

app/controllers/concerns/idv/verify_info_concern.rb

@@ -79,6 +79,23 @@ def ssn_rate_limiter
       )
     end
 
+    def address_exception?(result)
+      result.extra.dig(
+        :proofing_results,
+        :context,
+        :stages,
+        :resolution,
+        :exception,
+      ).present? &&
+        result.extra.dig(
+          :proofing_results,
+          :context,
+          :stages,
+          :resolution,
+          :attributes_requiring_additional_verification,
+        ) == ['address']
+    end
+
     def idv_failure(result)
       proofing_results_exception = result.extra.dig(:proofing_results, :exception)
       has_exception = proofing_results_exception.present?
@@ -89,6 +106,7 @@ def idv_failure(result)
         :state_id,
         :mva_exception,
       ).present?
+      is_address_exception = address_exception?(result)
       is_threatmetrix_exception = result.extra.dig(
         :proofing_results,
         :context,
@@ -113,6 +131,9 @@ def idv_failure(result)
       elsif has_exception && is_mva_exception
         idv_failure_log_warning
         redirect_to state_id_warning_url
+      elsif has_exception && is_address_exception
+        idv_failure_log_address_warning
+        redirect_to address_warning_url
       elsif (has_exception && is_threatmetrix_exception) ||
             (!has_exception && resolution_failed)
         idv_failure_log_warning
@@ -147,6 +168,13 @@ def idv_failure_log_error
       )
     end
 
+    def idv_failure_log_address_warning
+      analytics.idv_doc_auth_address_warning_visited(
+        step_name: STEP_NAME,
+        remaining_submit_attempts: resolution_rate_limiter.remaining_count,
+      )
+    end
+
     def idv_failure_log_warning
       analytics.idv_doc_auth_warning_visited(
         step_name: STEP_NAME,
@@ -166,6 +194,10 @@ def state_id_warning_url
       idv_session_errors_state_id_warning_url(flow: flow_param)
     end
 
+    def address_warning_url
+      idv_session_errors_address_warning_url(flow: flow_param)
+    end
+
     def warning_url
       idv_session_errors_warning_url(flow: flow_param)
     end

app/controllers/idv/session_errors_controller.rb

@@ -16,28 +16,26 @@ def exception
     end
 
     def warning
-      rate_limiter = RateLimiter.new(
-        user: idv_session_user,
-        rate_limit_type: :idv_resolution,
-      )
-
       @step_indicator_steps = step_indicator_steps
-      @remaining_submit_attempts = rate_limiter.remaining_count
-      log_event(based_on_limiter: rate_limiter)
+      @remaining_submit_attempts = resolution_rate_limiter.remaining_count
+      log_event(based_on_limiter: resolution_rate_limiter)
     end
 
     def state_id_warning
       log_event
     end
 
+    def address_warning
+      @step_indicator_steps = step_indicator_steps
+      @address_path = idv_address_url
+      @remaining_submit_attempts = resolution_rate_limiter.remaining_count
+      log_event(based_on_limiter: resolution_rate_limiter)
+    end
+
     def failure
-      rate_limiter = RateLimiter.new(
-        user: idv_session_user,
-        rate_limit_type: :idv_resolution,
-      )
-      @expires_at = rate_limiter.expires_at
+      @expires_at = resolution_rate_limiter.expires_at
       @sp_name = decorated_sp_session.sp_name
-      log_event(based_on_limiter: rate_limiter)
+      log_event(based_on_limiter: resolution_rate_limiter)
     end
 
     def ssn_failure
@@ -63,6 +61,13 @@ def rate_limited
 
     private
 
+    def resolution_rate_limiter
+      @resolution_rate_limiter ||= RateLimiter.new(
+        user: idv_session_user,
+        rate_limit_type: :idv_resolution,
+      )
+    end
+
     def confirm_two_factor_authenticated_or_user_id_in_session
       return if session[:doc_capture_user_id].present?
 

app/services/analytics_events.rb

@@ -1226,6 +1226,18 @@ def idv_consent_checkbox_toggled(checked:, **extra)
     )
   end
 
+  # @param [String] step_name
+  # @param [Integer] remaining_submit_attempts (previously called "remaining_attempts")
+  # The user was sent to a warning page during the IDV flow
+  def idv_doc_auth_address_warning_visited(step_name:, remaining_submit_attempts:, **extra)
+    track_event(
+      :idv_doc_auth_address_warning_visited,
+      step_name: step_name,
+      remaining_submit_attempts: remaining_submit_attempts,
+      **extra,
+    )
+  end
+
   # User has consented to share information with document upload and may
   # view the "hybrid handoff" step next unless "skip_hybrid_handoff" param is true
   # @param [Boolean] success Whether form validation was successful

app/views/idv/session_errors/address_warning.html.erb

@@ -0,0 +1,26 @@
+<% self.title = t('titles.failure.information_not_verified') %>
+
+<% content_for(:pre_flash_content) do %>
+  <%= render StepIndicatorComponent.new(
+        steps: @step_indicator_steps,
+        current_step: :verify_info,
+        locale_scope: 'idv',
+        class: 'margin-x-neg-2 margin-top-neg-4 tablet:margin-x-neg-6 tablet:margin-top-neg-4',
+      ) %>
+<% end %>
+
+<%= render StatusPageComponent.new(status: :warning) do |c| %>
+  <% c.with_header { t('idv.warning.address.heading') } %>
+
+  <p><%= t('idv.failure.address.warning') %></p>
+  <p><%= t('idv.failure.attempts_html', count: @remaining_submit_attempts) %></p>
+
+  <% c.with_action_button(
+       url: @address_path,
+       class: 'margin-bottom-2',
+     ) { t('idv.forgot_password.try_again') } %>
+<% end %>
+
+<%= render PageFooterComponent.new do %>
+  <%= link_to t('links.cancel'), idv_cancel_path(step: :invalid_session) %>
+<% end %>

config/locales/en.yml

@@ -1060,6 +1060,7 @@ idv.errors.pattern_mismatch.zipcode: Enter a 5 or 9 digit ZIP Code
 idv.errors.pattern_mismatch.zipcode_five: Enter a 5 digit ZIP Code
 idv.errors.technical_difficulties: We are having technical difficulties
 idv.errors.try_again_later: Try again later.
+idv.failure.address.warning: Please check the information you entered and try again. If your mailing address is different than your residential address, try entering the address where you currently live.
 idv.failure.attempts_html.one: You can try <strong>1 more time.</strong> Then you must wait 6 hours before trying again.
 idv.failure.attempts_html.other: You can try <strong>%{count} more times.</strong> Then you must wait 6 hours before trying again.
 idv.failure.button.try_online: Try again online
@@ -1205,6 +1206,7 @@ idv.unavailable.idv_explanation.without_sp: The agency that you are trying to ac
 idv.unavailable.next_steps_html: '%{status_page_link_html} or exit %{app_name} and try again later.'
 idv.unavailable.status_page_link: Get updates on our status page
 idv.unavailable.technical_difficulties: Unfortunately, we are having technical difficulties and cannot verify your identity at this time.
+idv.warning.address.heading: We couldn’t find records matching your address
 idv.warning.sessions.heading: We couldn’t find records matching your personal information
 idv.warning.state_id.cancel_button: Exit %{app_name}
 idv.warning.state_id.explanation: Unfortunately, we’re experiencing technical difficulties with IDs from your state and are currently unable to verify your information.

config/locales/es.yml

@@ -1071,6 +1071,7 @@ idv.errors.pattern_mismatch.zipcode: Ingrese un código postal de 5 o 9 dígitos
 idv.errors.pattern_mismatch.zipcode_five: Ingrese un código postal de 5 dígitos.
 idv.errors.technical_difficulties: Estamos teniendo problemas técnicos
 idv.errors.try_again_later: Vuelva a intentarlo más tarde.
+idv.failure.address.warning: Revise la información que ingresó y vuelva a intentarlo. Si su dirección postal no es igual que su domicilio, intente ingresar la dirección donde vive actualmente.
 idv.failure.attempts_html.one: Puede intentarlo <strong>una vez más.</strong> Luego debe esperar 6 horas antes de volver a intentarlo.
 idv.failure.attempts_html.other: Puede intentarlo <strong>%{count} veces más.</strong> Luego debe esperar 6 horas antes de volver a intentarlo.
 idv.failure.button.try_online: Vuelva a intentarlo en línea
@@ -1216,6 +1217,7 @@ idv.unavailable.idv_explanation.without_sp: La agencia a la que está intentando
 idv.unavailable.next_steps_html: '%{status_page_link_html} o salga de %{app_name} y vuelva a intentarlo más tarde.'
 idv.unavailable.status_page_link: Obtenga las actualizaciones en nuestra página de estado
 idv.unavailable.technical_difficulties: Lamentablemente, tenemos problemas técnicos y no podemos verificar su identidad en este momento.
+idv.warning.address.heading: No encontramos registros que coincidan con su dirección
 idv.warning.sessions.heading: No encontramos registros que coincidan con sus datos personales
 idv.warning.state_id.cancel_button: Salir de %{app_name}
 idv.warning.state_id.explanation: Lamentablemente, tenemos problemas técnicos con las identificaciones de su estado y no podemos verificar su información en este momento.

config/locales/fr.yml

@@ -1060,6 +1060,7 @@ idv.errors.pattern_mismatch.zipcode: Saisissez un code postal à 5 ou 9 chiffres
 idv.errors.pattern_mismatch.zipcode_five: Saisissez un code postal à 5 chiffres
 idv.errors.technical_difficulties: Nous rencontrons des difficultés techniques
 idv.errors.try_again_later: Veuillez réessayer ultérieurement.
+idv.failure.address.warning: Veuillez vérifier les informations que vous avez saisies et réessayer. Si votre adresse postale est différente de votre adresse personnelle, veuillez saisir l’adresse où vous résidez actuellement.
 idv.failure.attempts_html.one: Vous avez encore <strong>un essai.</strong> Vous devrez ensuite attendre 6 heures avant de réessayer.
 idv.failure.attempts_html.other: Vous pouvez encore essayer <strong>%{count} fois de plus.</strong> Ensuite vous devrez ensuite attendre 6 heures avant de réessayer.
 idv.failure.button.try_online: Réessayer en ligne
@@ -1205,6 +1206,7 @@ idv.unavailable.idv_explanation.without_sp: L’organisme auquel vous essayez d
 idv.unavailable.next_steps_html: '%{status_page_link_html} ou quittez le site %{app_name} et réessayez plus tard.'
 idv.unavailable.status_page_link: Obtenir les dernières informations sur notre page d’état des systèmes.
 idv.unavailable.technical_difficulties: Malheureusement, nous rencontrons des difficultés techniques et ne pouvons pas vérifier votre identité pour le moment.
+idv.warning.address.heading: Nous n’avons pas trouvé d’informations correspondant à votre adresse
 idv.warning.sessions.heading: Nous n’avons pas trouvé de dossiers correspondant à vos informations personnelles
 idv.warning.state_id.cancel_button: Quitter %{app_name}
 idv.warning.state_id.explanation: Malheureusement, nous rencontrons des difficultés techniques avec les pièces d’identité de votre État et ne sommes pas en mesure de vérifier vos informations pour le moment.

config/locales/zh.yml

@@ -1073,6 +1073,7 @@ idv.errors.pattern_mismatch.zipcode: 输入 5 或 9 位的邮编
 idv.errors.pattern_mismatch.zipcode_five: 输入 5 位的邮编
 idv.errors.technical_difficulties: 我们目前遇到技术困难
 idv.errors.try_again_later: 请稍后再试。
+idv.failure.address.warning: 请检查一下你输入的信息，然后再试一下。如果你的邮寄地址与居住地址不同，请尝试输入你目前居住的地址。
 idv.failure.attempts_html.one: 您可以再试<strong>1次。</strong> 然后您必须等6个小时才能再试。
 idv.failure.attempts_html.other: 您可以再试<strong>%{count}次。</strong> 然后您必须等6个小时才能再试。
 idv.failure.button.try_online: 在网上再试一下
@@ -1218,6 +1219,7 @@ idv.unavailable.idv_explanation.without_sp: 你试图访问的机构需要确保
 idv.unavailable.next_steps_html: '%{status_page_link_html} 或者退出 %{app_name}，稍后再试。'
 idv.unavailable.status_page_link: 在我们的状态页面获得最新信息。
 idv.unavailable.technical_difficulties: 很遗憾，我们这边现在遇到技术困难，目前无法验证你的身份。
+idv.warning.address.heading: 我们找不到与你地址匹配的记录
 idv.warning.sessions.heading: 我们找不到与你个人信息匹配的记录
 idv.warning.state_id.cancel_button: 退出 %{app_name}
 idv.warning.state_id.explanation: 遗憾的是，处理来自你所在州的身份证件时我们遇到技术困难，目前无法验证你的信息。

config/routes.rb

@@ -425,6 +425,7 @@
       put '/enter_password' => 'enter_password#create'
       get '/session/errors/warning' => 'session_errors#warning'
       get '/session/errors/state_id_warning' => 'session_errors#state_id_warning'
+      get '/session/errors/address_warning' => 'session_errors#address_warning'
       get '/session/errors/failure' => 'session_errors#failure'
       get '/session/errors/ssn_failure' => 'session_errors#ssn_failure'
       get '/session/errors/exception' => 'session_errors#exception'

spec/controllers/idv/session_errors_controller_spec.rb

@@ -234,6 +234,68 @@
     end
   end
 
+  describe '#address_warning' do
+    let(:action) { :address_warning }
+    let(:template) { 'idv/session_errors/address_warning' }
+
+    subject(:response) { get action }
+    it_behaves_like 'an idv session errors controller action'
+
+    context 'with rate limit attempts' do
+      let(:user) { create(:user) }
+
+      before do
+        RateLimiter.new(rate_limit_type: :idv_resolution, user: user).increment!
+      end
+
+      it 'assigns remaining count' do
+        response
+
+        expect(assigns(:remaining_submit_attempts)).to be_kind_of(Numeric)
+      end
+
+      it 'assigns URL to try again' do
+        response
+
+        expect(assigns(:address_path)).to eq(idv_address_url)
+      end
+
+      it 'logs an event with attempts remaining' do
+        response
+
+        expect(@analytics).to have_logged_event(
+          'IdV: session error visited',
+          type: action.to_s,
+          remaining_submit_attempts: IdentityConfig.store.idv_max_attempts - 1,
+        )
+      end
+    end
+
+    context 'while rate limited' do
+      let(:user) { create(:user) }
+
+      before do
+        RateLimiter.new(rate_limit_type: :idv_resolution, user: user).increment_to_limited!
+      end
+
+      it 'assigns expiration time' do
+        get action
+
+        expect(assigns(:expires_at)).not_to eq(Time.zone.now)
+      end
+
+      it 'logs an event with attempts remaining' do
+        get action
+
+        expect(@analytics).to have_logged_event(
+          'IdV: session error visited',
+          type: 'address_warning',
+          remaining_submit_attempts: 0,
+        )
+      end
+    end
+  end
+
   describe '#failure' do
     let(:action) { :failure }
     let(:template) { 'idv/session_errors/failure' }