HDPI-6421: Legal rep upload event

src/main/java/uk/gov/hmcts/reform/pcs/ccd/domain/PCSCase.java

@@ -46,6 +46,7 @@
 import uk.gov.hmcts.reform.pcs.ccd.domain.grounds.RentArrearsGroundsReasons;
 import uk.gov.hmcts.reform.pcs.ccd.domain.grounds.SecureOrFlexibleGroundsReasons;
 import uk.gov.hmcts.reform.pcs.ccd.domain.grounds.SecureOrFlexiblePossessionGrounds;
+import uk.gov.hmcts.reform.pcs.ccd.domain.legalrepdocumentupload.LegalRepDocumentUploadDetails;
 import uk.gov.hmcts.reform.pcs.ccd.domain.respondpossessionclaim.PossessionClaimResponse;
 import uk.gov.hmcts.reform.pcs.ccd.domain.statementoftruth.StatementOfTruthDetails;
 import uk.gov.hmcts.reform.pcs.ccd.domain.tabs.parties.CasePartiesTab;
@@ -522,6 +523,9 @@ public class PCSCase {
     @JsonUnwrapped
     private EnforcementOrder enforcementOrder;
 
+    @JsonUnwrapped
+    private LegalRepDocumentUploadDetails legalRepDocumentUploadDetails;
+
     @CCD(label = "Is there an underlessee or mortgagee entitled to claim relief against forfeiture?")
     private VerticalYesNo hasUnderlesseeOrMortgagee;
 

src/main/java/uk/gov/hmcts/reform/pcs/ccd/domain/legalrepdocumentupload/DocumentUploadCategory.java

@@ -0,0 +1,38 @@
+package uk.gov.hmcts.reform.pcs.ccd.domain.legalrepdocumentupload;
+
+import lombok.AllArgsConstructor;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.Locale;
+
+@AllArgsConstructor
+public enum DocumentUploadCategory {
+
+    ADJOURN_HEARING_APPLICATION(
+        "Yes, the documents I’m uploading relate to the application to adjourn the hearing - submitted on %s",
+        true),
+    SET_ASIDE_ORDER_APPLICATION(
+        "Yes, the documents I’m uploading relate to an application to set aside the order - submitted on %s",
+        true),
+    GENERAL_APPLICATION(
+        "Yes, the documents I’m uploading relate to an application submitted on %s",
+        true),
+    MAIN_CLAIM_OR_COUNTERCLAIM(
+        "No, the documents I’m uploading relate to the main claim or counterclaim",
+        false);
+
+    private final String label;
+    private final boolean requiresDate;
+
+    private static final DateTimeFormatter LABEL_DATE_FORMAT =
+        DateTimeFormatter.ofPattern("EEEE d MMM uuuu", Locale.UK);
+
+    public String getLabel(LocalDateTime dateTime) {
+        if (!requiresDate) {
+            return label;
+        }
+        String dateText = dateTime == null ? "" : dateTime.format(LABEL_DATE_FORMAT);
+        return String.format(label, dateText);
+    }
+}

src/main/java/uk/gov/hmcts/reform/pcs/ccd/domain/legalrepdocumentupload/LegalRepDocumentUploadDetails.java

@@ -0,0 +1,32 @@
+package uk.gov.hmcts.reform.pcs.ccd.domain.legalrepdocumentupload;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import uk.gov.hmcts.ccd.sdk.api.CCD;
+import uk.gov.hmcts.ccd.sdk.type.YesOrNo;
+import uk.gov.hmcts.reform.pcs.ccd.type.DynamicStringList;
+
+import static uk.gov.hmcts.ccd.sdk.type.FieldType.DynamicRadioList;
+
+@Builder
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class LegalRepDocumentUploadDetails {
+
+    @CCD(
+        label = "Do these documents relate to an existing application?",
+        typeOverride = DynamicRadioList
+    )
+    @JsonProperty("DocumentUploadCategories")
+    private DynamicStringList validCategories;
+
+    @CCD(searchable = false)
+    private YesOrNo showExistingApplicationPage;
+
+}

src/main/java/uk/gov/hmcts/reform/pcs/ccd/event/EventId.java

@@ -18,5 +18,6 @@ public enum EventId {
     addCaseNote,
     createFlags,
     amendFlags,
-    claimIssuePayment
+    claimIssuePayment,
+    legalRepDocumentUpload,
 }

src/main/java/uk/gov/hmcts/reform/pcs/ccd/event/legalrepdocumentupload/LegalRepDocumentUpload.java

@@ -0,0 +1,137 @@
+package uk.gov.hmcts.reform.pcs.ccd.event.legalrepdocumentupload;
+
+import lombok.AllArgsConstructor;
+import org.springframework.stereotype.Component;
+import uk.gov.hmcts.ccd.sdk.api.CCDConfig;
+import uk.gov.hmcts.ccd.sdk.api.DecentralisedConfigBuilder;
+import uk.gov.hmcts.ccd.sdk.api.Event;
+import uk.gov.hmcts.ccd.sdk.api.EventPayload;
+import uk.gov.hmcts.ccd.sdk.api.Permission;
+import uk.gov.hmcts.ccd.sdk.api.callback.SubmitResponse;
+import uk.gov.hmcts.ccd.sdk.type.YesOrNo;
+import uk.gov.hmcts.reform.pcs.ccd.accesscontrol.UserRole;
+import uk.gov.hmcts.reform.pcs.ccd.common.PageBuilder;
+import uk.gov.hmcts.reform.pcs.ccd.domain.PCSCase;
+import uk.gov.hmcts.reform.pcs.ccd.domain.State;
+import uk.gov.hmcts.reform.pcs.ccd.domain.VerticalYesNo;
+import uk.gov.hmcts.reform.pcs.ccd.domain.legalrepdocumentupload.LegalRepDocumentUploadDetails;
+import uk.gov.hmcts.reform.pcs.ccd.domain.legalrepdocumentupload.DocumentUploadCategory;
+import uk.gov.hmcts.reform.pcs.ccd.entity.PcsCaseEntity;
+import uk.gov.hmcts.reform.pcs.ccd.page.legalrepdocumentupload.LegalRepDocumentUploadConfigurer;
+import uk.gov.hmcts.reform.pcs.ccd.service.PcsCaseService;
+import uk.gov.hmcts.reform.pcs.ccd.type.DynamicStringList;
+import uk.gov.hmcts.reform.pcs.ccd.type.DynamicStringListElement;
+
+import java.util.Arrays;
+import java.util.Comparator;
+import java.util.List;
+import java.time.LocalDateTime;
+import java.util.Objects;
+import java.util.stream.Stream;
+
+import uk.gov.hmcts.reform.pcs.ccd.entity.GenAppEntity;
+import uk.gov.hmcts.reform.pcs.ccd.domain.genapp.GenAppType;
+
+import static uk.gov.hmcts.reform.pcs.ccd.event.EventId.legalRepDocumentUpload;
+
+@Component
+@AllArgsConstructor
+public class LegalRepDocumentUpload implements CCDConfig<PCSCase, State, UserRole> {
+
+    private final LegalRepDocumentUploadConfigurer legalRepDocumentUploadConfigurer;
+    private final PcsCaseService pcsCaseService;
+
+    @Override
+    public void configureDecentralised(DecentralisedConfigBuilder<PCSCase, State, UserRole> configBuilder) {
+        Event.EventBuilder<PCSCase, UserRole, State> eventBuilder =
+            configBuilder
+                .decentralisedEvent(legalRepDocumentUpload.name(), this::submit, this::start)
+                .forAllStates()
+                .name("Upload additional documents")
+                .grant(Permission.CRUD, UserRole.DEFENDANT_SOLICITOR)
+                .showSummary();
+        legalRepDocumentUploadConfigurer.configurePages(new PageBuilder(eventBuilder));
+    }
+
+    private PCSCase start(EventPayload<PCSCase, State> eventPayload) {
+        long caseReference = eventPayload.caseReference();
+        PCSCase caseData = eventPayload.caseData();
+
+        if (caseData.getLegalRepDocumentUploadDetails() == null) {
+            caseData.setLegalRepDocumentUploadDetails(
+                new LegalRepDocumentUploadDetails());
+        }
+
+        PcsCaseEntity pcsCaseEntity = pcsCaseService.loadCase(caseReference);
+
+        List<DynamicStringListElement> validCategoryItems =
+            Arrays.stream(DocumentUploadCategory.values())
+                .flatMap(category -> {
+                    if (category == DocumentUploadCategory.MAIN_CLAIM_OR_COUNTERCLAIM) {
+                        return Stream.of(buildCategoryItem(category, null));
+                    }
+
+                    return findGenAppDatesForCategory(pcsCaseEntity, category)
+                        .stream()
+                        .map(date -> buildCategoryItem(category, date));
+                })
+                .toList();
+
+        caseData.getLegalRepDocumentUploadDetails().setValidCategories(
+            DynamicStringList.builder()
+                .listItems(validCategoryItems)
+                .build()
+        );
+
+        // By default, Main claim is always added
+        caseData.getLegalRepDocumentUploadDetails().setShowExistingApplicationPage(validCategoryItems.size() >= 2
+                                                                                       ? YesOrNo.YES : YesOrNo.NO);
+        return caseData;
+    }
+
+    DynamicStringListElement buildCategoryItem(
+        DocumentUploadCategory category,
+        LocalDateTime genAppDate
+    ) {
+        return DynamicStringListElement.builder()
+            .code(category.name())
+            .label(category.getLabel(genAppDate))
+            .build();
+    }
+
+    List<LocalDateTime> findGenAppDatesForCategory(
+        PcsCaseEntity pcsCaseEntity,
+        DocumentUploadCategory category
+    ) {
+        if (pcsCaseEntity.getGenApps() == null) {
+            return List.of();
+        }
+
+        GenAppType mapped = mapCategoryToGenAppType(category);
+        if (mapped == null) {
+            return List.of();
+        }
+
+        return pcsCaseEntity.getGenApps().stream()
+            .filter(genApp -> genApp.getType() == mapped)
+            .filter(genApp -> genApp.getWithoutNotice() != null
+                && genApp.getWithoutNotice() == VerticalYesNo.YES)
+            .map(GenAppEntity::getApplicationSubmittedDate)
+            .filter(Objects::nonNull)
+            .sorted(Comparator.reverseOrder()) // optional
+            .toList();
+    }
+
+    GenAppType mapCategoryToGenAppType(DocumentUploadCategory category) {
+        return switch (category) {
+            case ADJOURN_HEARING_APPLICATION -> GenAppType.ADJOURN;
+            case SET_ASIDE_ORDER_APPLICATION -> GenAppType.SET_ASIDE;
+            case GENERAL_APPLICATION -> GenAppType.SOMETHING_ELSE;
+            default -> null;
+        };
+    }
+
+    private SubmitResponse<State> submit(EventPayload<PCSCase, State> eventPayload) {
+        return SubmitResponse.defaultResponse();
+    }
+}

src/main/java/uk/gov/hmcts/reform/pcs/ccd/page/legalrepdocumentupload/ExistingApplicationPage.java

@@ -0,0 +1,45 @@
+package uk.gov.hmcts.reform.pcs.ccd.page.legalrepdocumentupload;
+
+import uk.gov.hmcts.reform.pcs.ccd.common.CcdPageConfiguration;
+import uk.gov.hmcts.reform.pcs.ccd.common.PageBuilder;
+import uk.gov.hmcts.reform.pcs.ccd.domain.PCSCase;
+import uk.gov.hmcts.reform.pcs.ccd.domain.legalrepdocumentupload.LegalRepDocumentUploadDetails;
+import uk.gov.hmcts.reform.pcs.ccd.page.CcdPage;
+
+import static uk.gov.hmcts.reform.pcs.ccd.ShowConditions.NEVER_SHOW;
+
+public class ExistingApplicationPage implements CcdPageConfiguration, CcdPage {
+
+    private static final String WITHOUT_NOTICE_APPLICATION_GUIDANCE  = """
+                    <p class="govuk-body">
+                        We usually share anything you upload with the other party, for example your landlord, housing
+                        association or mortgage provider.
+                    </p>
+                     <p class="govuk-body">
+                        If your application is 'without notice' (where you have asked us to consider your application
+                        without telling the other party) we will not share anything with them.
+                    </p>
+                    """;
+
+    @Override
+    public void addTo(PageBuilder pageBuilder) {
+        String pageKey = getPageKey();
+        pageBuilder
+            .page(pageKey)
+            .pageLabel("Confirm if these documents relate to an existing application")
+            .showCondition("showExistingApplicationPage=\"Yes\"")
+            .complex(PCSCase::getLegalRepDocumentUploadDetails)
+            .readonly(LegalRepDocumentUploadDetails::getShowExistingApplicationPage, NEVER_SHOW)
+            .done()
+            .label(pageKey + "-line-separator", "---")
+            .label(pageKey + "-content", WITHOUT_NOTICE_APPLICATION_GUIDANCE)
+            .complex(PCSCase::getLegalRepDocumentUploadDetails)
+            .mandatory(LegalRepDocumentUploadDetails::getValidCategories)
+            .done();
+    }
+
+    @Override
+    public String getPageKey() {
+        return CcdPage.derivePageKey(this.getClass());
+    }
+}

src/main/java/uk/gov/hmcts/reform/pcs/ccd/page/legalrepdocumentupload/LegalRepDocumentUploadConfigurer.java

@@ -0,0 +1,18 @@
+package uk.gov.hmcts.reform.pcs.ccd.page.legalrepdocumentupload;
+
+import lombok.AllArgsConstructor;
+import org.springframework.stereotype.Component;
+import uk.gov.hmcts.reform.pcs.ccd.common.PageBuilder;
+import uk.gov.hmcts.reform.pcs.ccd.common.PageConfigurer;
+
+@Component
+@AllArgsConstructor
+public class LegalRepDocumentUploadConfigurer implements PageConfigurer {
+
+    @Override
+    public void configurePages(PageBuilder pageBuilder) {
+        pageBuilder
+            .add(new UploadAdditionalDocumentsInformationPage())
+            .add(new ExistingApplicationPage());
+    }
+}

src/main/java/uk/gov/hmcts/reform/pcs/ccd/page/legalrepdocumentupload/UploadAdditionalDocumentsInformationPage.java

@@ -0,0 +1,78 @@
+package uk.gov.hmcts.reform.pcs.ccd.page.legalrepdocumentupload;
+
+import uk.gov.hmcts.reform.pcs.ccd.common.CcdPageConfiguration;
+import uk.gov.hmcts.reform.pcs.ccd.common.PageBuilder;
+import uk.gov.hmcts.reform.pcs.ccd.page.CcdPage;
+
+public class UploadAdditionalDocumentsInformationPage implements CcdPageConfiguration, CcdPage {
+
+    private static final String SUPPORTING_EVIDENCE_UPLOAD_CONTENT  = """
+                    <p class="govuk-body">
+                        You can upload a document to support an application, or to show proof that you have done
+                        something.
+                    </p>
+
+                    <div class="govuk-details__text govuk-!-margin-bottom-5">
+                        <p class="govuk-body">
+                            We usually share anything you upload with the other party, for example your landlord,
+                            housing association or mortgage provider.
+                        </p>
+                        <p class="govuk-body">
+                            If your application is 'without notice' (where you have asked us to consider your
+                            application without testing the other party) we will not share anything with them.
+                        </p>
+                    </div>
+                    <p class="govuk-body govuk-!-font-weight-bold govuk-!-font-size-24">What you can upload
+                    </p>
+
+                    <p class="govuk-body">
+                        You can upload any documents that you think are relevant.
+                    </p>
+
+                    <p class="govuk-body govuk-!-margin-bottom-0">For example, you can share:</p>
+                    <ul class="govuk-list govuk-list--bullet">
+                        <li class="govuk-!-font-size-19">evidence that a judge has asked for, like bank statements
+                        showing your rent payments
+                        </li>
+                        <li class="govuk-!-font-size-19">photographs of the property in a state of disrepair, like
+                        damp in the bathroom</li>
+                       <li class="govuk-!-font-size-19">a report from an electrician or a plumber, showing evidence of
+                       a repair that needs to be done</li>
+                       <li class="govuk-!-font-size-19">emails or letters from the claimant (your landlord, housing
+                       association, or mortgage lender)</li>
+                    </ul>
+
+                    <p class="govuk-body govuk-!-margin-bottom-0">You can upload the following file types:</p>
+                    <ul class="govuk-list govuk-list--bullet">
+                        <li class="govuk-!-font-size-19">DOC/DOCX(Word)</li>
+                       <li class="govuk-!-font-size-19">XLS/XLSX(Excel)</li>
+                       <li class="govuk-!-font-size-19">PPT/PPTX(PowerPoint)</li>
+                       <li class="govuk-!-font-size-19">PDF</li>
+                       <li class="govuk-!-font-size-19">RTF</li>
+                       <li class="govuk-!-font-size-19">TXT</li>
+                       <li class="govuk-!-font-size-19">CSV</li>
+                       <li class="govuk-!-font-size-19">JPG/JPEG</li>
+                       <li class="govuk-!-font-size-19">PNG</li>
+                       <li class="govuk-!-font-size-19">BMP</li>
+                       <li class="govuk-!-font-size-19">TIF/TIFF</li>
+                    </ul>
+                    <p class="govuk-body">
+                        You cannot upload video or audio files.
+                    </p>
+                    """;
+
+    @Override
+    public void addTo(PageBuilder pageBuilder) {
+        String pageKey = getPageKey();
+        pageBuilder
+            .page(pageKey)
+            .pageLabel("Upload Additional Documents")
+            .label(pageKey + "-line-separator", "---")
+            .label(pageKey + "-content", SUPPORTING_EVIDENCE_UPLOAD_CONTENT);
+    }
+
+    @Override
+    public String getPageKey() {
+        return CcdPage.derivePageKey(this.getClass());
+    }
+}