feat: comprehensive project structure improvements and Cloud for Sovereignty landing zone

- Add Cloud for Sovereignty landing zone architecture and deployment
- Implement complete legal document management system
- Reorganize documentation with improved navigation
- Add infrastructure improvements (Dockerfiles, K8s, monitoring)
- Add operational improvements (graceful shutdown, rate limiting, caching)
- Create comprehensive project structure documentation
- Add Azure deployment automation scripts
- Improve repository navigation and organization

docs/deployment/azure/ENV_FILE_ANALYSIS.md

@@ -0,0 +1,123 @@
+# .env File Analysis Report
+
+**Date**: 2025-01-27  
+**File**: `/home/intlc/projects/the_order/.env`  
+**Status**: ✅ Valid for Azure Deployments
+
+## Current Configuration (Lines 1-6)
+
+```bash
+AZURE_SUBSCRIPTION_ID="70569bdd-de60-4dd1-838e-5fde7f91fe8d"
+AZURE_TENANT_ID="fb97e99d-3e94-4686-bfde-4bf4062e05f3"
+AZURE_MANAGEMENT_GROUP_ID="SOVEREIGN-ORDER-OF-HOSPITALLERS"
+AZURE_RESOURCE_GROUP=
+AZURE_LOCATION=westeurope
+```
+
+## Analysis Results
+
+### ✅ Required Variables - Present
+
+1. **Subscription ID**: ✅ Valid UUID format
+   - Value: `70569bdd-de60-4dd1-838e-5fde7f91fe8d`
+   - Format: Valid UUID
+
+2. **Tenant ID**: ✅ Valid UUID format
+   - Value: `fb97e99d-3e94-4686-bfde-4bf4062e05f3`
+   - Format: Valid UUID
+
+3. **Location**: ✅ Valid non-US region
+   - Value: `westeurope`
+   - Compliant: Yes (non-US region as required)
+
+### 📋 Optional Variables - Present
+
+4. **Management Group ID**: ✅ Set
+   - Value: `SOVEREIGN-ORDER-OF-HOSPITALLERS`
+   - Status: Valid management group identifier
+
+5. **Resource Group**: ⚠️ Empty
+   - Status: Will use default naming convention from Terraform
+   - Default: `az-we-rg-dev-main` (or based on environment)
+
+### ⚠️ Missing Recommended Variables
+
+- `TF_VAR_environment` - Will default to `dev`
+- `TF_VAR_resource_group_name` - Will use naming convention
+- `TF_VAR_storage_account_name` - Will use naming convention
+- `TF_VAR_key_vault_name` - Will use naming convention
+
+## Terraform Compatibility
+
+### Variable Mapping
+
+The `.env` file uses `AZURE_*` prefix, but Terraform expects `ARM_*` prefix. Our scripts automatically map:
+
+- `AZURE_SUBSCRIPTION_ID` → `ARM_SUBSCRIPTION_ID` ✅
+- `AZURE_TENANT_ID` → `ARM_TENANT_ID` ✅
+- `AZURE_LOCATION` → `ARM_LOCATION` ✅
+
+### Recommendations
+
+1. **Add ARM_* aliases** (optional but recommended):
+   ```bash
+   ARM_SUBSCRIPTION_ID="$AZURE_SUBSCRIPTION_ID"
+   ARM_TENANT_ID="$AZURE_TENANT_ID"
+   ARM_LOCATION="$AZURE_LOCATION"
+   ```
+
+2. **Add environment variable**:
+   ```bash
+   TF_VAR_environment="dev"  # or "stage" or "prod"
+   ```
+
+3. **Add custom resource names** (optional):
+   ```bash
+   TF_VAR_resource_group_name="the-order-rg-dev"
+   TF_VAR_storage_account_name="theorderdev12345"
+   TF_VAR_key_vault_name="the-order-kv-dev"
+   ```
+
+## Validation Status
+
+✅ **All required variables are present and valid**
+
+The `.env` file is properly configured for Azure deployments. The validation script will:
+- Automatically map `AZURE_*` to `ARM_*` variables
+- Set defaults for missing optional variables
+- Export Terraform variables correctly
+
+## Usage
+
+### Validate Configuration
+```bash
+./infra/scripts/azure-validate-current-env.sh
+```
+
+### Auto-fix Variable Mapping
+```bash
+./infra/scripts/azure-fix-env-mapping.sh
+```
+
+### Load and Deploy
+```bash
+source infra/scripts/azure-load-env.sh
+./infra/scripts/azure-complete-setup.sh
+./infra/scripts/azure-deploy.sh
+```
+
+## Summary
+
+| Category | Status | Count |
+|----------|--------|-------|
+| Required Variables | ✅ Complete | 3/3 |
+| Optional Variables | ⚠️ Partial | 1/5 |
+| Format Validation | ✅ Valid | All |
+| Terraform Compatibility | ✅ Compatible | Yes |
+
+**Overall Status**: ✅ **Ready for Azure Deployments**
+
+---
+
+**Last Updated**: 2025-01-27
+