feat(Production): Complete production deployment infrastructure

- Add comprehensive health check system with multiple endpoints
- Add Prometheus metrics endpoint
- Add production logging configurations (5 strategies)
- Add complete deployment documentation suite:
  * QUICKSTART.md - 30-minute deployment guide
  * DEPLOYMENT_CHECKLIST.md - Printable verification checklist
  * DEPLOYMENT_WORKFLOW.md - Complete deployment lifecycle
  * PRODUCTION_DEPLOYMENT.md - Comprehensive technical reference
  * production-logging.md - Logging configuration guide
  * ANSIBLE_DEPLOYMENT.md - Infrastructure as Code automation
  * README.md - Navigation hub
  * DEPLOYMENT_SUMMARY.md - Executive summary
- Add deployment scripts and automation
- Add DEPLOYMENT_PLAN.md - Concrete plan for immediate deployment
- Update README with production-ready features

All production infrastructure is now complete and ready for deployment.

docs/claude/error-handling.md

@@ -20,7 +20,7 @@ The framework provides a sophisticated exception system with:
 namespace App\Domain\User\Exceptions;
 
 use App\Framework\Exception\FrameworkException;
-use App\Framework\Exception\ErrorCode;
+use App\Framework\Exception\Core\DatabaseErrorCode;
 use App\Framework\Exception\ExceptionContext;
 
 final class UserNotFoundException extends FrameworkException
@@ -28,41 +28,72 @@ final class UserNotFoundException extends FrameworkException
     public static function byId(UserId $id): self
     {
         return self::create(
-            ErrorCode::ENTITY_NOT_FOUND,
+            DatabaseErrorCode::ENTITY_NOT_FOUND,
             "User with ID '{$id->toString()}' not found"
         )->withData([
             'user_id' => $id->toString(),
             'search_type' => 'by_id'
         ]);
     }
-    
+
     public static function byEmail(Email $email): self
     {
         $context = ExceptionContext::forOperation('user.lookup', 'UserRepository')
             ->withData(['email' => $email->getMasked()]);
-            
+
         return self::fromContext(
             "User with email not found",
             $context,
-            ErrorCode::ENTITY_NOT_FOUND
+            DatabaseErrorCode::ENTITY_NOT_FOUND
         );
     }
 }
 ```
 
-### Using ErrorCode Enum
+### Using ErrorCode Enums
+
+The framework provides category-specific error code enums for better organization and type safety:
 
 ```php
-// The framework provides predefined error codes:
-ErrorCode::DB_CONNECTION_FAILED      // Database errors
-ErrorCode::AUTH_TOKEN_EXPIRED        // Authentication errors
-ErrorCode::VAL_BUSINESS_RULE_VIOLATION // Validation errors
-ErrorCode::HTTP_RATE_LIMIT_EXCEEDED  // HTTP errors
-ErrorCode::SEC_CSRF_TOKEN_INVALID    // Security errors
+use App\Framework\Exception\Core\DatabaseErrorCode;
+use App\Framework\Exception\Core\AuthErrorCode;
+use App\Framework\Exception\Core\HttpErrorCode;
+use App\Framework\Exception\Core\SecurityErrorCode;
+use App\Framework\Exception\Core\ValidationErrorCode;
+
+// Database errors
+DatabaseErrorCode::CONNECTION_FAILED
+DatabaseErrorCode::QUERY_FAILED
+DatabaseErrorCode::TRANSACTION_FAILED
+DatabaseErrorCode::CONSTRAINT_VIOLATION
+
+// Authentication errors
+AuthErrorCode::CREDENTIALS_INVALID
+AuthErrorCode::TOKEN_EXPIRED
+AuthErrorCode::SESSION_EXPIRED
+AuthErrorCode::ACCOUNT_LOCKED
+
+// HTTP errors
+HttpErrorCode::BAD_REQUEST
+HttpErrorCode::NOT_FOUND
+HttpErrorCode::METHOD_NOT_ALLOWED
+HttpErrorCode::RATE_LIMIT_EXCEEDED
+
+// Security errors
+SecurityErrorCode::CSRF_TOKEN_INVALID
+SecurityErrorCode::SQL_INJECTION_DETECTED
+SecurityErrorCode::XSS_DETECTED
+SecurityErrorCode::PATH_TRAVERSAL_DETECTED
+
+// Validation errors
+ValidationErrorCode::INVALID_INPUT
+ValidationErrorCode::REQUIRED_FIELD_MISSING
+ValidationErrorCode::BUSINESS_RULE_VIOLATION
+ValidationErrorCode::INVALID_FORMAT
 
 // Using error codes in exceptions:
 throw FrameworkException::create(
-    ErrorCode::DB_QUERY_FAILED,
+    DatabaseErrorCode::QUERY_FAILED,
     "Failed to execute user query"
 )->withContext(
     ExceptionContext::forOperation('user.find', 'UserRepository')
@@ -79,7 +110,7 @@ $exception = FrameworkException::forOperation(
     'payment.process',
     'PaymentService',
     'Payment processing failed',
-    ErrorCode::PAYMENT_GATEWAY_ERROR
+    HttpErrorCode::BAD_GATEWAY
 )->withData([
     'amount' => $amount->toArray(),
     'gateway' => 'stripe',
@@ -104,7 +135,7 @@ $context = ExceptionContext::empty()
 throw FrameworkException::fromContext(
     'Order validation failed',
     $context,
-    ErrorCode::VAL_BUSINESS_RULE_VIOLATION
+    ValidationErrorCode::BUSINESS_RULE_VIOLATION
 );
 ```
 
@@ -117,7 +148,7 @@ final class RateLimitException extends FrameworkException
     public static function exceeded(int $retryAfter): self
     {
         return self::create(
-            ErrorCode::HTTP_RATE_LIMIT_EXCEEDED,
+            HttpErrorCode::RATE_LIMIT_EXCEEDED,
             'API rate limit exceeded'
         )->withRetryAfter($retryAfter)
          ->withData(['retry_after_seconds' => $retryAfter]);
@@ -147,17 +178,17 @@ try {
         // Handle authentication errors
         return $this->redirectToLogin();
     }
-    
+
     if ($e->isCategory('VAL')) {
         // Handle validation errors
         return $this->validationErrorResponse($e);
     }
-    
-    if ($e->isErrorCode(ErrorCode::DB_CONNECTION_FAILED)) {
+
+    if ($e->isErrorCode(DatabaseErrorCode::CONNECTION_FAILED)) {
         // Handle specific database connection errors
         $this->notifyOps($e);
     }
-    
+
     throw $e;
 }
 ```