feat: stop-584 dynamic form backward compatibility changes

src/main/java/com/iemr/flw/controller/DynamicFormController.java

@@ -22,6 +22,7 @@
 package com.iemr.flw.controller;
 
 import com.iemr.flw.dto.iemr.DynamicFormDTO;
+import com.iemr.flw.dto.iemr.LatestFormVersionDTO;
 import com.iemr.flw.service.DynamicFormDefinitionService;
 import com.iemr.flw.utils.ApiResponse;
 import io.swagger.v3.oas.annotations.Operation;
@@ -35,6 +36,8 @@
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+import java.util.List;
+
 /**
  * REST controller for dynamic form definition management.
  * All write operations use POST; all read operations use GET.
@@ -97,4 +100,10 @@ public ResponseEntity<ApiResponse> deactivateForm(
         return ResponseEntity.ok(new ApiResponse(true, "Form deactivated", null));
     }
 
+    @Operation(summary = "Get the latest version of each active form (formId, formUuid, formName, currentVersionNumber)")
+    @RequestMapping(value = "/getLatestFormVersions", method = RequestMethod.GET)
+    public ResponseEntity<ApiResponse> getLatestFormVersions() {
+        List<LatestFormVersionDTO> result = formService.getLatestFormVersions();
+        return ResponseEntity.ok(new ApiResponse(true, "Latest form versions fetched successfully", result));
+    }
 }

src/main/java/com/iemr/flw/domain/iemr/QuestionOption.java

@@ -21,6 +21,7 @@
  */
 package com.iemr.flw.domain.iemr;
 
+import com.iemr.flw.masterEnum.FormType;
 import jakarta.persistence.CascadeType;
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
@@ -70,6 +71,10 @@ public class QuestionOption {
     @Column(name = "optionValue", nullable = false, length = 100)
     private String optionValue;
 
+    /** Stable across every version of a form (formType + optionValue), unlike optionId — see {@link #buildOptionUuid}. */
+    @Column(name = "optionUuid", length = 255)
+    private String optionUuid;
+
     @Column(name = "optionValue_hindi", length = 100)
     private String optionValueHindi;
 
@@ -111,4 +116,12 @@ public class QuestionOption {
 
     @Column(name = "SyncFailureReason")
     private String syncFailureReason;
+
+    /** e.g. (OCCUPATION_CONTACT_TRACING, "Yes") → "OCCUPATION_CONTACT_TRACING_YES". */
+    public static String buildOptionUuid(FormType formType, String optionValue) {
+        String normalized = optionValue.toUpperCase()
+                .replaceAll("[^A-Z0-9]+", "_")
+                .replaceAll("^_+|_+$", "");
+        return formType.name() + "_" + normalized;
+    }
 }

src/main/java/com/iemr/flw/dto/iemr/FormResponseDTO.java

@@ -44,6 +44,8 @@ public class FormResponseDTO {
     private Long beneficiaryId;
     private Long formId;
     private Long versionId;
+    /** Version number of the form version this response was captured against (versionId), not necessarily the latest. */
+    private Integer versionNumber;
     private Long officerId;
     private String status;
     private String createdBy;

src/main/java/com/iemr/flw/dto/iemr/LatestFormVersionDTO.java

@@ -0,0 +1,42 @@
+/*
+ * AMRIT – Accessible Medical Records via Integrated Technology
+ * Integrated EHR (Electronic Health Records) Solution
+ *
+ * Copyright (C) "Piramal Swasthya Management and Research Institute"
+ *
+ * This file is part of AMRIT.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see https://www.gnu.org/licenses/.
+ */
+package com.iemr.flw.dto.iemr;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Latest version summary of a dynamic form: identifies the form and its current version number.
+ *
+ * @author Piramal Swasthya
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class LatestFormVersionDTO {
+    private Long formId;
+    private String formUuid;
+    private String formName;
+    private Long versionId;
+    private Integer currentVersionNumber;
+}

src/main/java/com/iemr/flw/dto/iemr/QuestionOptionDTO.java

@@ -51,6 +51,9 @@ public class QuestionOptionDTO {
 
     private String optionValueHindi;
 
+    /** Optional on input — derived from formType + optionValue when blank. */
+    private String optionUuid;
+
     @NotNull(message = "displayOrder is required")
     private Integer displayOrder;
 

src/main/java/com/iemr/flw/dto/iemr/QuestionResponseDTO.java

@@ -40,8 +40,13 @@ public class QuestionResponseDTO {
 
     private Long questionResponseId;
     private Long questionId;
+    private String questionUuid;
     /** Populated for RADIO, DROPDOWN, MCQ, CHECKBOX, CHECKBOX_MULTI, and DROPDOWN_MULTI answers. */
     private Long optionId;
+    /** optionValue of the selected option; null when optionId is null. */
+    private String optionValue;
+    /** Stable across form versions; null when optionId is null. */
+    private String optionUuid;
     /** Populated for TEXT, DATE, AUTO_FILL, NUMBER_PICKER answers. */
     private String answerText;
 }

src/main/java/com/iemr/flw/repo/iemr/FormResponseRepo.java

@@ -41,6 +41,8 @@ public interface FormResponseRepo extends JpaRepository<FormResponse, Long> {
 
     List<FormResponse> findByBeneficiaryIdAndFormId(Long beneficiaryId, Long formId);
 
+    List<FormResponse> findByBeneficiaryIdAndVersionId(Long beneficiaryId, Long versionId);
+
    @Query("SELECT r FROM FormResponse r WHERE r.formId = :formId AND r.status IN :statuses")
     List<FormResponse> findByFormIdAndStatusIn(@Param("formId") Long formId, @Param("statuses") List<String> statuses);
 

src/main/java/com/iemr/flw/repo/iemr/FormVersionRepo.java

@@ -22,7 +22,9 @@
 package com.iemr.flw.repo.iemr;
 
 import com.iemr.flw.domain.iemr.FormVersion;
+import com.iemr.flw.dto.iemr.LatestFormVersionDTO;
 import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
 import org.springframework.stereotype.Repository;
 
 import java.util.List;
@@ -43,4 +45,10 @@ public interface FormVersionRepo extends JpaRepository<FormVersion, Long> {
     List<FormVersion> findByDynamicForm_FormIdOrderByVersionNumberAsc(Long formId);
 
     Optional<FormVersion> findByDynamicForm_FormUuidAndIsLatest(String formUuid, boolean b);
+
+    @Query("SELECT new com.iemr.flw.dto.iemr.LatestFormVersionDTO(f.formId, f.formUuid, f.formName, v.versionId, v.versionNumber) " +
+           "FROM FormVersion v JOIN v.dynamicForm f " +
+           "WHERE v.isLatest = true AND f.isActive = true " +
+           "ORDER BY f.formId ASC")
+    List<LatestFormVersionDTO> findLatestVersionOfActiveForms();
 }

src/main/java/com/iemr/flw/repo/iemr/QuestionOptionRepo.java

@@ -60,4 +60,10 @@ void shiftDisplayOrder(@Param("questionId") Long questionId, @Param("from") int
     @Query("SELECT o FROM QuestionOption o JOIN FETCH o.sectionQuestion "
             + "WHERE o.sectionQuestion.questionId IN :questionIds AND o.isActive = true ORDER BY o.displayOrder ASC")
     List<QuestionOption> findByQuestionIdsOrderByDisplayOrderAsc(@Param("questionIds") Collection<Long> questionIds);
+
+    /** All options (every form, every version, inactive included) still missing an optionUuid — used by the V009 backfill. */
+    @Query("SELECT o FROM QuestionOption o JOIN FETCH o.sectionQuestion q JOIN FETCH q.formSection s "
+            + "JOIN FETCH s.formVersion v JOIN FETCH v.dynamicForm "
+            + "WHERE o.optionUuid IS NULL OR o.optionUuid = ''")
+    List<QuestionOption> findAllMissingOptionUuid();
 }

src/main/java/com/iemr/flw/seeder/migration/V009_BackfillOptionUuid.java

@@ -0,0 +1,62 @@
+/*
+ * AMRIT – Accessible Medical Records via Integrated Technology
+ * Integrated EHR (Electronic Health Records) Solution
+ *
+ * Copyright (C) "Piramal Swasthya Management and Research Institute"
+ *
+ * This file is part of AMRIT.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see https://www.gnu.org/licenses/.
+ */
+package com.iemr.flw.seeder.migration;
+
+import com.iemr.flw.domain.iemr.QuestionOption;
+import com.iemr.flw.repo.iemr.QuestionOptionRepo;
+import com.iemr.flw.service.DynamicFormReconciliationService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+/**
+ * Backfills t_question_option.optionUuid for every option of every form version created before
+ * the column existed. The uuid is formType + optionValue, so the same option resolves to the same
+ * optionUuid in v1, v2, … — letting clients map answers across versions, as with sectionUuid/questionUuid.
+ * Only touches rows whose optionUuid is still blank, so re-running is a no-op.
+ */
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class V009_BackfillOptionUuid implements FormStructureMigration {
+
+    private final QuestionOptionRepo optionRepo;
+
+    @Override
+    public String migrationId() {
+        return "V009";
+    }
+
+    @Override
+    public void apply(DynamicFormReconciliationService svc) {
+        List<QuestionOption> options = optionRepo.findAllMissingOptionUuid();
+        for (QuestionOption option : options) {
+            option.setOptionUuid(QuestionOption.buildOptionUuid(
+                    option.getSectionQuestion().getFormSection().getFormVersion().getDynamicForm().getFormType(),
+                    option.getOptionValue()));
+        }
+        optionRepo.saveAll(options);
+        log.info("V009: backfilled optionUuid on {} option(s).", options.size());
+    }
+}

src/main/java/com/iemr/flw/service/DynamicFormDefinitionService.java

@@ -23,6 +23,7 @@
 
 import com.iemr.flw.dto.iemr.DynamicFormDTO;
 import com.iemr.flw.dto.iemr.FormSectionDTO;
+import com.iemr.flw.dto.iemr.LatestFormVersionDTO;
 import com.iemr.flw.dto.iemr.OptionConditionDTO;
 import com.iemr.flw.dto.iemr.QuestionOptionDTO;
 import com.iemr.flw.dto.iemr.QuestionValidationDTO;
@@ -56,4 +57,6 @@ public interface DynamicFormDefinitionService {
     /** Sets the form's isActive flag to false and invalidates cache. */
     void deactivateForm(Long formId);
 
+    /** Latest version of every active form: formId, formUuid, formName and current version number. */
+    List<LatestFormVersionDTO> getLatestFormVersions();
 }

src/main/java/com/iemr/flw/service/impl/DynamicFormDefinitionServiceImpl.java

@@ -30,6 +30,7 @@
 import com.iemr.flw.domain.iemr.SectionQuestion;
 import com.iemr.flw.dto.iemr.DynamicFormDTO;
 import com.iemr.flw.dto.iemr.FormSectionDTO;
+import com.iemr.flw.dto.iemr.LatestFormVersionDTO;
 import com.iemr.flw.dto.iemr.OptionConditionDTO;
 import com.iemr.flw.dto.iemr.QuestionOptionDTO;
 import com.iemr.flw.dto.iemr.QuestionValidationDTO;
@@ -213,6 +214,10 @@ private void buildSectionsFromDto(List<FormSectionDTO> dtos, FormVersion version
                     for (QuestionOptionDTO oDto : qDto.getOptions()) {
                         QuestionOption opt = mapper.toEntity(oDto);
                         opt.setSectionQuestion(savedQ);
+                        if (opt.getOptionUuid() == null || opt.getOptionUuid().isBlank()) {
+                            opt.setOptionUuid(QuestionOption.buildOptionUuid(
+                                    version.getDynamicForm().getFormType(), opt.getOptionValue()));
+                        }
                         opt.setConditions(new ArrayList<>());
                         QuestionOption savedOpt = optionRepo.save(opt);
                         if (oDto.getConditions() != null && !oDto.getConditions().isEmpty()) {
@@ -423,4 +428,9 @@ private SectionQuestion requireQuestion(Long questionId) {
                 .orElseThrow(() -> new RuntimeException("Question not found: " + questionId));
     }
 
+    @Override
+    @Transactional(readOnly = true)
+    public List<LatestFormVersionDTO> getLatestFormVersions() {
+        return versionRepo.findLatestVersionOfActiveForms();
+    }
 }

src/main/java/com/iemr/flw/service/impl/DynamicFormReconciliationServiceImpl.java

@@ -253,6 +253,11 @@ private QuestionOption createOption(SectionQuestion question, QuestionOptionDTO
         QuestionOption option = mapper.toEntity(dto);
         option.setOptionId(null);
         option.setSectionQuestion(question);
+        if (option.getOptionUuid() == null || option.getOptionUuid().isBlank()) {
+            option.setOptionUuid(QuestionOption.buildOptionUuid(
+                    question.getFormSection().getFormVersion().getDynamicForm().getFormType(),
+                    option.getOptionValue()));
+        }
         option.setDisplayOrder(order);
         option.setConditions(new ArrayList<>());
         return optionRepo.save(option);