Merge pull request #738 from bitzesty/ll-guidance

chore: Update KAVS local assessment guide link to 2025 version

app/models/award_year.rb

@@ -8,7 +8,7 @@ class AwardYear < ApplicationRecord
 
   after_create :create_settings
 
-  AVAILABLE_YEARS = [2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025]
+  AVAILABLE_YEARS = [2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026]
 
   DEFAULT_FINANCIAL_DEADLINE_DAY = 17
   DEFAULT_FINANCIAL_DEADLINE_MONTH = 9

app/models/form_answer.rb

@@ -2,6 +2,7 @@
 require_relative '../../forms/award_years/v2023/qae_forms'
 require_relative '../../forms/award_years/v2024/qae_forms'
 require_relative '../../forms/award_years/v2025/qae_forms'
+require_relative '../../forms/award_years/v2026/qae_forms'
 
 class FormAnswer < ApplicationRecord
 include Statesman::Adapters::ActiveRecordQueries[
@@ -157,7 +158,7 @@ def award_form
         elsif self.class.const_defined?(award_form_class_name(year))
           self.class.const_get(award_form_class_name(year))
         else
-          AwardYears::V2025::QaeForms # default value
+          AwardYears::V2026::QaeForms # default value
         end
       else
         raise ArgumentError, "Can not find award form for the nomination in year: #{award_year.year}"
@@ -438,7 +439,7 @@ def award_form_class_name(year)
   end
 
   def dismiss_support_letters(attributes)
-    %w(first_name last_name relationship_to_nominee).all? { |attr| attributes[attr].blank? } 
+    %w(first_name last_name relationship_to_nominee).all? { |attr| attributes[attr].blank? }
   end
 
   def self.transition_class

app/views/lieutenant/dashboard/index.html.slim

@@ -14,7 +14,7 @@
       p.govuk-body You can download the local assessment guide, which provides helpful tips on approaching the assessment and completing your report.
       .govuk-body
         = link_to "Download KAVS local assessment guide (PDF)",
-                  "https://storage.googleapis.com/lord-lieutenant-guidance/KAVS%20Guidance%20for%20LLs%202024.pdf",
+                  "https://storage.googleapis.com/lord-lieutenant-guidance/KAVS%20Guidance%20for%20LLs%202025.pdf",
                   class: "download-link govuk-link govuk-link--no-visited-state",
                   rel: "noreferrer noopener",
                   target: :_blank

forms/appraisal_form.rb

@@ -4,7 +4,7 @@ class AppraisalForm
   #
   # THIS NEED TO BE UPDATED EACH YEAR
   #
-  SUPPORTED_YEARS = [2022, 2023, 2024, 2025]
+  SUPPORTED_YEARS = [2022, 2023, 2024, 2025, 2026]
 
   EVALUATION_OPTIONS_2022 = [
     ["Weak evidence", "weak"],
@@ -30,6 +30,12 @@ class AppraisalForm
     ["Strong evidence", "strong"]
   ]
 
+  EVALUATION_OPTIONS_2026 = [
+    ["Weak evidence", "weak"],
+    ["Good evidence", "good"],
+    ["Strong evidence", "strong"]
+  ]
+
   VERDICT_OPTIONS_2022 = [
     ["Not Recommended", "not_recommended"],
     ["Recommended", "recommended"],
@@ -54,6 +60,12 @@ class AppraisalForm
     ["Undecided", "undecided"]
   ]
 
+  VERDICT_OPTIONS_2026 = [
+    ["Not Recommended", "not_recommended"],
+    ["Recommended", "recommended"],
+    ["Undecided", "undecided"]
+  ]
+
   def self.evaluation_options_for(object, section)
     options = const_get("EVALUATION_OPTIONS_#{object.award_year.year}")
 
@@ -204,10 +216,39 @@ def self.verdict_options_for(object, section)
     }
   }.freeze
 
+  QAVS_2026 = {
+    good_impact: {
+      type: :rag,
+      label: "Good impact",
+      position: 0
+    },
+    volunteer_led: {
+      type: :rag,
+      label: "Volunteer-led",
+      position: 1
+    },
+    good_governance: {
+      type: :rag,
+      label: "Good governance",
+      position: 2
+    },
+    exceptional_qualities: {
+      type: :rag,
+      label: "Exceptional qualities",
+      position: 3
+    },
+    verdict: {
+      type: :verdict,
+      label: "Overall decision",
+      position: 4
+    }
+  }.freeze
+
   ALL_FORMS_2022 = [QAVS_2022]
   ALL_FORMS_2023 = [QAVS_2023]
   ALL_FORMS_2024 = [QAVS_2024]
   ALL_FORMS_2025 = [QAVS_2025]
+  ALL_FORMS_2026 = [QAVS_2026]
 
   def self.rate(key)
     "#{key}_rate"

forms/award_years/v2026/qae_forms.rb

@@ -0,0 +1,4 @@
+require_relative 'qavs'
+
+class AwardYears::V2026::QaeForms
+end

forms/award_years/v2026/qavs.rb

@@ -0,0 +1,30 @@
+require_relative "qavs/qavs_step1"
+require_relative "qavs/qavs_step2"
+require_relative "qavs/qavs_step3"
+require_relative "qavs/qavs_step4"
+require_relative "qavs/qavs_step5"
+
+class AwardYears::V2026::QaeForms
+  class << self
+    def qavs
+      @qavs ||= QaeFormBuilder.build "King's Award for Voluntary Service Nomination" do
+        step "nominee",
+             &AwardYears::V2026::QaeForms.qavs_step1
+
+        step "recommendation",
+             &AwardYears::V2026::QaeForms.qavs_step2
+
+        step "letters_of_support",
+             { id: :letters_of_support_step },
+             &AwardYears::V2026::QaeForms.qavs_step3
+
+        step "submit_step",
+             &AwardYears::V2026::QaeForms.qavs_step4
+
+        step "local_assessment_form",
+             { id: :local_assessment },
+             &AwardYears::V2026::QaeForms.qavs_step5
+      end
+    end
+  end
+end

forms/award_years/v2026/qavs/qavs_step1.rb

@@ -0,0 +1,117 @@
+# coding: utf-8
+class AwardYears::V2026::QaeForms
+  class << self
+    def qavs_step1
+      @qavs_step1 ||= proc do
+        notice %(
+          <p class=govuk-body>Please note your answers are being saved automatically in the background.</p>
+        )
+
+        header :nominee_details_header, "Group details" do
+          ref "A 1"
+        end
+
+        text :nominee_name, "Name of group" do
+          sub_ref "A 1.1"
+          required
+          form_hint "<strong>It is important that the name is accurate, concise and spelt correctly</strong>, as this will appear on the Award certificate if your nomination succeeds. <strong>Please do not</strong> capitalise the group's name, include charity numbers, or include special characters.".html_safe
+          style "large"
+        end
+
+        text :nominee_established_date, "When was the group established?" do
+          sub_ref "A 1.2"
+          required
+          style "small"
+        end
+
+        dropdown :nominee_activity, "Please select the group's main area of activity" do
+          sub_ref "A 1.3"
+          required
+          option "", ""
+          nominee_activities
+        end
+
+        dropdown :secondary_activity, "Please select the group's secondary area of activity" do
+          sub_ref "A 1.4"
+          required
+          option "", ""
+          nominee_activities
+        end
+
+        address :nominee_address, "Address of group" do
+          sub_ref "A 1.5"
+          required
+          sub_fields([
+            { building: "Building" },
+            { street: "Street" },
+            { city: "Town or city" },
+            { county: "County" },
+            { postcode: "Postcode" }
+          ])
+        end
+
+        text :nominee_phone, "Telephone number" do
+          sub_ref "A 1.6"
+          style "small"
+          type "tel"
+        end
+
+        text :nominee_website, "Website" do
+          sub_ref "A 1.7"
+          style "large"
+        end
+
+        textarea :social_media, "Social media" do
+          sub_ref "A 1.8"
+          form_hint "If known, please insert a link to the group's social media below (Facebook, Instagram, Twitter, Linkedin)"
+          words_max 100
+          rows 2
+        end
+
+        header :nominee_leader_header, "About the group leader or main contact in the group" do
+          ref "A 2"
+          context %(
+            <p class='govuk-hint'>This is the person the County Assessment Panel will contact to ask any questions or arrange a visit.</p>
+          )
+        end
+
+        text :nominee_leader_name, "Name of the group leader or main contact in the group" do
+          sub_ref "A 2.1"
+          required
+          style "small"
+        end
+
+        text :nominee_leader_position, "Position held in the group" do
+          sub_ref "A 2.2"
+          required
+          style "large"
+        end
+
+        address :nominee_leader_address, "Address of main contact" do
+          sub_ref "A 2.3"
+          required
+          sub_fields([
+            { building: "Building" },
+            { street: "Street" },
+            { city: "Town or city" },
+            { county: "County" },
+            { postcode: "Postcode" }
+          ])
+        end
+
+        text :nominee_leader_email, "Email" do
+          sub_ref "A 2.4"
+          required
+          type "email"
+          style "large"
+        end
+
+        text :nominee_leader_telephone, "Telephone" do
+          sub_ref "A 2.5"
+          style "small"
+          type "tel"
+        end
+      end
+    end
+  end
+end

forms/award_years/v2026/qavs/qavs_step2.rb

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+class AwardYears::V2026::QaeForms
+  class << self
+    def qavs_step2
+      @qavs_step2 ||= proc do
+        notice %(
+          <p class=govuk-body>Please note your answers are being saved automatically in the background.</p>
+        )
+
+        header :recommendation, "About this section" do
+          help "About this section", %(
+            <p class='govuk-body'>
+              In this section, please explain how the nominated group has made a significant contribution in its area of activity. We are looking for groups that:
+
+              <span class='indented'>- Give excellent service to their beneficiaries and communities</span>
+              <span class='indented'>- Deliver their service in innovative ways</span>
+              <span class='indented'>- Show other examples of selfless voluntary service that distinguish their work</span>
+            </p>
+            <p class='govuk-body'>
+              Please avoid using 'we' or 'our' in this section as this gives an indication that the person making the nomination is involved in the running of the group's work. It is recommended that you use 'their' or 'the group's work'.
+            </p>
+            <p class='govuk-body'>
+              <strong>Please answer each question, noting the word limits, explaining what achievements make the nominated group stand out from others.</strong>
+            </p>
+          )
+        end
+
+        textarea :group_activities, "Please summarise the activities of the group" do
+          ref "B 1"
+          required
+          words_max 50
+          rows 2
+        end
+
+        textarea :beneficiaries, "Who are the beneficiaries (the people it helps) and where do they live?" do
+          ref "B 2"
+          required
+          words_max 30
+          rows 2
+        end
+
+        textarea :benefits, "What are the benefits of the group's work?" do
+          ref "B 3"
+          required
+          words_max 100
+          rows 2
+        end
+
+        textarea :volunteers, "This Award is specifically for groups that rely on significant and committed work by volunteers. Please explain what the volunteers do and what makes this particular group of volunteers so impressive?" do
+          ref "B 4"
+          required
+          words_max 200
+          rows 5
+        end
+
+        checkbox_seria :how_did_you_hear_about_award, "How did you hear about the Award this year?" do
+          ref "B 5"
+          required
+          context %(
+            <p class='govuk-hint'>Select all that apply.</p>
+          )
+          check_options [
+            ["national_newspaper", "National newspaper"],
+            ["local_newspaper", "Local newspaper"],
+            ["tv_radio", "TV/radio"],
+            ["internet", "Internet"],
+            ["word_of_mouth", "Word of mouth"],
+            ["previous_winner", "Previous winner/entrant"],
+            ["charity", "Voluntary organisation/charity"],
+            ["event", "Local event"],
+            ["library", "Local library"],
+            ["council", "Local Council"],
+            ["other", "Other"]
+          ]
+        end
+
+        textarea :how_did_you_hear_about_award_other_details, "" do
+          required
+          context %(
+            <p class='govuk-hint'>Please outline any other sources in the text box below:</p>
+          )
+          conditional :how_did_you_hear_about_award, "other"
+        end
+      end
+    end
+  end
+end