FINERACT-2455: WC - Delinquency Management - Delinquency days & Delinquency Bucket handling

- create SetWorkingCapitalLoanDelinquencyTagsBusinessStep
  - QA test for business step order
- create ENABLE_INSTANT_DELINQUENCY_CALCULATION + integration tests
- Delinquency History for Working Capital Loans
  - DTOs Entity & Repository
  - Get API
  - introduce WorkingCapitalLoanDelinquencyReadPlatformService - for read operations.
  - Cucumber StepDef + basic tests - WIP
- WorkingCapitalLoanDelinquencyClassificationService
  - Handle loan level delinquency + grace day handling

Author: somasorosdpc

fineract-core/src/main/java/org/apache/fineract/infrastructure/configuration/api/GlobalConfigurationConstants.java

@@ -81,6 +81,7 @@ public final class GlobalConfigurationConstants {
     public static final String ALLOWED_LOAN_STATUSES_OF_DELAYED_SETTLEMENT_FOR_EXTERNAL_ASSET_TRANSFER = "allowed-loan-statuses-of-delayed-settlement-for-external-asset-transfer";
     public static final String MAX_LOGIN_RETRY_ATTEMPTS = "max-login-retry-attempts";
     public static final String ENABLE_ORIGINATOR_CREATION_DURING_LOAN_APPLICATION = "enable-originator-creation-during-loan-application";
+    public static final String ENABLE_INSTANT_DELINQUENCY_CALCULATION = "enable-instant-delinquency-calculation";
     public static final String PASSWORD_REUSE_CHECK_HISTORY_COUNT = "password-reuse-check-history-count";
     public static final String FORCE_WITHDRAWAL_ON_SAVINGS_ACCOUNT = "allow-force-withdrawal-on-savings-account";
     public static final String FORCE_WITHDRAWAL_ON_SAVINGS_ACCOUNT_LIMIT = "force-withdrawal-on-savings-account-limit";

fineract-e2e-tests-core/src/test/java/org/apache/fineract/test/data/workingcapitalproduct/DefaultWorkingCapitalLoanProduct.java

@@ -21,7 +21,7 @@
 public enum DefaultWorkingCapitalLoanProduct implements WorkingCapitalLoanProduct {
 
     WCLP, //
-    WCLP_FOR_UPDATE; //
+    WCLP_FOR_UPDATE, WCLP_GRACE_5; //
 
     @Override
     public String getName() {

fineract-e2e-tests-core/src/test/java/org/apache/fineract/test/stepdef/loan/WorkingCapitalProductLoanAccountStepDef.java

@@ -562,6 +562,9 @@ public void checkDisbursementData(String actualDisbursementDate, String transact
                 .orElseThrow(() -> new RuntimeException(""));
         String formattedDate = disbursementDetails.getActualDisbursementDate().format(FORMATTER);
         assertThat(formattedDate).isEqualTo(actualDisbursementDate);
+        log.info(
+                "Verified working capital loan disbursement was successful for loan ID: {} with actual disbursement date: {} and amount: {}",
+                loanId, actualDisbursementDate, disbursementDetails.getActualAmount());
         assertThat(disbursementDetails.getActualAmount().compareTo(new BigDecimal(transactionAmount))).isEqualTo(0);
     }
 
@@ -639,6 +642,12 @@ private void createWorkingCapitalLoanAccount(final List<String> loanData) {
         final PostWorkingCapitalLoansResponse response = ok(
                 () -> fineractClient.workingCapitalLoans().submitWorkingCapitalLoanApplication(loansRequest));
         testContext().set(TestContextKey.LOAN_CREATE_RESPONSE, response);
+        List<Long> loanIds = testContext().get(TestContextKey.WC_LOAN_IDS);
+        if (loanIds == null) {
+            loanIds = new ArrayList<>();
+            testContext().set(TestContextKey.WC_LOAN_IDS, loanIds);
+        }
+        loanIds.add(response.getLoanId());
         log.info("Working Capital Loan created with ID: {}", response.getLoanId());
     }
 

fineract-e2e-tests-core/src/test/java/org/apache/fineract/test/stepdef/loan/WorkingCapitalStepDef.java

@@ -26,6 +26,7 @@
 import io.cucumber.java.en.Then;
 import io.cucumber.java.en.When;
 import java.math.BigDecimal;
+import java.time.LocalDate;
 import java.util.List;
 import java.util.Map;
 import java.util.UUID;
@@ -37,11 +38,14 @@
 import org.apache.fineract.client.models.DeleteWorkingCapitalLoanProductsProductIdResponse;
 import org.apache.fineract.client.models.GetConfigurableAttributes;
 import org.apache.fineract.client.models.GetPaymentAllocation;
+import org.apache.fineract.client.models.GetWorkingCapitalLoanDelinquencyRangeScheduleTagHistoryResponse;
 import org.apache.fineract.client.models.GetWorkingCapitalLoanProductsProductIdResponse;
 import org.apache.fineract.client.models.GetWorkingCapitalLoanProductsTemplateResponse;
+import org.apache.fineract.client.models.InternalWorkingCapitalLoanPaymentRequest;
 import org.apache.fineract.client.models.PostAllowAttributeOverrides;
 import org.apache.fineract.client.models.PostWorkingCapitalLoanProductsRequest;
 import org.apache.fineract.client.models.PostWorkingCapitalLoanProductsResponse;
+import org.apache.fineract.client.models.PostWorkingCapitalLoansResponse;
 import org.apache.fineract.client.models.PutWorkingCapitalLoanProductsProductIdRequest;
 import org.apache.fineract.client.models.PutWorkingCapitalLoanProductsProductIdResponse;
 import org.apache.fineract.client.models.StringEnumOptionData;
@@ -53,6 +57,7 @@
 import org.apache.fineract.test.stepdef.AbstractStepDef;
 import org.apache.fineract.test.support.TestContextKey;
 import org.assertj.core.api.SoftAssertions;
+import org.junit.jupiter.api.Assertions;
 import org.springframework.beans.factory.annotation.Autowired;
 
 @Slf4j
@@ -350,6 +355,40 @@ public void checkWorkingCapitalLoanProductIsDeletedViaExternalId() {
                 .contains(ErrorMessageHelper.workingCapitalLoanProductIdentifiedDoesNotExistFailure(String.valueOf(externalId)));
     }
 
+    @When("make Internal Payment {string} on {string}")
+    public void internalPayWCLoan(String amount, String transactionDate) {
+        PostWorkingCapitalLoansResponse workingCapitalLoanProductsResponse = testContext().get(TestContextKey.LOAN_CREATE_RESPONSE);
+        Long resourceId = workingCapitalLoanProductsResponse.getResourceId();
+        fineractFeignClient.workingCapitalLoans().payment(resourceId, new InternalWorkingCapitalLoanPaymentRequest()
+                .amount(BigDecimal.valueOf(Double.parseDouble(amount))).transactionDate(LocalDate.parse(transactionDate)));
+    }
+
+    @Then("Delinquency Tag History for WC Loan has lines:")
+    public void checkDelinquencyHistory(final DataTable table) {
+        PostWorkingCapitalLoansResponse workingCapitalLoanProductsResponse = testContext().get(TestContextKey.LOAN_CREATE_RESPONSE);
+        Long resourceId = workingCapitalLoanProductsResponse.getResourceId();
+        List<GetWorkingCapitalLoanDelinquencyRangeScheduleTagHistoryResponse> actualLines = ok(
+                () -> fineractFeignClient.workingCapitalLoans().getDelinquencyRangeScheduleTagHistoryById(resourceId));
+        log.info("Loan {}", actualLines);
+        List<List<String>> rows = table.asLists();
+        Assertions.assertEquals(rows.size() - 1, actualLines.size());
+        for (int i = 0; i < rows.size() - 1; i++) {
+            GetWorkingCapitalLoanDelinquencyRangeScheduleTagHistoryResponse actual = actualLines.get(i);
+            Assertions.assertNotNull(actual);
+            List<String> expected = rows.get(i + 1);
+            Assertions.assertEquals(expected.get(0), actual.getPeriodNumber() != null ? actual.getPeriodNumber().toString() : null);
+            Assertions.assertEquals(expected.get(1), actual.getAddedOnDate() != null ? actual.getAddedOnDate().toString() : null);
+            Assertions.assertEquals(expected.get(2), actual.getLiftedOnDate() != null ? actual.getLiftedOnDate().toString() : null);
+
+            Assertions.assertNotNull(actual.getDelinquencyRange());
+            Assertions.assertEquals(expected.get(3), actual.getDelinquencyRange().getClassification());
+            Assertions.assertEquals(expected.get(4), actual.getDelinquencyRange().getMinimumAgeDays() == null ? null
+                    : actual.getDelinquencyRange().getMinimumAgeDays().toString());
+            Assertions.assertEquals(expected.get(5), actual.getDelinquencyRange().getMaximumAgeDays() == null ? null
+                    : actual.getDelinquencyRange().getMaximumAgeDays().toString());
+        }
+    }
+
     public PostWorkingCapitalLoanProductsResponse createWorkingCapitalLoanProduct(
             PostWorkingCapitalLoanProductsRequest workingCapitalProductRequest) {
         String workingCapitalProductName = workingCapitalProductRequest.getName();

fineract-e2e-tests-runner/src/test/java/org/apache/fineract/test/initializer/global/WorkingCapitalInitializerStep.java

@@ -61,6 +61,17 @@ public void initialize() throws Exception {
         TestContext.GLOBAL.set(TestContextKey.DEFAULT_WORKING_CAPITAL_LOAN_PRODUCT_CREATE_REQUEST_FOR_UPDATE_WCLP,
                 defaultForUpdateWCPLRequest);
         TestContext.GLOBAL.set(TestContextKey.DEFAULT_WORKING_CAPITAL_LOAN_PRODUCT_CREATE_RESPONSE_FOR_UPDATE_WCLP, responseForUpdateWCPL);
+
+        // Delinquency grace period testing
+
+        final String WCLP_GRACE_5 = DefaultWorkingCapitalLoanProduct.WCLP_GRACE_5.getName();
+        final PostWorkingCapitalLoanProductsRequest WCLP_GRACE_5Request = workingCapitalRequestFactory
+                .defaultWorkingCapitalLoanProductRequest() //
+                .name(WCLP_GRACE_5) //
+                .delinquencyBucketId(2L) //
+                .delinquencyGraceDays(5); //
+
+        createWorkingCapitalLoanProductIdempotent(WCLP_GRACE_5Request);
     }
 
     private PostWorkingCapitalLoanProductsResponse createWorkingCapitalLoanProductIdempotent(