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

services/identity/src/index.ts

@@ -18,6 +18,8 @@ import {
   authenticateDID,
   requireRole,
   registerCredentialRateLimit,
+  setupGracefulShutdown,
+  createConnectionDrainer,
 } from '@the-order/shared';
 import { IssueVCSchema, VerifyVCSchema } from '@the-order/schemas';
 import { KMSClient } from '@the-order/crypto';
@@ -428,6 +430,13 @@ const start = async () => {
     const port = env.PORT || 4002;
     await server.listen({ port, host: '0.0.0.0' });
     logger.info({ port }, 'Identity service listening');
+
+    // Setup graceful shutdown
+    const pool = getPool({ connectionString: env.DATABASE_URL });
+    setupGracefulShutdown(server, {
+      timeout: 30000,
+      onShutdown: createConnectionDrainer(pool),
+    });
   } catch (err) {
     logger.error({ err }, 'Failed to start server');
     process.exit(1);