KB-13226| Q11 | Ad-Hoc | Enhance backend service and provide admin API to update AccessSettings in Course & Training Plan (#243)

* KB-12452| DEV | BE | Notification while retirement

* KB-13086| Q11 | Ad-Hoc | CA and APAR Enhancements | Adding CA flag in APAR Courses

* KB-13086| Q11 | Ad-Hoc | CA and APAR Enhancements | Adding CA flag in APAR Courses

* KB-13086| Q11 | Ad-Hoc | CA and APAR Enhancements | Adding CA flag in APAR Courses

* KB-13226| Q11 | Ad-Hoc | Enhance backend service and provide admin API to update AccessSettings in Course & Training Plan

Author: ruksana2808

src/main/java/com/igot/cb/controller/AccessSettingsController.java

@@ -54,4 +54,12 @@ public ResponseEntity<ApiResponse> migrateAccessSettingRules() {
     ApiResponse response = accessSettingMigrationService.migrateAccessSettingRules();
     return new ResponseEntity<>(response, response.getResponseCode());
   }
+
+  //create and update API for admin (merges userGroups with identical criteria)
+  @PutMapping("/admin/v1/upsert")
+  public ResponseEntity<ApiResponse> upsertAdmin(@RequestBody Map<String, Object> userGroupDetails,
+                                                 @RequestHeader(Constants.X_AUTH_TOKEN) String authToken) {
+    ApiResponse response = accessSettingsService.adminUpsert(userGroupDetails, authToken);
+    return new ResponseEntity<>(response, response.getResponseCode());
+  }
 }

src/main/java/com/igot/cb/service/AccessSettingsServiceImpl.java

@@ -6,6 +6,7 @@
 import java.util.Map;
 import java.util.UUID;
 
+import com.igot.cb.util.UserGroupUtils;
 import org.apache.commons.lang.StringUtils;
 import org.springframework.http.HttpStatus;
 import org.springframework.stereotype.Service;
@@ -187,4 +188,55 @@ public Map<String, Object> createUserGroupIds(Map<String, Object> payload) {
     }
     return payload;
   }
+
+  // Admin upsert: merges userGroups with identical criteria before assigning UUIDs
+  public ApiResponse adminUpsert(Map<String, Object> userGroupDetails, String authToken) {
+    log.info("AccessSettingsService::upsertAdmin:inside");
+    ApiResponse response = ApiResponse.createDefaultResponse(Constants.ACCESS_SETTINGS_CREATE_API);
+    if (userGroupDetails == null || userGroupDetails.isEmpty()) {
+      log.error("User group details are null or empty");
+      setFailedResponse(response, "User group details cannot be null or empty");
+      return response;
+    }
+    try {
+      // Validate userGroups: no criteria key or value should be empty
+      Object accessControlObj = userGroupDetails.get(Constants.ACCESS_CONTROL);
+      if (accessControlObj instanceof Map) {
+        Map<String, Object> accessControl = (Map<String, Object>) accessControlObj;
+        Object userGroupsObj = accessControl.get(Constants.USER_GROUPS);
+        if (userGroupsObj instanceof List) {
+          List<Map<String, Object>> userGroups = (List<Map<String, Object>>) userGroupsObj;
+          String validationError = UserGroupUtils.validateUserGroupsNoEmptyCriteria(userGroups);
+          if (validationError != null) {
+            setFailedResponse(response, validationError);
+            return response;
+          }
+        }
+      }
+      Map<String, Object> createPayloadWithUuid = createUserGroupIds(userGroupDetails);
+      Map<String, Object> accessRuleData = new HashMap<>();
+      accessRuleData.put(Constants.CONTEXT_ID, userGroupDetails.get(Constants.CONTENT_ID));
+      accessRuleData.put(Constants.CONTEXT_DATA, objectMapper.writeValueAsString(createPayloadWithUuid));
+      accessRuleData.put(Constants.IS_ARCHIVED, false);
+      if (accessSettingMigrationService.processAccessSettingRule(accessRuleData)) {
+        cassandraOperation.insertRecord(Constants.KEYSPACE_SUNBIRD_COURSE,
+                Constants.ACCESS_SETTINGS_RULES_TABLE_V2, accessRuleData);
+        response.getResult().put(Constants.MSG, Constants.CREATED_RULES);
+        Map<String, Object> payload = new HashMap<>();
+        payload.put(Constants.ACCESS_CONTROL, createPayloadWithUuid.get(Constants.ACCESS_CONTROL));
+        response.getResult().putAll(payload);
+        return response;
+      } else {
+        log.error("Failed to process access setting rule");
+        setFailedResponse(response, "Failed to process access setting rule to id-map",
+                HttpStatus.INTERNAL_SERVER_ERROR);
+        return response;
+      }
+    } catch (Exception e) {
+      log.error("Error while upserting access settings", e);
+      setFailedResponse(response, "Failed to create access settings: " + e.getMessage(),
+              HttpStatus.INTERNAL_SERVER_ERROR);
+      return response;
+    }
+  }
 }

src/main/java/com/igot/cb/util/UserGroupUtils.java

@@ -0,0 +1,59 @@
+package com.igot.cb.util;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * Utility class for user group operations.
+ */
+public class UserGroupUtils {
+
+    /**
+     * Validates that no criteria key or value is empty in the userGroups list.
+     * If criteriaValue is a list, ensures no element is null, empty, or blank.
+     * Returns null if valid, or an error message if invalid.
+     * Handles String and Boolean types for value. Boolean must be true or false (not null).
+     */
+    @SuppressWarnings("unchecked")
+    public static String validateUserGroupsNoEmptyCriteria(List<Map<String, Object>> userGroups) {
+        for (Map<String, Object> userGroup : userGroups) {
+            Object criteriaListObj = userGroup.get(Constants.USER_GROUP_CRITERIA_LIST);
+            if (criteriaListObj instanceof List) {
+                List<Map<String, Object>> criteriaList = (List<Map<String, Object>>) criteriaListObj;
+                for (Map<String, Object> criteria : criteriaList) {
+                    Object key = criteria.get(Constants.CRITERIA_KEY);
+                    Object value = criteria.get(Constants.CRITERIA_VALUE);
+                    if (key == null || key.toString().trim().isEmpty() || value == null) {
+                        return "Criteria key and value must not be empty";
+                    }
+                    if (value instanceof String) {
+                        if (((String) value).trim().isEmpty()) {
+                            return "Criteria key and value must not be empty";
+                        }
+                    } else if (value instanceof List) {
+                        List<?> valueList = (List<?>) value;
+                        if (valueList.isEmpty()) {
+                            return "Criteria value list must not be empty";
+                        }
+                        for (Object eachValue : valueList) {
+                            if (eachValue == null) {
+                                return "Criteria value list must not contain null values";
+                            }
+                            if (eachValue instanceof String && ((String) eachValue).trim().isEmpty()) {
+                                return "Criteria value list must not contain empty or blank values";
+                            }
+                            // Boolean true/false are both valid, only null is invalid (already checked)
+                        }
+                    } else if (!(value instanceof Boolean)) {
+                        // Only String, List, or Boolean are allowed
+                        return "Criteria value must be a String, Boolean, or List";
+                    }
+                }
+            }
+        }
+        return null;
+    }
+}