FFS-4713 Add an environment variable to disable NSC in a given environment, forcing the Education flow to self-attestation only.

app/.env

@@ -48,3 +48,4 @@ MISSION_CONTROL_USER=user
 MISSION_CONTROL_PASSWORD=password
 
 STRUCTURED_LOGGING_ENABLED=false
+NSC_DISABLED=false

app/.env.local.example

@@ -41,6 +41,9 @@ SLACK_TEST_EMAIL=
 # Select the environment you are integrating with and fill in the values below.
 # NOTE: Revisit this for multi-tenant app with agency-specific setup.
 #
+# (Optional) Disable the data-backed NSC flow and only expose the self-attestation flow:
+# NSC_DISABLED=true
+#
 # Sandbox Environment
 NSC_API_URL_SANDBOX=
 NSC_TOKEN_URL_SANDBOX=

app/app/controllers/activities/base_controller.rb

@@ -25,6 +25,10 @@ def current_identity!
 
   private
 
+  def redirect_if_nsc_disabled
+    redirect_to new_activities_flow_education_path if nsc_disabled?
+  end
+
   def after_activity_path
     progress_result = progress_calculator.overall_result
     progress_result.meets_routing_requirements ? activities_flow_summary_path : activities_flow_root_path

app/app/controllers/activities/education/term_credit_hours_controller.rb

@@ -1,4 +1,5 @@
 class Activities::Education::TermCreditHoursController < Activities::BaseController
+  before_action :redirect_if_nsc_disabled
   before_action :set_education_activity
   before_action :set_term_credit_hours_vars, only: %i[edit update]
   before_action :set_back_url, only: %i[edit update]

app/app/controllers/activities/education_controller.rb

@@ -12,6 +12,7 @@ class Activities::EducationController < Activities::BaseController
   ARTIFICIAL_DELAY = 7.seconds
   INDICATOR_COUNT = 3
 
+  before_action :redirect_if_nsc_disabled, only: %i[verify show sync error]
   before_action :set_education_activity, only: %i[show edit update destroy review save_review]
   before_action :set_back_url, only: %i[edit review]
   after_action :track_info_viewed_event, only: %i[new edit]
@@ -24,6 +25,8 @@ def verify
   def create
     if params[:education_activity]
       create_fully_self_attested_activity
+    elsif nsc_disabled?
+      redirect_to new_activities_flow_education_path
     else
       create_validated_activity
     end

app/app/controllers/application_controller.rb

@@ -4,7 +4,7 @@ class ApplicationController < ActionController::Base
   ALPHANUMERIC_PREFIX_REGEXP = /^([a-zA-Z0-9]+)[^a-zA-Z0-9]*$/
 
   helper :view
-  helper_method :current_agency, :show_menu?, :pilot_ended?, :get_site_alert_title, :get_site_alert_body, :activity_flow?, :session_timeout_enabled?, :session_timeout_duration, :internal_environment?
+  helper_method :current_agency, :show_menu?, :pilot_ended?, :get_site_alert_title, :get_site_alert_body, :activity_flow?, :session_timeout_enabled?, :session_timeout_duration, :internal_environment?, :nsc_disabled?
   around_action :switch_locale
   before_action :add_newrelic_metadata, :redirect_if_maintenance_mode, :set_device_id_cookie
   after_action :apply_iframe_embedding
@@ -131,6 +131,10 @@ def activity_hub_enabled?
     Rails.env.development? || ENV["ACTIVITY_HUB_ENABLED"] == "true"
   end
 
+  def nsc_disabled?
+    Nsc.disabled?
+  end
+
   def redirect_unless_activity_hub_enabled
     return if activity_hub_enabled?
 

app/app/helpers/activities_helper.rb

@@ -1,4 +1,12 @@
 module ActivitiesHelper
+  def education_add_path
+    if nsc_disabled?
+      new_activities_flow_education_path
+    else
+      verify_activities_flow_education_index_path
+    end
+  end
+
   def show_activity?(type)
     if @flow&.pre_populated_session?
       @flow.pre_populated_activity_types.include?(type.to_sym)

app/app/helpers/application_helper.rb

@@ -31,6 +31,10 @@ def activity_type_enabled?(type)
     current_agency&.activity_types&.[](type.to_sym)
   end
 
+  def nsc_disabled?
+    Nsc.disabled?
+  end
+
   def uswds_sprite_icon_href(icon_name)
     "#{asset_path("@uswds/uswds/dist/img/sprite.svg")}##{icon_name}"
   end

app/app/views/activities/activities/index.html.erb

@@ -136,7 +136,7 @@
       <%= render "activities/activities/activity_section",
             activity_type: "education",
             section_title: t("activities.education.title"),
-            add_path: verify_activities_flow_education_index_path,
+            add_path: education_add_path,
             empty_message: t("activities.hub.empty.education"),
             cards: education_card_data do %>
         <% education_card_data.each do |card_data| %>

app/app/views/activities/education/error.html.erb

@@ -22,7 +22,9 @@
 
 <nav class="margin-top-5">
   <%= link_to t(".enter_manually_button"), new_activities_flow_education_path, class: "usa-button" %>
-  <div class="margin-top-2 mobile-text-center">
-    <%= link_to t(".retry_button"), verify_activities_flow_education_index_path, class: "usa-button usa-button--unstyled" %>
-  </div>
+  <% unless nsc_disabled? %>
+    <div class="margin-top-2 mobile-text-center">
+      <%= link_to t(".retry_button"), verify_activities_flow_education_index_path, class: "usa-button usa-button--unstyled" %>
+    </div>
+  <% end %>
 </nav>

app/lib/nsc.rb

@@ -0,0 +1,9 @@
+module Nsc
+  def self.disabled?
+    ENV["NSC_DISABLED"] == "true"
+  end
+
+  def self.enabled?
+    !disabled?
+  end
+end

app/spec/controllers/activities/activities_controller_spec.rb

@@ -38,6 +38,21 @@
       )
     end
 
+    it "points the education add button at the verify page by default" do
+      expect(Capybara.string(response.body)).to have_css(
+        "[data-activity-type='education'] form[action='#{verify_activities_flow_education_index_path}']"
+      )
+    end
+
+    it "points the education add button at the self-attestation new page when NSC is disabled" do
+      stub_environment_variable("NSC_DISABLED", "true") do
+        get :index
+        expect(Capybara.string(response.body)).to have_css(
+          "[data-activity-type='education'] form[action='#{new_activities_flow_education_path}']"
+        )
+      end
+    end
+
     it "shows current flow community service activities" do
       expect(
         assigns(:community_service_activities)

app/spec/controllers/activities/education/term_credit_hours_controller_spec.rb

@@ -33,6 +33,16 @@
     let(:tracked_flow) { activity_flow }
     let(:perform_tracked_action) { get :edit, params: { education_id: education_activity.id, id: 0 } }
 
+    context "when NSC is disabled" do
+      it "redirects to the self-attestation new path" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          get :edit, params: { education_id: education_activity.id, id: 0 }
+
+          expect(response).to redirect_to(new_activities_flow_education_path)
+        end
+      end
+    end
+
     it_behaves_like "tracks an event", TrackEvent::EducationTermCreditHoursViewed,
       extra_attributes: -> { { education_activity_id: kind_of(Integer), term_index: 0, term_date_range: kind_of(String) } }
 
@@ -221,6 +231,16 @@
       patch :update, params: { education_id: education_activity.id, id: 0, nsc_enrollment_term: { credit_hours: 4 } }
     end
 
+    context "when NSC is disabled" do
+      it "redirects to the self-attestation new path" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          patch :update, params: { education_id: education_activity.id, id: 0, nsc_enrollment_term: { credit_hours: 4 } }
+
+          expect(response).to redirect_to(new_activities_flow_education_path)
+        end
+      end
+    end
+
     it_behaves_like "tracks an event", TrackEvent::EducationTermCreditHoursSubmitted,
       extra_attributes: -> { { education_activity_id: kind_of(Integer), term_index: 0, term_date_range: kind_of(String) } }
 

app/spec/controllers/activities/education_controller_spec.rb

@@ -29,6 +29,16 @@
       expect(response.body).to have_content(activity_flow.identity.last_name)
       expect(response.body).to have_content(activity_flow.identity.date_of_birth.strftime("%B %-d, %Y"))
     end
+
+    context "when NSC is disabled" do
+      it "redirects to the self-attestation new path" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          get :verify
+
+          expect(response).to redirect_to(new_activities_flow_education_path)
+        end
+      end
+    end
   end
 
   describe "POST #create" do
@@ -63,6 +73,27 @@
       expect(response).to redirect_to(activities_flow_education_path(id: EducationActivity.last.id))
     end
 
+    context "when NSC is disabled" do
+      it "redirects to the self-attestation new path and does not create an activity" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          expect { post :create }.not_to change(EducationActivity, :count)
+          expect(response).to redirect_to(new_activities_flow_education_path)
+        end
+      end
+
+      it "allows creating a self-attested EducationActivity" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          expect {
+            post :create, params: { education_activity: { school_name: "Test University", city: "Springfield", state: "IL", zip_code: "62701", street_address: "123 Main St" } }
+          }.to change(EducationActivity, :count).by(1)
+
+          activity = EducationActivity.last
+          expect(activity.data_source).to eq("fully_self_attested")
+          expect(response).to redirect_to(edit_activities_flow_education_month_path(education_id: activity.id, id: 0))
+        end
+      end
+    end
+
     it "creates the validated activity as a draft" do
       post :create
 
@@ -98,6 +129,16 @@
   describe "GET #show" do
     let(:education_activity) { create(:education_activity, activity_flow: activity_flow) }
 
+    context "when NSC is disabled" do
+      it "redirects to the self-attestation new path" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          get :show, params: { id: education_activity.id }
+
+          expect(response).to redirect_to(new_activities_flow_education_path)
+        end
+      end
+    end
+
     it "renders the synchronization page" do
       get :show, params: { id: education_activity.id }
 
@@ -211,6 +252,16 @@
   describe "PATCH #sync" do
     let(:education_activity) { create(:education_activity, activity_flow: activity_flow) }
 
+    context "when NSC is disabled" do
+      it "redirects to the self-attestation new path" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          patch :sync, params: { education_id: education_activity.id }
+
+          expect(response).to redirect_to(new_activities_flow_education_path)
+        end
+      end
+    end
+
     context "when the EducationActivity is validated and succeeded" do
       before do
         education_activity.update(status: :succeeded, draft: true)
@@ -249,6 +300,16 @@
       expect(response.body).to have_content(I18n.t("activities.education.error.retry_button"))
       expect(response.body).to have_link(I18n.t("activities.education.error.enter_manually_button"), href: new_activities_flow_education_path)
     end
+
+    context "when NSC is disabled" do
+      it "redirects to the self-attestation new path" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          get :error
+
+          expect(response).to redirect_to(new_activities_flow_education_path)
+        end
+      end
+    end
   end
 
   describe "GET #new" do

app/spec/controllers/application_controller_spec.rb

@@ -148,4 +148,14 @@ def show
       end
     end
   end
+
+  describe "#nsc_disabled?" do
+    it "delegates to Nsc.disabled?" do
+      allow(Nsc).to receive(:disabled?).and_return(true)
+      expect(controller.send(:nsc_disabled?)).to be true
+
+      allow(Nsc).to receive(:disabled?).and_return(false)
+      expect(controller.send(:nsc_disabled?)).to be false
+    end
+  end
 end

app/spec/helpers/activities_helper_spec.rb

@@ -3,6 +3,22 @@
 RSpec.describe ActivitiesHelper do
   include ActiveSupport::Testing::TimeHelpers
 
+  describe "#education_add_path" do
+    context "when NSC is not disabled" do
+      it "returns verify_activities_flow_education_index_path" do
+        expect(helper.education_add_path).to eq(verify_activities_flow_education_index_path)
+      end
+    end
+
+    context "when NSC is disabled" do
+      it "returns new_activities_flow_education_path" do
+        stub_environment_variable("NSC_DISABLED", "true") do
+          expect(helper.education_add_path).to eq(new_activities_flow_education_path)
+        end
+      end
+    end
+  end
+
   describe "#show_activity?" do
     context "in a pre-populated session" do
       before do

app/spec/helpers/application_helper_spec.rb

@@ -146,6 +146,16 @@
     end
   end
 
+  describe "#nsc_disabled?" do
+    it "delegates to Nsc.disabled?" do
+      allow(Nsc).to receive(:disabled?).and_return(true)
+      expect(helper.nsc_disabled?).to be true
+
+      allow(Nsc).to receive(:disabled?).and_return(false)
+      expect(helper.nsc_disabled?).to be false
+    end
+  end
+
   describe ".format_decimal_amount" do
     it "returns 0 for nil" do
       expect(described_class.format_decimal_amount(nil)).to eq(0)

app/spec/lib/nsc_spec.rb

@@ -0,0 +1,55 @@
+require "rails_helper"
+
+RSpec.describe Nsc do
+  describe ".disabled?" do
+    it "returns false when NSC_DISABLED is unset" do
+      stub_environment_variable("NSC_DISABLED", nil) do
+        expect(described_class.disabled?).to be false
+      end
+    end
+
+    it "returns false when NSC_DISABLED is 'false'" do
+      stub_environment_variable("NSC_DISABLED", "false") do
+        expect(described_class.disabled?).to be false
+      end
+    end
+
+    it "returns false when NSC_DISABLED is '0'" do
+      stub_environment_variable("NSC_DISABLED", "0") do
+        expect(described_class.disabled?).to be false
+      end
+    end
+
+    it "returns true when NSC_DISABLED is 'true'" do
+      stub_environment_variable("NSC_DISABLED", "true") do
+        expect(described_class.disabled?).to be true
+      end
+    end
+
+    it "returns false when NSC_DISABLED is '1'" do
+      stub_environment_variable("NSC_DISABLED", "1") do
+        expect(described_class.disabled?).to be false
+      end
+    end
+
+    it "returns false when NSC_DISABLED is 't'" do
+      stub_environment_variable("NSC_DISABLED", "t") do
+        expect(described_class.disabled?).to be false
+      end
+    end
+  end
+
+  describe ".enabled?" do
+    it "returns true when NSC_DISABLED is unset" do
+      stub_environment_variable("NSC_DISABLED", nil) do
+        expect(described_class.enabled?).to be true
+      end
+    end
+
+    it "returns false when NSC_DISABLED is 'true'" do
+      stub_environment_variable("NSC_DISABLED", "true") do
+        expect(described_class.enabled?).to be false
+      end
+    end
+  end
+end

docs/local-replication.md

@@ -87,6 +87,7 @@ essentials for a working local app are the payroll-provider sandbox keys:
 | `ARGYLE_API_TOKEN_SANDBOX_ID` | Argyle Console |
 | `ARGYLE_API_TOKEN_SANDBOX_SECRET` | Argyle Console |
 | `ARGYLE_SANDBOX_WEBHOOK_SECRET` | Generate one: `openssl rand -hex 64` |
+| `NSC_DISABLED` | (Optional) Set to `true` to disable data-backed NSC education flow and only expose self-attestation |
 
 Some values (`NEWRELIC_KEY`, `MIXPANEL_TOKEN`, `SLACK_TEST_EMAIL`, and others)
 should be obtained from a teammate — they're kept in Nava's 1Password under