[DO NOT REVIEW YET]

app/controllers/api/public/v1/courses_controller.rb

@@ -16,7 +16,7 @@ def index
         private
 
         def courses
-          @courses ||= CourseSearchService.call(
+          @courses ||= APICourseSearchService.call(
             filter: params[:filter],
             sort: params[:sort],
             course_scope: recruitment_cycle.courses

app/controllers/api/public/v1/providers/courses_controller.rb

@@ -21,8 +21,8 @@ def show
           private
 
           def courses
-            @courses ||= CourseSearchService.call(filter: params[:filter],
-                                                  course_scope: provider.courses)
+            @courses ||= APICourseSearchService.call(filter: params[:filter],
+                                                     course_scope: provider.courses)
           end
 
           def course

app/controllers/find/sitemaps_controller.rb

@@ -3,7 +3,7 @@
 module Find
   class SitemapsController < ApplicationController
     def show
-      @courses = ::CourseSearchService.call(filter: nil, sort: nil, course_scope: RecruitmentCycle.current.courses.findable)
+      @courses = ::WebCourseSearchService.call(filter: nil, sort: nil, course_scope: RecruitmentCycle.current.courses.findable)
 
       expires_in(1.day, public: true)
     end

app/services/api_course_search_service.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class APICourseSearchService < CourseSearchService
+  def ordering_strategy
+    @ordering_strategy ||= CourseOrdering::Strategy.find(
+      sort:,
+      default: :api_default_ordering
+    ).new(course_search_service: self)
+  end
+
+  def with_course_type(scope)
+    scope # return all course types in the API
+  end
+end

app/services/course_filters/applications_open_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class ApplicationsOpenFilter < BaseFilter
+    def call(scope)
+      scope.application_status_open
+    end
+
+    def add_filter?
+      filter[:applications_open].to_s.downcase == 'true'
+    end
+  end
+end

app/services/course_filters/base_filter.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class BaseFilter
+    delegate :filter, to: :course_search_service
+    attr_reader :course_search_service
+
+    def initialize(course_search_service)
+      @course_search_service = course_search_service
+    end
+
+    def applicable_filter?
+      log_filters
+      add_filter?
+    end
+
+    def call(scope)
+      raise NotImplementedError, 'Subclasses must implement the #call method'
+    end
+
+    def add_filter?
+      raise NotImplementedError, 'Subclasses must implement the #add_filter? method'
+    end
+
+    private
+
+    # Purple in the logs when filter is applied, Dark Red for not applied
+    FILTER_APPLIED_COLOR = "\e[35m"
+    FILTER_NOT_APPLIED_COLOR = "\e[31m"
+
+    def log_filters
+      return unless Rails.env.local?
+
+      color = add_filter? ? FILTER_APPLIED_COLOR : FILTER_NOT_APPLIED_COLOR
+      reset = "\e[0m" # Reset to default color
+
+      Rails.logger.info("#{color}#{self.class} filter #{add_filter? ? 'applied' : 'NOT applied'}#{reset}")
+    end
+  end
+end

app/services/course_filters/degree_grades_filter.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class DegreeGradesFilter < BaseFilter
+    def call(scope)
+      scope = scope.with_degree_grades(degree_grades_accepted) if degrees_accepted?
+      scope = scope.with_degree_grades(degree_grades) if degree_grades.any?
+      scope
+    end
+
+    def add_filter?
+      degrees_accepted? || degree_grades.any?
+    end
+
+    def degrees_accepted?
+      filter[:degree_required].present?
+    end
+
+    def degree_grades_accepted
+      return [] unless degrees_accepted?
+
+      degree_required_parameter = filter[:degree_required].to_sym
+
+      accepted_degrees = {
+        show_all_courses: 'two_one,two_two,third_class,not_required',
+        two_two: 'two_two,third_class,not_required',
+        third_class: 'third_class,not_required',
+        not_required: 'not_required'
+      }
+
+      (accepted_degrees[degree_required_parameter] || accepted_degrees[:show_all_courses]).split(',')
+    end
+
+    def degree_grades
+      return [] if filter[:degree_grade].blank?
+      return [] unless filter[:degree_grade].is_a?(String)
+
+      filter[:degree_grade].split(',')
+    end
+  end
+end

app/services/course_filters/engineers_teach_physics_filter.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class EngineersTeachPhysicsFilter < BaseFilter
+    def call(scope)
+      scope.engineers_teach_physics
+    end
+
+    def add_filter?
+      filter[:engineers_teach_physics].to_s.downcase == 'true' ||
+        filter[:campaign_name] == 'engineers_teach_physics'
+    end
+  end
+end

app/services/course_filters/findable_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class FindableFilter < BaseFilter
+    def call(scope)
+      scope.findable
+    end
+
+    def add_filter?
+      filter[:findable].to_s.downcase == 'true'
+    end
+  end
+end

app/services/course_filters/funding_types_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class FundingTypesFilter < BaseFilter
+    def call(scope)
+      scope.with_funding_types(filter[:funding_type].split(','))
+    end
+
+    def add_filter?
+      filter[:funding_type].present?
+    end
+  end
+end

app/services/course_filters/locations_filter.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class LocationsFilter < BaseFilter
+    def call(scope)
+      scope.within(
+        filter[:radius],
+        origin: [filter[:latitude], filter[:longitude]]
+      )
+    end
+
+    def add_filter?
+      filter.key?(:latitude) &&
+        filter.key?(:longitude) &&
+        filter.key?(:radius)
+    end
+  end
+end

app/services/course_filters/provider_name_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class ProviderNameFilter < BaseFilter
+    def call(scope)
+      scope.with_provider_name(filter[:'provider.provider_name'])
+    end
+
+    def add_filter?
+      filter[:'provider.provider_name'].present?
+    end
+  end
+end

app/services/course_filters/qualifications_filter.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class QualificationsFilter < BaseFilter
+    delegate :course_type, to: :course_search_service
+
+    def call(scope)
+      scope.with_qualifications(qualifications)
+    end
+
+    def add_filter?
+      qualifications.present?
+    end
+
+    def qualifications
+      return [] if filter[:qualification].blank? || course_type == :undergraduate
+
+      filter[:qualification] = filter[:qualification].values if filter[:qualification].is_a?(Hash)
+      filter[:qualification] = filter[:qualification].split(',') if filter[:qualification].is_a?(String)
+
+      if filter[:qualification].include?('pgce pgde')
+        filter[:qualification] -= ['pgce pgde']
+        filter[:qualification] |= %w[pgce pgde]
+      end
+
+      filter[:qualification] |= %w[pgde_with_qts] if filter[:qualification].is_a?(Array) && filter[:qualification].include?('pgce_with_qts')
+
+      filter[:qualification]
+    end
+  end
+end

app/services/course_filters/salary_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class SalaryFilter < BaseFilter
+    def call(scope)
+      scope.with_salary
+    end
+
+    def add_filter?
+      filter[:funding] == 'salary'
+    end
+  end
+end

app/services/course_filters/send_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class SendFilter < BaseFilter
+    def call(scope)
+      scope.with_send
+    end
+
+    def add_filter?
+      filter[:send_courses].to_s.downcase == 'true'
+    end
+  end
+end

app/services/course_filters/study_modes_filter.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class StudyModesFilter < BaseFilter
+    def call(scope)
+      scope.with_study_modes(study_types)
+    end
+
+    def add_filter?
+      study_types.present?
+    end
+
+    def study_types
+      # this passes for strings and arrays
+      return [] if filter[:study_type].blank?
+      return filter[:study_type] if filter[:study_type].is_a? Array
+
+      filter[:study_type] = filter[:study_type].values if filter[:study_type].is_a?(Hash)
+
+      filter[:study_type].split(',')
+    end
+  end
+end

app/services/course_filters/subjects_filter.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class SubjectsFilter < BaseFilter
+    def call(scope)
+      scope.with_subjects(subject_codes)
+    end
+
+    def add_filter?
+      subject_codes.present?
+    end
+
+    def subject_codes
+      return [] if filter[:subjects].blank?
+      return filter[:subjects] if filter[:subjects].is_a? Array
+      return filter[:subjects].values if filter[:subjects].is_a?(Hash)
+
+      filter[:subjects].split(',')
+    end
+  end
+end

app/services/course_filters/update_since_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class UpdateSinceFilter < BaseFilter
+    def call(scope)
+      scope.changed_since(filter[:updated_since])
+    end
+
+    def add_filter?
+      filter[:updated_since].present?
+    end
+  end
+end

app/services/course_filters/visa_sponsorship_filter.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CourseFilters
+  class VisaSponsorshipFilter < BaseFilter
+    def call(scope)
+      scope.can_sponsor_visa
+    end
+
+    def add_filter?
+      filter[:can_sponsor_visa].to_s.downcase == 'true'
+    end
+  end
+end

app/services/course_ordering/api_default_ordering_strategy.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CourseOrdering
+  class APIDefaultOrderingStrategy < BaseStrategy
+    def order(scope)
+      scope.order('course.id ASC')
+    end
+  end
+end

app/services/course_ordering/base_strategy.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CourseOrdering
+  class BaseStrategy
+    attr_reader :course_search_service
+
+    delegate :filter, to: :course_search_service
+
+    def initialize(course_search_service:)
+      @course_search_service = course_search_service
+    end
+
+    def order(scope)
+      raise NotImplementedError, 'Subclasses must implement the #order method'
+    end
+  end
+end

app/services/course_ordering/course_asc_strategy.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CourseOrdering
+  class CourseAscStrategy < BaseStrategy
+    def order(scope)
+      scope.ascending_course_canonical_order
+    end
+  end
+end

app/services/course_ordering/course_desc_strategy.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module CourseOrdering
+  class CourseDescStrategy < BaseStrategy
+    def order(scope)
+      scope.descending_course_canonical_order
+    end
+  end
+end