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/README.md

@@ -0,0 +1,100 @@
+# Deployment Documentation
+
+**Last Updated**: 2025-01-27  
+**Purpose**: Complete deployment guide index
+
+## Overview
+
+This directory contains comprehensive deployment guides for The Order platform, covering infrastructure setup, service deployment, and operational procedures.
+
+## Quick Links
+
+### Azure Deployment
+- [Environment Setup](azure/ENVIRONMENT_SETUP.md) - Azure configuration and setup
+- [Dotenv Configuration](azure/DOTENV_SETUP.md) - Using .env file for deployments
+- [Sovereignty Landing Zone](azure/SOVEREIGNTY_LANDING_ZONE_DEPLOYMENT.md) - Multi-region deployment
+- [CDN Setup](azure/cdn-setup.md) - Azure CDN configuration
+- [Entra VerifiedID](azure/entra-verifiedid.md) - Entra VerifiedID setup
+
+### Kubernetes Deployment
+- [Kubernetes Guide](../../infra/k8s/README.md) - K8s deployment guide
+- [Service Manifests](../../infra/k8s/base/) - Base Kubernetes manifests
+
+### Infrastructure
+- [Infrastructure Overview](../../infra/README.md) - Infrastructure documentation
+- [Terraform Guide](../../infra/terraform/README.md) - Terraform documentation
+
+## Deployment Guides by Scenario
+
+### Initial Setup
+1. [Azure Environment Setup](azure/ENVIRONMENT_SETUP.md)
+2. [Dotenv Configuration](azure/DOTENV_SETUP.md)
+3. [Infrastructure Deployment](../../infra/README.md)
+
+### Multi-Region Deployment
+1. [Sovereignty Landing Zone Deployment](azure/SOVEREIGNTY_LANDING_ZONE_DEPLOYMENT.md)
+2. [Cloud for Sovereignty Architecture](../../docs/architecture/CLOUD_FOR_SOVEREIGNTY_LANDING_ZONE.md)
+
+### Service Deployment
+1. [Kubernetes Deployment](../../infra/k8s/README.md)
+2. Service-specific READMEs in `services/*/README.md`
+
+### Integration Setup
+1. [Entra VerifiedID](azure/entra-verifiedid.md)
+2. [CDN Configuration](azure/cdn-setup.md)
+3. [Integration Guides](../integrations/)
+
+## Deployment Workflows
+
+### Complete Azure Deployment
+
+```bash
+# 1. Load environment
+source infra/scripts/azure-load-env.sh
+
+# 2. Validate configuration
+./infra/scripts/azure-validate-current-env.sh
+
+# 3. Deploy infrastructure
+./infra/scripts/azure-deploy.sh
+
+# 4. Deploy sovereignty landing zone
+./infra/scripts/deploy-sovereignty-landing-zone.sh
+```
+
+### Kubernetes Deployment
+
+```bash
+# 1. Apply base configuration
+kubectl apply -k infra/k8s/base
+
+# 2. Apply environment overlay
+kubectl apply -k infra/k8s/overlays/dev
+
+# 3. Verify deployment
+kubectl get pods -n the-order
+```
+
+## Documentation Structure
+
+```
+deployment/
+├── README.md                    # This file
+└── azure/                       # Azure-specific guides
+    ├── ENVIRONMENT_SETUP.md
+    ├── DOTENV_SETUP.md
+    ├── SOVEREIGNTY_LANDING_ZONE_DEPLOYMENT.md
+    ├── cdn-setup.md
+    └── entra-verifiedid.md
+```
+
+## Related Documentation
+
+- [Architecture Documentation](../architecture/)
+- [Infrastructure Documentation](../../infra/)
+- [Service Documentation](../../services/)
+- [Integration Documentation](../integrations/)
+
+---
+
+**Last Updated**: 2025-01-27