PO-349: Add Major Creditor reference data endpoint & associated code

src/functionalTest/java/uk/gov/hmcts/opal/config/Constants.java

@@ -6,4 +6,6 @@ public class Constants {
     public static final String COURTS_REF_DATA_URI = "/api/court/ref-data/";
     public static final String LJA_REF_DATA_URI = "/api/local-justice-area/ref-data/";
     public static final String OFFENCES_REF_DATA_URI = "/api/offence/ref-data/";
+
+    public static final String MAJOR_CREDITORS_URI = "/api/major-creditor/";
 }

src/functionalTest/java/uk/gov/hmcts/opal/steps/Courts.java → src/functionalTest/java/uk/gov/hmcts/opal/steps/CourtsStepDef.java

@@ -6,7 +6,7 @@
 import static uk.gov.hmcts.opal.config.Constants.COURTS_REF_DATA_URI;
 import static uk.gov.hmcts.opal.steps.BearerTokenStepDef.getToken;
 
-public class Courts extends BaseStepDef {
+public class CourtsStepDef extends BaseStepDef {
 
     @When("I make a request to the court ref data api with")
     public void getRequestToCourtsRefData() {

src/functionalTest/java/uk/gov/hmcts/opal/steps/MajorCreditorsStepDef.java

@@ -0,0 +1,43 @@
+package uk.gov.hmcts.opal.steps;
+
+import io.cucumber.java.en.Then;
+import io.cucumber.java.en.When;
+import net.serenitybdd.rest.SerenityRest;
+
+import org.apache.http.HttpStatus;
+
+
+
+import static net.serenitybdd.rest.SerenityRest.then;
+import static org.hamcrest.Matchers.equalTo;
+import static uk.gov.hmcts.opal.config.Constants.MAJOR_CREDITORS_URI;
+
+import static uk.gov.hmcts.opal.steps.BearerTokenStepDef.getToken;
+
+public class MajorCreditorsStepDef extends BaseStepDef {
+
+
+    @When("I make a request to the major creditors ref data api filter by major creditor id {int}")
+    public void getRequestToMajorCreditorsBy(int majorCreditorId) {
+
+        SerenityRest
+            .given()
+            .accept("*/*")
+            .header("Authorization", "Bearer " + getToken())
+            .contentType("application/json")
+            .when()
+            .get(getTestUrl() + MAJOR_CREDITORS_URI + majorCreditorId);
+
+    }
+
+    @Then("the major creditors ref data matching to result")
+    public void theMajorCreditorsRefDataMatchingToResult() {
+        then().assertThat()
+            .statusCode(HttpStatus.SC_OK)
+            .body("name",equalTo("CHESTERFIELD BOROUGH COUNCIL"))
+            .body("majorCreditorId",equalTo(15));
+
+
+
+    }
+}

src/functionalTest/java/uk/gov/hmcts/opal/steps/Offences.java → src/functionalTest/java/uk/gov/hmcts/opal/steps/OffencesStepDef.java

@@ -12,9 +12,9 @@
 import static uk.gov.hmcts.opal.steps.BearerTokenStepDef.getToken;
 
 
-public class Offences extends BaseStepDef {
+public class OffencesStepDef extends BaseStepDef {
 
-    static Logger log = LoggerFactory.getLogger(Offences.class.getName());
+    static Logger log = LoggerFactory.getLogger(OffencesStepDef.class.getName());
 
     @When("I make a request to the offence ref data api filtering by cjs code {string}")
     public void getRequestToOffencesRefData(String filter) {
@@ -28,6 +28,7 @@ public void getRequestToOffencesRefData(String filter) {
 
     }
 
+
     @Then("the LJA ref data matching to result")
     @Then("the court ref data matching to result")
     @Then("the offence ref data matching to result")

src/functionalTest/resources/features/opalMode/majorCreditorFeatures.feature

@@ -0,0 +1,7 @@
+Feature: Verifying the end points for the Major Creditors
+
+  @PO-349 @Opal
+  Scenario: Verifying the end points for the major creditors
+    Given I am testing as the "opal-test@hmcts.net" user
+    When I make a request to the major creditors ref data api filter by major creditor id 15
+    Then the major creditors ref data matching to result

src/integrationTest/java/uk/gov/hmcts/opal/controllers/BusinessUnitControllerIntegrationTest.java

@@ -9,9 +9,9 @@
 import org.springframework.test.context.ActiveProfiles;
 import org.springframework.test.context.ContextConfiguration;
 import org.springframework.test.web.servlet.MockMvc;
-import uk.gov.hmcts.opal.controllers.BusinessUnitController;
 import uk.gov.hmcts.opal.dto.search.BusinessUnitSearchDto;
 import uk.gov.hmcts.opal.entity.BusinessUnitEntity;
+import uk.gov.hmcts.opal.entity.projection.BusinessUnitReferenceData;
 import uk.gov.hmcts.opal.service.opal.BusinessUnitService;
 
 import static java.util.Collections.singletonList;
@@ -49,6 +49,7 @@ void testGetBusinessUnitById() throws Exception {
             .andExpect(jsonPath("$.businessUnitCode").value("AAAA"))
             .andExpect(jsonPath("$.businessUnitType").value("LARGE UNIT"))
             .andExpect(jsonPath("$.accountNumberPrefix").value("XX"))
+            .andExpect(jsonPath("$.opalDomain").value("Fines"))
             .andExpect(jsonPath("$.parentBusinessUnit.businessUnitId").value(99));
     }
 
@@ -78,6 +79,7 @@ void testPostBusinessUnitsSearch() throws Exception {
             .andExpect(jsonPath("$[0].businessUnitCode").value("AAAA"))
             .andExpect(jsonPath("$[0].businessUnitType").value("LARGE UNIT"))
             .andExpect(jsonPath("$[0].accountNumberPrefix").value("XX"))
+            .andExpect(jsonPath("$[0].opalDomain").value("Fines"))
             .andExpect(jsonPath("$[0].parentBusinessUnit.businessUnitId").value(99));
     }
 
@@ -89,6 +91,26 @@ void testPostBusinessUnitsSearch_WhenBusinessUnitDoesNotExist() throws Exception
             .andExpect(status().isNoContent());
     }
 
+    @Test
+    void testGetCourtRefData() throws Exception {
+        BusinessUnitReferenceData refData = createBusinessUnitRefData();
+
+        when(businessUnitService.getReferenceData(any())).thenReturn(singletonList(refData));
+
+        mockMvc.perform(get("/api/business-unit/ref-data")
+                            .header("authorization", "Bearer some_value"))
+            .andExpect(status().isOk())
+            .andExpect(content().contentType(MediaType.APPLICATION_JSON))
+            .andExpect(jsonPath("$.count").value(1))
+            .andExpect(jsonPath("$.refData[0].businessUnitId").value(1))
+            .andExpect(jsonPath("$.refData[0].businessUnitName").value("Business Unit 001"))
+            .andExpect(jsonPath("$.refData[0].businessUnitCode").value("AAAA"))
+            .andExpect(jsonPath("$.refData[0].businessUnitType").value("LARGE UNIT"))
+            .andExpect(jsonPath("$.refData[0].accountNumberPrefix").value("XX"))
+            .andExpect(jsonPath("$.refData[0].opalDomain").value("Fines"));
+    }
+
+
     private BusinessUnitEntity createBusinessUnitEntity() {
         return BusinessUnitEntity.builder()
             .businessUnitId((short)1)
@@ -97,6 +119,42 @@ private BusinessUnitEntity createBusinessUnitEntity() {
             .businessUnitType("LARGE UNIT")
             .accountNumberPrefix("XX")
             .parentBusinessUnit(BusinessUnitEntity.builder().businessUnitId((short)99).build())
+            .opalDomain("Fines")
             .build();
     }
+
+    private BusinessUnitReferenceData createBusinessUnitRefData() {
+        return new BusinessUnitReferenceData() {
+
+            @Override
+            public Short getBusinessUnitId() {
+                return (short)1;
+            }
+
+            @Override
+            public String getBusinessUnitName() {
+                return "Business Unit 001";
+            }
+
+            @Override
+            public String getBusinessUnitCode() {
+                return "AAAA";
+            }
+
+            @Override
+            public String getBusinessUnitType() {
+                return "LARGE UNIT";
+            }
+
+            @Override
+            public String getAccountNumberPrefix() {
+                return "XX";
+            }
+
+            @Override
+            public String getOpalDomain() {
+                return "Fines";
+            }
+        };
+    }
 }

src/integrationTest/java/uk/gov/hmcts/opal/controllers/develop/MajorCreditorControllerIntegrationTest.java → src/integrationTest/java/uk/gov/hmcts/opal/controllers/MajorCreditorControllerIntegrationTest.java

@@ -1,4 +1,4 @@
-package uk.gov.hmcts.opal.controllers.develop;
+package uk.gov.hmcts.opal.controllers;
 
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -12,6 +12,7 @@
 import uk.gov.hmcts.opal.dto.search.MajorCreditorSearchDto;
 import uk.gov.hmcts.opal.entity.BusinessUnitEntity;
 import uk.gov.hmcts.opal.entity.MajorCreditorEntity;
+import uk.gov.hmcts.opal.entity.projection.MajorCreditorReferenceData;
 import uk.gov.hmcts.opal.service.opal.MajorCreditorService;
 
 import static java.util.Collections.singletonList;
@@ -91,6 +92,24 @@ void testPostMajorCreditorsSearch_WhenMajorCreditorDoesNotExist() throws Excepti
             .andExpect(status().isNoContent());
     }
 
+    @Test
+    void testGetMajorCreditorRefData() throws Exception {
+        MajorCreditorReferenceData refData = new MajorCreditorReferenceData(1L, "MC_001",
+                                                                            "Major Credit Card Ltd", "MN12 4TT");
+
+        when(majorCreditorService.getReferenceData(any())).thenReturn(singletonList(refData));
+
+        mockMvc.perform(get("/api/major-creditor/ref-data")
+                            .header("authorization", "Bearer some_value"))
+            .andExpect(status().isOk())
+            .andExpect(content().contentType(MediaType.APPLICATION_JSON))
+            .andExpect(jsonPath("$.count").value(1))
+            .andExpect(jsonPath("$.refData[0].majorCreditorId").value(1))
+            .andExpect(jsonPath("$.refData[0].majorCreditorCode").value("MC_001"))
+            .andExpect(jsonPath("$.refData[0].name").value("Major Credit Card Ltd"))
+            .andExpect(jsonPath("$.refData[0].postcode").value("MN12 4TT"));
+    }
+
     private MajorCreditorEntity createMajorCreditorEntity() {
         return MajorCreditorEntity.builder()
             .majorCreditorId(1L)

src/main/java/uk/gov/hmcts/opal/controllers/develop/MajorCreditorController.java → src/main/java/uk/gov/hmcts/opal/controllers/MajorCreditorController.java

@@ -1,4 +1,4 @@
-package uk.gov.hmcts.opal.controllers.develop;
+package uk.gov.hmcts.opal.controllers;
 
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
@@ -12,11 +12,15 @@
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
+import uk.gov.hmcts.opal.dto.reference.MajorCreditorReferenceDataResults;
 import uk.gov.hmcts.opal.dto.search.MajorCreditorSearchDto;
 import uk.gov.hmcts.opal.entity.MajorCreditorEntity;
+import uk.gov.hmcts.opal.entity.projection.MajorCreditorReferenceData;
 import uk.gov.hmcts.opal.service.MajorCreditorServiceInterface;
+import uk.gov.hmcts.opal.service.opal.MajorCreditorService;
 
 import java.util.List;
+import java.util.Optional;
 
 import static uk.gov.hmcts.opal.util.HttpUtil.buildResponse;
 
@@ -29,9 +33,12 @@ public class MajorCreditorController {
 
     private final MajorCreditorServiceInterface majorCreditorService;
 
-    public MajorCreditorController(@Qualifier("majorCreditorService")
-                                   MajorCreditorServiceInterface majorCreditorService) {
+    private final MajorCreditorService opalMajorCreditorService;
+
+    public MajorCreditorController(@Qualifier("majorCreditorService") MajorCreditorServiceInterface
+                                       majorCreditorService, MajorCreditorService opalMajorCreditorService) {
         this.majorCreditorService = majorCreditorService;
+        this.opalMajorCreditorService = opalMajorCreditorService;
     }
 
     @GetMapping(value = "/{majorCreditorId}")
@@ -56,5 +63,15 @@ public ResponseEntity<List<MajorCreditorEntity>> postMajorCreditorsSearch(
         return buildResponse(response);
     }
 
+    @GetMapping(value = {"/ref-data", "/ref-data/", "/ref-data/{filter}"})
+    @Operation(summary = "Returns MajorCreditors as reference data with an optional filter applied")
+    public ResponseEntity<MajorCreditorReferenceDataResults> getMajorCreditorRefData(
+        @PathVariable Optional<String> filter) {
+        log.info(":GET:getMajorCreditorRefData: query: \n{}", filter);
+
+        List<MajorCreditorReferenceData> refData = opalMajorCreditorService.getReferenceData(filter);
 
+        log.info(":GET:getMajorCreditorRefData: major creditor reference data count: {}", refData.size());
+        return ResponseEntity.ok(MajorCreditorReferenceDataResults.builder().refData(refData).build());
+    }
 }

src/main/java/uk/gov/hmcts/opal/dto/reference/MajorCreditorReferenceDataResults.java

@@ -0,0 +1,32 @@
+package uk.gov.hmcts.opal.dto.reference;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import uk.gov.hmcts.opal.entity.projection.MajorCreditorReferenceData;
+
+import java.util.List;
+import java.util.Optional;
+
+@Builder
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+public class MajorCreditorReferenceDataResults {
+    private Integer count;
+    private List<MajorCreditorReferenceData> refData;
+
+    public static class MajorCreditorReferenceDataResultsBuilder {
+        public MajorCreditorReferenceDataResults.MajorCreditorReferenceDataResultsBuilder refData(
+            List<MajorCreditorReferenceData> refData) {
+            this.refData = refData;
+            return this.count(Optional.ofNullable(refData).map(List::size).orElse(0));
+        }
+
+        private MajorCreditorReferenceDataResults.MajorCreditorReferenceDataResultsBuilder count(Integer count) {
+            this.count = count;
+            return this;
+        }
+    }
+}

src/main/java/uk/gov/hmcts/opal/entity/MajorCreditorEntity.java

@@ -43,4 +43,13 @@ public class MajorCreditorEntity extends AddressEntity {
     @Column(name = "major_creditor_code", length = 4)
     private String majorCreditorCode;
 
+    @Column(name = "contact_name", length = 35)
+    private String contactName;
+
+    @Column(name = "contact_telephone", length = 35)
+    private String contactTelephone;
+
+    @Column(name = "contact_email", length = 80)
+    private String contactEmail;
+
 }

src/main/java/uk/gov/hmcts/opal/entity/projection/MajorCreditorReferenceData.java

@@ -0,0 +1,5 @@
+package uk.gov.hmcts.opal.entity.projection;
+
+public record MajorCreditorReferenceData(Long majorCreditorId, String majorCreditorCode, String name, String postcode) {
+
+}

src/main/java/uk/gov/hmcts/opal/repository/jpa/MajorCreditorSpecs.java

@@ -10,6 +10,8 @@
 import uk.gov.hmcts.opal.entity.MajorCreditorEntity;
 import uk.gov.hmcts.opal.entity.MajorCreditorEntity_;
 
+import java.util.Optional;
+
 import static uk.gov.hmcts.opal.repository.jpa.BusinessUnitSpecs.equalsBusinessUnitIdPredicate;
 import static uk.gov.hmcts.opal.repository.jpa.BusinessUnitSpecs.likeBusinessUnitNamePredicate;
 
@@ -21,7 +23,13 @@ public Specification<MajorCreditorEntity> findBySearchCriteria(MajorCreditorSear
             numericLong(criteria.getMajorCreditorId()).map(MajorCreditorSpecs::equalsMajorCreditorId),
             numericShort(criteria.getBusinessUnitId()).map(MajorCreditorSpecs::equalsBusinessUnitId),
             notBlank(criteria.getBusinessUnitName()).map(MajorCreditorSpecs::likeBusinessUnitName),
-            numericShort(criteria.getMajorCreditorCode()).map(MajorCreditorSpecs::equalsMajorCreditorCode)
+            notBlank(criteria.getMajorCreditorCode()).map(MajorCreditorSpecs::likeMajorCreditorCode)
+        ));
+    }
+
+    public Specification<MajorCreditorEntity> referenceDataFilter(Optional<String> filter) {
+        return Specification.allOf(specificationList(
+            filter.filter(s -> !s.isBlank()).map(this::likeAnyMajorCreditor)
         ));
     }
 
@@ -44,13 +52,20 @@ public static Specification<MajorCreditorEntity> likeBusinessUnitName(String bus
             likeBusinessUnitNamePredicate(joinBusinessUnit(root), builder, businessUnitName);
     }
 
-    public static Specification<MajorCreditorEntity> equalsMajorCreditorCode(Short majorCreditorCode) {
-        return (root, query, builder) -> equalsMajorCreditorCodePredicate(root, builder, majorCreditorCode);
+    public static Specification<MajorCreditorEntity> likeMajorCreditorCode(String majorCreditorCode) {
+        return (root, query, builder) -> likeMajorCreditorCodePredicate(root, builder, majorCreditorCode);
+    }
+
+    public static Predicate likeMajorCreditorCodePredicate(
+        From<?, MajorCreditorEntity> from, CriteriaBuilder builder, String majorCreditorCode) {
+        return likeWildcardPredicate(from.get(MajorCreditorEntity_.majorCreditorCode), builder, majorCreditorCode);
     }
 
-    public static Predicate equalsMajorCreditorCodePredicate(
-        From<?, MajorCreditorEntity> from, CriteriaBuilder builder, Short businessUnitId) {
-        return builder.equal(from.get(MajorCreditorEntity_.majorCreditorCode), businessUnitId);
+    public Specification<MajorCreditorEntity> likeAnyMajorCreditor(String filter) {
+        return Specification.anyOf(
+            likeName(filter),
+            likeMajorCreditorCode(filter)
+        );
     }
 
     public static Join<MajorCreditorEntity, BusinessUnitEntity> joinBusinessUnit(From<?, MajorCreditorEntity> from) {