feat: 1165 activity search endpoint

backend/src/main/java/ca/bc/gov/restapi/results/common/dto/activity/ActivitySearchFiltersDto.java

@@ -0,0 +1,118 @@
+package ca.bc.gov.restapi.results.common.dto.activity;
+
+import ca.bc.gov.restapi.results.common.SilvaConstants;
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.List;
+import java.util.Objects;
+import lombok.Getter;
+import lombok.ToString;
+import org.springframework.util.CollectionUtils;
+
+/** This class contains all possible filters when using the Activity Search API. */
+@Getter
+@ToString
+public class ActivitySearchFiltersDto {
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> bases;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> techniques;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> methods;
+
+  @Schema(type = "boolean", nullable = true)
+  private final Boolean isComplete;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> objectives;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> fundingSources;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> orgUnits;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> openingCategories;
+
+  @Schema(type = "string")
+  private final String fileId;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> clientNumbers;
+
+  @Schema(type = "array", nullable = true)
+  private final List<String> openingStatuses;
+
+  @Schema(type = "string", format = "date", nullable = true)
+  private final String updateDateStart;
+
+  @Schema(type = "string", format = "date", nullable = true)
+  private final String updateDateEnd;
+
+  /**
+   * Creates a no-arg instance with all fields set to null, delegating to the all-args constructor
+   * to apply defaults.
+   */
+  public ActivitySearchFiltersDto() {
+    this(null, null, null, null, null, null, null, null, null, null, null, null, null);
+  }
+
+  /** Creates an instance of the activity search filter dto. */
+  public ActivitySearchFiltersDto(
+      List<String> bases,
+      List<String> techniques,
+      List<String> methods,
+      Boolean isComplete,
+      List<String> objectives,
+      List<String> fundingSources,
+      List<String> orgUnits,
+      List<String> openingCategories,
+      String fileId,
+      List<String> clientNumbers,
+      List<String> openingStatuses,
+      String updateDateStart,
+      String updateDateEnd) {
+    this.bases = !CollectionUtils.isEmpty(bases) ? bases : List.of(SilvaConstants.NOVALUE);
+    this.techniques =
+        !CollectionUtils.isEmpty(techniques) ? techniques : List.of(SilvaConstants.NOVALUE);
+    this.methods = !CollectionUtils.isEmpty(methods) ? methods : List.of(SilvaConstants.NOVALUE);
+    this.isComplete = isComplete;
+    this.objectives =
+        !CollectionUtils.isEmpty(objectives) ? objectives : List.of(SilvaConstants.NOVALUE);
+    this.fundingSources =
+        !CollectionUtils.isEmpty(fundingSources) ? fundingSources : List.of(SilvaConstants.NOVALUE);
+    this.orgUnits = !CollectionUtils.isEmpty(orgUnits) ? orgUnits : List.of(SilvaConstants.NOVALUE);
+    this.openingCategories =
+        !CollectionUtils.isEmpty(openingCategories)
+            ? openingCategories
+            : List.of(SilvaConstants.NOVALUE);
+    this.fileId = Objects.isNull(fileId) ? null : fileId.trim();
+    this.clientNumbers =
+        !CollectionUtils.isEmpty(clientNumbers) ? clientNumbers : List.of(SilvaConstants.NOVALUE);
+    this.openingStatuses =
+        !CollectionUtils.isEmpty(openingStatuses)
+            ? openingStatuses
+            : List.of(SilvaConstants.NOVALUE);
+    this.updateDateStart = Objects.isNull(updateDateStart) ? null : updateDateStart.trim();
+    this.updateDateEnd = Objects.isNull(updateDateEnd) ? null : updateDateEnd.trim();
+  }
+
+  public boolean hasAnyFilter() {
+    return !SilvaConstants.NOVALUE.equals(bases.get(0))
+        || !SilvaConstants.NOVALUE.equals(techniques.get(0))
+        || !SilvaConstants.NOVALUE.equals(methods.get(0))
+        || isComplete != null
+        || !SilvaConstants.NOVALUE.equals(objectives.get(0))
+        || !SilvaConstants.NOVALUE.equals(fundingSources.get(0))
+        || !SilvaConstants.NOVALUE.equals(orgUnits.get(0))
+        || !SilvaConstants.NOVALUE.equals(openingCategories.get(0))
+        || (fileId != null && !fileId.isBlank())
+        || !SilvaConstants.NOVALUE.equals(clientNumbers.get(0))
+        || !SilvaConstants.NOVALUE.equals(openingStatuses.get(0))
+        || (updateDateStart != null && !updateDateStart.isBlank())
+        || (updateDateEnd != null && !updateDateEnd.isBlank());
+  }
+}

backend/src/main/java/ca/bc/gov/restapi/results/common/dto/activity/ActivitySearchResponseDto.java

@@ -0,0 +1,24 @@
+package ca.bc.gov.restapi.results.common.dto.activity;
+
+import ca.bc.gov.restapi.results.common.dto.CodeDescriptionDto;
+import ca.bc.gov.restapi.results.common.dto.ForestClientDto;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+public record ActivitySearchResponseDto(
+    Long activityId,
+    CodeDescriptionDto base,
+    CodeDescriptionDto technique,
+    CodeDescriptionDto method,
+    boolean isComplete,
+    CodeDescriptionDto fundingSource,
+    String fileId,
+    String cutBlock,
+    Long openingId,
+    String cuttingPermit,
+    BigDecimal treatmentAmountArea,
+    String intraAgencyNumber,
+    CodeDescriptionDto openingCategory,
+    CodeDescriptionDto orgUnit,
+    ForestClientDto openingClient,
+    LocalDateTime updateTimestamp) {}

backend/src/main/java/ca/bc/gov/restapi/results/common/endpoint/SearchEndpoint.java

@@ -1,8 +1,11 @@
 package ca.bc.gov.restapi.results.common.endpoint;
 
+import ca.bc.gov.restapi.results.common.dto.activity.ActivitySearchFiltersDto;
+import ca.bc.gov.restapi.results.common.dto.activity.ActivitySearchResponseDto;
 import ca.bc.gov.restapi.results.common.dto.opening.OpeningSearchExactFiltersDto;
 import ca.bc.gov.restapi.results.common.dto.opening.OpeningSearchResponseDto;
 import ca.bc.gov.restapi.results.common.exception.MissingSearchParameterException;
+import ca.bc.gov.restapi.results.common.service.ActivityService;
 import ca.bc.gov.restapi.results.common.service.OpeningSearchService;
 import ca.bc.gov.restapi.results.oracle.SilvaOracleConstants;
 import java.util.List;
@@ -24,6 +27,8 @@ public class SearchEndpoint {
 
   private final OpeningSearchService openingSearchService;
 
+  private final ActivityService activityService;
+
   /**
    * Exact search for Openings with direct value matching on provided filters.
    *
@@ -121,4 +126,44 @@ public Page<OpeningSearchResponseDto> openingSearchExact(
 
     return openingSearchService.openingSearchExact(filtersDto, paginationParameters);
   }
+
+  @GetMapping("/activities")
+  public Page<ActivitySearchResponseDto> activitySearch(
+      @RequestParam(value = "bases", required = false) List<String> bases,
+      @RequestParam(value = "techniques", required = false) List<String> techniques,
+      @RequestParam(value = "methods", required = false) List<String> methods,
+      @RequestParam(value = "isComplete", required = false) Boolean isComplete,
+      @RequestParam(value = "objectives", required = false) List<String> objectives,
+      @RequestParam(value = "fundingSources", required = false) List<String> fundingSources,
+      @RequestParam(value = "orgUnits", required = false) List<String> orgUnits,
+      @RequestParam(value = "openingCategories", required = false) List<String> openingCategories,
+      @RequestParam(value = "fileId", required = false) String fileId,
+      @RequestParam(value = "clientNumbers", required = false) List<String> clientNumbers,
+      @RequestParam(value = "openingStatuses", required = false) List<String> openingStatuses,
+      @RequestParam(value = "updateDateStart", required = false) String updateDateStart,
+      @RequestParam(value = "updateDateEnd", required = false) String updateDateEnd,
+      @ParameterObject Pageable paginationParameters) {
+
+    ActivitySearchFiltersDto filters =
+        new ActivitySearchFiltersDto(
+            bases,
+            techniques,
+            methods,
+            isComplete,
+            objectives,
+            fundingSources,
+            orgUnits,
+            openingCategories,
+            fileId,
+            clientNumbers,
+            openingStatuses,
+            updateDateStart,
+            updateDateEnd);
+
+    if (!filters.hasAnyFilter()) {
+      throw new MissingSearchParameterException();
+    }
+
+    return activityService.activitySearch(filters, paginationParameters);
+  }
 }

backend/src/main/java/ca/bc/gov/restapi/results/common/projection/ActivitySearchProjection.java

@@ -0,0 +1,54 @@
+package ca.bc.gov.restapi.results.common.projection;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/** Projection interface used for activity search native queries. */
+public interface ActivitySearchProjection {
+
+  Long getActivityId();
+
+  String getBaseCode();
+
+  String getBaseDescription();
+
+  String getTechniqueCode();
+
+  String getTechniqueDescription();
+
+  String getMethodCode();
+
+  String getMethodDescription();
+
+  Long getIsComplete();
+
+  String getFundingSourceCode();
+
+  String getFundingSourceDescription();
+
+  String getFileId();
+
+  String getCutBlock();
+
+  Long getOpeningId();
+
+  String getCuttingPermit();
+
+  BigDecimal getTreatmentAmountArea();
+
+  String getIntraAgencyNumber();
+
+  String getOpeningCategoryCode();
+
+  String getOpeningCategoryDescription();
+
+  String getOrgUnitCode();
+
+  String getOrgUnitDescription();
+
+  String getOpeningClientCode();
+
+  Long getTotalCount();
+
+  LocalDateTime getUpdateTimestamp();
+}

backend/src/main/java/ca/bc/gov/restapi/results/common/repository/ActivityTreatmentUnitRepository.java

@@ -1,13 +1,14 @@
 package ca.bc.gov.restapi.results.common.repository;
 
+import ca.bc.gov.restapi.results.common.dto.activity.ActivitySearchFiltersDto;
+import ca.bc.gov.restapi.results.common.projection.ActivitySearchProjection;
 import ca.bc.gov.restapi.results.common.projection.activity.*;
 import ca.bc.gov.restapi.results.common.projection.opening.OpeningActivitiesActivitiesProjection;
 import ca.bc.gov.restapi.results.common.projection.opening.OpeningActivitiesDisturbanceProjection;
-import org.springframework.data.domain.Page;
-import org.springframework.data.domain.Pageable;
-
 import java.util.List;
 import java.util.Optional;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
 
 public interface ActivityTreatmentUnitRepository {
   Page<OpeningActivitiesDisturbanceProjection> getOpeningActivitiesDisturbanceByOpeningId(
@@ -27,4 +28,7 @@ Page<OpeningActivitiesActivitiesProjection> getOpeningActivitiesActivitiesByOpen
   Optional<OpeningActivityPruningProjection> getOpeningActivityPR(Long openingId, Long atuId);
 
   Optional<Long> getOpeningActivitySP(Long openingId, Long atuId);
+
+  List<ActivitySearchProjection> activitySearch(
+      ActivitySearchFiltersDto filters, long offset, long size);
 }

backend/src/main/java/ca/bc/gov/restapi/results/common/service/ActivityService.java

@@ -0,0 +1,11 @@
+package ca.bc.gov.restapi.results.common.service;
+
+import ca.bc.gov.restapi.results.common.dto.activity.ActivitySearchFiltersDto;
+import ca.bc.gov.restapi.results.common.dto.activity.ActivitySearchResponseDto;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+
+public interface ActivityService {
+  Page<ActivitySearchResponseDto> activitySearch(
+      ActivitySearchFiltersDto filters, Pageable pagination);
+}