Merge pull request #1967 from alphagov/copy-of-answers

Add initial "Copy of answers" screen

Author: chao-xian

.review_apps/ecs_task_definition.tf

@@ -24,6 +24,7 @@ locals {
     { name = "SETTINGS__FORMS_ADMIN__BASE_URL", value = "https://${local.admin_app_hostname}" },
     { name = "SETTINGS__FORMS_API__BASE_URL", value = "http://localhost:3000" },
     { name = "SETTINGS__FORMS_ENV", value = "review" },
+    { name = "SETTINGS__FEATURES__FILLER_ANSWER_EMAIL_ENABLED", value = "true" }
 
     ##
     # Settings for AWS SES email sending, and S3 CSV submission and file upload

app/controllers/forms/check_your_answers_controller.rb

@@ -72,10 +72,14 @@ def setup_check_your_answers
     end
 
     def back_link
-      previous_step = current_context.previous_step(CheckYourAnswersStep::CHECK_YOUR_ANSWERS_PAGE_SLUG)
-
-      if previous_step.present?
-        previous_step.repeatable? ? add_another_answer_path(form_id: current_context.form.id, form_slug: current_context.form.form_slug, page_slug: previous_step.id) : form_page_path(current_context.form.id, current_context.form.form_slug, previous_step.id)
+      if FeatureService.enabled?("filler_answer_email_enabled")
+        copy_of_answers_path(form_id: current_context.form.id, form_slug: current_context.form.form_slug)
+      else
+        previous_step = current_context.previous_step(CheckYourAnswersStep::CHECK_YOUR_ANSWERS_PAGE_SLUG)
+
+        if previous_step.present?
+          previous_step.repeatable? ? add_another_answer_path(form_id: current_context.form.id, form_slug: current_context.form.form_slug, page_slug: previous_step.id) : form_page_path(current_context.form.id, current_context.form.form_slug, previous_step.id)
+        end
       end
     end
   end

app/controllers/forms/copy_of_answers_controller.rb

@@ -0,0 +1,49 @@
+module Forms
+  class CopyOfAnswersController < BaseController
+    before_action :redirect_if_feature_disabled
+
+    def show
+      return redirect_to form_page_path(current_context.form.id, current_context.form.form_slug, current_context.next_page_slug) unless can_visit_copy_of_answers?
+
+      @back_link = back_link
+      @copy_of_answers_input = CopyOfAnswersInput.new
+    end
+
+    def save
+      @copy_of_answers_input = CopyOfAnswersInput.new(copy_of_answers_params)
+
+      unless @copy_of_answers_input.valid?
+        @back_link = back_link
+        return render :show, status: :unprocessable_content
+      end
+
+      current_context.save_copy_of_answers_preference(@copy_of_answers_input.wants_copy?)
+
+      redirect_to check_your_answers_path(form_id: current_context.form.id, form_slug: current_context.form.form_slug)
+    end
+
+  private
+
+    def copy_of_answers_params
+      params.require(:copy_of_answers_input).permit(:copy_of_answers)
+    end
+
+    def can_visit_copy_of_answers?
+      current_context.can_visit?(CheckYourAnswersStep::CHECK_YOUR_ANSWERS_PAGE_SLUG)
+    end
+
+    def back_link
+      previous_step = current_context.previous_step(CheckYourAnswersStep::CHECK_YOUR_ANSWERS_PAGE_SLUG)
+
+      if previous_step.present?
+        previous_step.repeatable? ? add_another_answer_path(form_id: current_context.form.id, form_slug: current_context.form.form_slug, page_slug: previous_step.id) : form_page_path(current_context.form.id, current_context.form.form_slug, previous_step.id)
+      end
+    end
+
+    def redirect_if_feature_disabled
+      return if FeatureService.enabled?("filler_answer_email_enabled")
+
+      redirect_to check_your_answers_path(form_id: current_context.form.id, form_slug: current_context.form.form_slug)
+    end
+  end
+end

app/controllers/forms/page_controller.rb

@@ -148,7 +148,15 @@ def next_step_changing
     end
 
     def next_step_in_form_path
-      form_page_path(@form.id, @form.form_slug, @step.next_page_slug_after_routing)
+      if @step.next_page_slug_after_routing == CheckYourAnswersStep::CHECK_YOUR_ANSWERS_PAGE_SLUG
+        if FeatureService.enabled?("filler_answer_email_enabled")
+          copy_of_answers_path(form_id: @form.id, form_slug: @form.form_slug)
+        else
+          check_answers_path
+        end
+      else
+        form_page_path(@form.id, @form.form_slug, @step.next_page_slug_after_routing)
+      end
     end
 
     def check_answers_path

app/input_objects/copy_of_answers_input.rb

@@ -0,0 +1,18 @@
+class CopyOfAnswersInput
+  include ActiveModel::Model
+  include ActiveModel::Validations
+
+  attr_accessor :copy_of_answers
+
+  RADIO_OPTIONS = { yes: "yes", no: "no" }.freeze
+
+  validates :copy_of_answers, presence: true, inclusion: { in: RADIO_OPTIONS.values }
+
+  def wants_copy?
+    copy_of_answers == RADIO_OPTIONS[:yes]
+  end
+
+  def values
+    RADIO_OPTIONS.keys
+  end
+end

app/lib/flow/context.rb

@@ -12,7 +12,7 @@ def initialize(form:, store:)
     delegate :support_details, to: :form
     delegate :find_or_create, :previous_step, :next_page_slug, :next_step, :can_visit?, :completed_steps, :all_steps, to: :journey
     delegate :clear_stored_answer, :clear, :form_submitted?, :answers, :locales_used, to: :answer_store
-    delegate :save_submission_details, :get_submission_reference, :requested_email_confirmation?, :clear_submission_details, to: :confirmation_details_store
+    delegate :save_submission_details, :get_submission_reference, :requested_email_confirmation?, :clear_submission_details, :save_copy_of_answers_preference, :wants_copy_of_answers?, to: :confirmation_details_store
 
     def save_step(step, locale: :en, context: nil)
       return false unless step.valid?(context)

app/lib/store/confirmation_details_store.rb

@@ -3,6 +3,7 @@ class ConfirmationDetailsStore
     CONFIRMATION_KEY = :confirmation_details
     SUBMISSION_REFERENCE_KEY = :submission_reference
     REQUESTED_EMAIL_KEY = :requested_email_confirmation
+    COPY_OF_ANSWERS_KEY = :wants_copy_of_answers
 
     def initialize(store, form_id)
       @store = store
@@ -24,6 +25,15 @@ def requested_email_confirmation?
       @store.dig(CONFIRMATION_KEY, @form_key, REQUESTED_EMAIL_KEY.to_s)
     end
 
+    def save_copy_of_answers_preference(wants_copy)
+      @store[CONFIRMATION_KEY][@form_key] ||= {}
+      @store[CONFIRMATION_KEY][@form_key][COPY_OF_ANSWERS_KEY.to_s] = wants_copy
+    end
+
+    def wants_copy_of_answers?
+      @store.dig(CONFIRMATION_KEY, @form_key, COPY_OF_ANSWERS_KEY.to_s)
+    end
+
     def clear_submission_details
       @store[CONFIRMATION_KEY][@form_key] = nil
     end

app/views/forms/copy_of_answers/show.html.erb

@@ -0,0 +1,24 @@
+<% set_page_title(form_title(form_name: @current_context.form.name, page_name: t('.title'), mode: @mode, error: @copy_of_answers_input&.errors&.any?)) %>
+
+<% content_for :back_link do %>
+  <% if @back_link.present? %>
+    <%= link_to t("forms.back"), @back_link, class: "govuk-back-link" %>
+  <% end %>
+<% end %>
+
+<%= form_with(model: @copy_of_answers_input, method: :post, url: save_copy_of_answers_path(form_id: @form.id, form_slug: @form.form_slug)) do |f| %>
+  <div class="govuk-grid-row">
+    <div class="govuk-grid-column-two-thirds">
+      <% if @copy_of_answers_input&.errors&.any? %>
+        <%= f.govuk_error_summary(t("error_summary_title")) %>
+      <% end %>
+
+      <%= f.govuk_collection_radio_buttons :copy_of_answers,
+        @copy_of_answers_input.values, ->(option) { option }, ->(option) { t("helpers.label.copy_of_answers_input.options.#{option}") },
+        legend: { text: t('.heading'), tag: 'h1', size: 'l' },
+        hint: { text: t('.hint') } %>
+
+      <%= f.govuk_submit(t("continue")) %>
+    </div>
+  </div>
+<% end %>

config/locales/cy.yml

@@ -83,6 +83,10 @@ cy:
             add_another_answer:
               blank: Dewiswch ydw os ydych angen ychwanegu ateb arall
               max_answers_reached: Dewiswch ydw os ydych angen ychwanegu ateb arall
+        copy_of_answers_input:
+          attributes:
+            copy_of_answers:
+              blank: PLACEHOLDER! Dewiswch ydw os hoffech dderbyn copi o'ch atebion
         email_confirmation_input:
           attributes:
             confirmation_email_address:
@@ -378,6 +382,11 @@ cy:
         view_english_form: 'Gallwch lenwi’r ffurflen yn Saesneg o hyd:'
         welsh_version_archived: Mae’r fersiwn Gymraeg o’r ffurflen hon wedi’i harchifo ac nid yw ar gael mwyach.
     back: Yn ôl
+    copy_of_answers:
+      show:
+        heading: PLACEHOLDER! Ydych chi eisiau copi o'ch atebion?
+        hint: PLACEHOLDER! Byddwn ond yn defnyddio'r cyfeiriad e-bost rydych yn ei ddarparu yma i anfon cadarnhad bod eich ffurflen wedi'i chyflwyno'n llwyddiannus. Ni fydd yn cynnwys copi o'ch atebion.
+        title: PLACEHOLDER! Ydych chi eisiau copi o'ch atebion?
     remove_answer:
       show:
         address_heading: Dileu cyfeiriad
@@ -414,6 +423,10 @@ cy:
         options:
           'no': Na
           'yes': Ydw
+      copy_of_answers_input:
+        options:
+          'no': Na
+          'yes': Ydw
       email_confirmation_input:
         confirmation_email_address: Pa gyfeiriad e-bost ydych chi eisiau i ni anfon eich cadarnhad ato?
         send_confirmation_options:

config/locales/en.yml

@@ -83,6 +83,10 @@ en:
             add_another_answer:
               blank: Select ‘Yes’ if you need to add another answer
               max_answers_reached: You cannot add another answer
+        copy_of_answers_input:
+          attributes:
+            copy_of_answers:
+              blank: Select 'Yes' if you want to get a copy of your answers
         email_confirmation_input:
           attributes:
             confirmation_email_address:
@@ -378,6 +382,11 @@ en:
         view_english_form: 'You can still complete the form in English:'
         welsh_version_archived: The Welsh version of this form has been archived and is no longer available.
     back: Back
+    copy_of_answers:
+      show:
+        heading: Do you want to get an email with a copy of your answers?
+        hint: You’ll need a GOV.UK One Login for this - you’ll be able to create one now if you do not already have one.
+        title: Do you want a copy of your answers?
     remove_answer:
       show:
         address_heading: Remove an address
@@ -414,6 +423,10 @@ en:
         options:
           'no': 'No'
           'yes': 'Yes'
+      copy_of_answers_input:
+        options:
+          'no': 'No'
+          'yes': 'Yes'
       email_confirmation_input:
         confirmation_email_address: What email address do you want us to send your confirmation to?
         send_confirmation_options: