Add domain exceptions and update project structure

Implemented a structured exception-handling mechanism in the
domain layer with the addition of `DomainException`,
`DomainValidationException`, `NotFoundException`, and
`PdfProcessingException` classes. These exceptions provide
specific error handling for domain logic and integrate with
centralized middleware.

Updated `ROADMAP.md` to mark Step 2.1 (Domain Exceptions) as
completed and Step 2.2 (Value Objects) as the next task.
Added timeline entries to reflect progress.

Cleaned up `DocumentOperator.Domain.csproj` by removing
unused folder inclusions, indicating a project structure
reorganization.

DocumentOperator.Domain/Common/Exceptions/DomainException.cs

@@ -0,0 +1,25 @@
+namespace DocumentOperator.Domain.Common.Exceptions;
+
+/// <summary>
+/// Base exception for all domain-related exceptions.
+/// Caught by the Exception Handling Middleware in the API layer.
+/// </summary>
+public abstract class DomainException : Exception
+{
+    /// <summary>
+    /// Error code for categorization and logging.
+    /// </summary>
+    public string ErrorCode { get; }
+
+    protected DomainException(string message, string errorCode) 
+        : base(message)
+    {
+        ErrorCode = errorCode;
+    }
+
+    protected DomainException(string message, string errorCode, Exception innerException) 
+        : base(message, innerException)
+    {
+        ErrorCode = errorCode;
+    }
+}

DocumentOperator.Domain/Common/Exceptions/DomainValidationException.cs

@@ -0,0 +1,28 @@
+namespace DocumentOperator.Domain.Common.Exceptions;
+
+/// <summary>
+/// Exception thrown when domain validation fails (e.g., invalid Value Objects).
+/// Maps to HTTP 400 Bad Request in the API layer.
+/// </summary>
+public class DomainValidationException : DomainException
+{
+    public string PropertyName { get; }
+
+    public DomainValidationException(string message)
+        : base(message, "DOMAIN_VALIDATION_ERROR")
+    {
+        PropertyName = string.Empty;
+    }
+
+    public DomainValidationException(string propertyName, string message)
+        : base(message, "DOMAIN_VALIDATION_ERROR")
+    {
+        PropertyName = propertyName;
+    }
+
+    public DomainValidationException(string message, Exception innerException)
+        : base(message, "DOMAIN_VALIDATION_ERROR", innerException)
+    {
+        PropertyName = string.Empty;
+    }
+}

DocumentOperator.Domain/Common/Exceptions/NotFoundException.cs

@@ -0,0 +1,25 @@
+namespace DocumentOperator.Domain.Common.Exceptions;
+
+/// <summary>
+/// Exception thrown when a requested resource is not found.
+/// Maps to HTTP 404 Not Found in the API layer.
+/// </summary>
+public class NotFoundException : DomainException
+{
+    public string ResourceType { get; }
+    public object ResourceId { get; }
+
+    public NotFoundException(string resourceType, object resourceId)
+        : base($"{resourceType} with ID '{resourceId}' was not found.", "RESOURCE_NOT_FOUND")
+    {
+        ResourceType = resourceType;
+        ResourceId = resourceId;
+    }
+
+    public NotFoundException(string resourceType, object resourceId, string customMessage)
+        : base(customMessage, "RESOURCE_NOT_FOUND")
+    {
+        ResourceType = resourceType;
+        ResourceId = resourceId;
+    }
+}

DocumentOperator.Domain/Common/Exceptions/PdfProcessingException.cs

@@ -0,0 +1,34 @@
+namespace DocumentOperator.Domain.Common.Exceptions;
+
+/// <summary>
+/// Exception thrown when PDF processing operations fail.
+/// Maps to HTTP 500 Internal Server Error or 422 Unprocessable Entity in the API layer.
+/// </summary>
+public class PdfProcessingException : DomainException
+{
+    public string Operation { get; }
+
+    public PdfProcessingException(string operation, string message)
+        : base($"PDF processing failed during '{operation}': {message}", "PDF_PROCESSING_ERROR")
+    {
+        Operation = operation;
+    }
+
+    public PdfProcessingException(string operation, string message, Exception innerException)
+        : base($"PDF processing failed during '{operation}': {message}", "PDF_PROCESSING_ERROR", innerException)
+    {
+        Operation = operation;
+    }
+
+    public PdfProcessingException(string message)
+        : base(message, "PDF_PROCESSING_ERROR")
+    {
+        Operation = "Unknown";
+    }
+
+    public PdfProcessingException(string message, Exception innerException)
+        : base(message, "PDF_PROCESSING_ERROR", innerException)
+    {
+        Operation = "Unknown";
+    }
+}