Merge branch 'feature/save-as-default' into 'develop'

Enhanced Configuration Management

See merge request genaiic-reusable-assets/engagement-artifacts/genaiic-idp-accelerator!186

Author: rstrahan

CHANGELOG.md

@@ -6,6 +6,12 @@ SPDX-License-Identifier: MIT-0
 ## [Unreleased]
 
 ### Added
+- **Enhanced Configuration Management**
+  - **Save as Default**: New button to save current configuration as the new default baseline with confirmation modal and version upgrade warnings
+  - **Export Configuration**: Export current configuration to local files in JSON or YAML format with customizable filename
+  - **Import Configuration**: Import configuration from local JSON or YAML files with automatic format detection and validation
+  - Enhanced Lambda resolver with deep merge functionality for proper default configuration updates
+  - Automatic custom configuration reset when saving as default to maintain clean state
 - **Nested Attribute Groups and Lists Support**
   - Enhanced document configuration schema to support complex nested attribute structures with three attribute types:
     - **Simple attributes**: Single-value extractions (existing behavior)

docs/configuration.md

@@ -18,6 +18,13 @@ The web interface allows real-time configuration updates without stack redeploym
 - **Evaluation Methods**: Set evaluation methods and thresholds for each attribute
 - **Summarization**: Configure model, prompts, and parameters for document summarization (when `IsSummarizationEnabled` is true)
 
+### Configuration Management Features
+
+- **Save as Default**: Save your current configuration as the new default baseline. This replaces the existing default configuration and automatically clears custom overrides. **Warning**: Default configurations may be overwritten during solution upgrades - export your configuration first for backup.
+- **Export Configuration**: Download your current configuration to local files in JSON or YAML format with customizable filenames. Use this to backup configurations before upgrades or share configurations between environments.
+- **Import Configuration**: Upload configuration files from your local machine in JSON or YAML format. The system automatically detects the file format and validates the configuration before applying changes.
+- **Restore Default**: Reset all configuration settings back to the original default values, removing all customizations.
+
 Configuration changes are validated and applied immediately, with rollback capability if issues arise. See [web-ui.md](web-ui.md) for details on using the administration interface.
 
 ## Stack Parameters

src/lambda/configuration_resolver/index.py

@@ -94,10 +94,27 @@ def stringify_values(obj):
         # Convert everything to string, except None values
         return str(obj) if obj is not None else None
 
+def deep_merge(target, source):
+    """
+    Deep merge two dictionaries
+    """
+    result = target.copy()
+    
+    if not source:
+        return result
+    
+    for key, value in source.items():
+        if key in result and isinstance(result[key], dict) and isinstance(value, dict):
+            result[key] = deep_merge(result[key], value)
+        else:
+            result[key] = value
+    
+    return result
+
 def handle_update_configuration(custom_config):
     """
     Handle the updateConfiguration GraphQL mutation
-    Updates the Custom configuration item in DynamoDB
+    Updates the Custom or Default configuration item in DynamoDB
     """
     try:
         # Handle empty configuration case
@@ -117,18 +134,49 @@ def handle_update_configuration(custom_config):
         else:
             custom_config_obj = custom_config
 
-        # Convert all values to strings to ensure compatibility with DynamoDB
-        stringified_config = stringify_values(custom_config_obj)
+        # Check if this should be saved as default
+        save_as_default = custom_config_obj.pop('saveAsDefault', False)
 
-        # Update the Custom configuration in DynamoDB
-        response = table.put_item(
-            Item={
-                'Configuration': 'Custom',
-                **stringified_config
-            }
-        )
+        if save_as_default:
+            # Get current default configuration
+            default_item = get_configuration_item('Default')
+            current_default = remove_configuration_key(default_item) if default_item else {}
+            
+            # Merge custom changes with current default to create new complete default
+            new_default_config = deep_merge(current_default, custom_config_obj)
+            
+            # Convert to strings for DynamoDB
+            stringified_default = stringify_values(new_default_config)
+            
+            # Save new default configuration
+            table.put_item(
+                Item={
+                    'Configuration': 'Default',
+                    **stringified_default
+                }
+            )
+            
+            # Clear custom configuration
+            table.put_item(
+                Item={
+                    'Configuration': 'Custom'
+                }
+            )
+            
+            logger.info(f"Updated Default configuration and cleared Custom: {json.dumps(stringified_default)}")
+        else:
+            # Normal custom config update
+            stringified_config = stringify_values(custom_config_obj)
+            
+            table.put_item(
+                Item={
+                    'Configuration': 'Custom',
+                    **stringified_config
+                }
+            )
+            
+            logger.info(f"Updated Custom configuration: {json.dumps(stringified_config)}")
 
-        logger.info(f"Updated Custom configuration: {json.dumps(stringified_config)}")
         return True
 
     except json.JSONDecodeError as e: