Refactor handlers and OpenAPI documentation for improved readability and consistency

- Reorganized imports in health, notifications, social, thoughts, and users handlers for clarity.
- Updated function signatures in handlers to improve readability by aligning parameters.
- Enhanced JSON response formatting in notifications and thoughts handlers.
- Improved error handling in user-related functions.
- Refactored OpenAPI documentation to maintain consistent formatting and structure.
- Cleaned up unnecessary code and comments across various files.
- Ensured consistent use of `Arc` for shared state in AppState and WorkerHandlers.

crates/presentation/src/errors.rs

@@ -1,6 +1,10 @@
-use axum::{http::StatusCode, response::{IntoResponse, Response}, Json};
-use domain::errors::DomainError;
 use api_types::responses::ErrorResponse;
+use axum::{
+    http::StatusCode,
+    response::{IntoResponse, Response},
+    Json,
+};
+use domain::errors::DomainError;
 
 pub enum ApiError {
     Domain(DomainError),
@@ -9,20 +13,27 @@ pub enum ApiError {
 }
 
 impl From<DomainError> for ApiError {
-    fn from(e: DomainError) -> Self { Self::Domain(e) }
+    fn from(e: DomainError) -> Self {
+        Self::Domain(e)
+    }
 }
 
 impl IntoResponse for ApiError {
     fn into_response(self) -> Response {
         let (status, msg) = match self {
-            Self::Domain(DomainError::NotFound)          => (StatusCode::NOT_FOUND, "not found".into()),
-            Self::Domain(DomainError::Unauthorized)      => (StatusCode::UNAUTHORIZED, "unauthorized".into()),
-            Self::Domain(DomainError::Forbidden)         => (StatusCode::FORBIDDEN, "forbidden".into()),
-            Self::Domain(DomainError::Conflict(m))       => (StatusCode::CONFLICT, m),
-            Self::Domain(DomainError::InvalidInput(m))   => (StatusCode::UNPROCESSABLE_ENTITY, m),
-            Self::Domain(DomainError::Internal(_))       => (StatusCode::INTERNAL_SERVER_ERROR, "internal server error".into()),
-            Self::Unauthorized                           => (StatusCode::UNAUTHORIZED, "unauthorized".into()),
-            Self::BadRequest(m)                          => (StatusCode::BAD_REQUEST, m),
+            Self::Domain(DomainError::NotFound) => (StatusCode::NOT_FOUND, "not found".into()),
+            Self::Domain(DomainError::Unauthorized) => {
+                (StatusCode::UNAUTHORIZED, "unauthorized".into())
+            }
+            Self::Domain(DomainError::Forbidden) => (StatusCode::FORBIDDEN, "forbidden".into()),
+            Self::Domain(DomainError::Conflict(m)) => (StatusCode::CONFLICT, m),
+            Self::Domain(DomainError::InvalidInput(m)) => (StatusCode::UNPROCESSABLE_ENTITY, m),
+            Self::Domain(DomainError::Internal(_)) => (
+                StatusCode::INTERNAL_SERVER_ERROR,
+                "internal server error".into(),
+            ),
+            Self::Unauthorized => (StatusCode::UNAUTHORIZED, "unauthorized".into()),
+            Self::BadRequest(m) => (StatusCode::BAD_REQUEST, m),
         };
         (status, Json(ErrorResponse { error: msg })).into_response()
     }