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/worker/src/main.rs

@@ -1,8 +1,8 @@
 mod factory;
 mod handlers;
 
-use futures::StreamExt;
 use domain::ports::EventConsumer;
+use futures::StreamExt;
 
 #[tokio::main]
 async fn main() {
@@ -12,8 +12,8 @@ async fn main() {
         .init();
 
     let database_url = std::env::var("DATABASE_URL").expect("DATABASE_URL required");
-    let nats_url     = std::env::var("NATS_URL").unwrap_or_else(|_| "nats://localhost:4222".into());
-    let base_url     = std::env::var("BASE_URL").expect("BASE_URL required");
+    let nats_url = std::env::var("NATS_URL").unwrap_or_else(|_| "nats://localhost:4222".into());
+    let base_url = std::env::var("BASE_URL").expect("BASE_URL required");
 
     tracing::info!("Building worker...");
     let (consumer, handlers) = factory::build(&database_url, &base_url, &nats_url).await;
@@ -32,8 +32,12 @@ async fn main() {
                 if n.is_ok() && f.is_ok() {
                     (envelope.ack)();
                 } else {
-                    if let Err(e) = n { tracing::error!("notification handler: {e}"); }
-                    if let Err(e) = f { tracing::error!("federation handler: {e}");   }
+                    if let Err(e) = n {
+                        tracing::error!("notification handler: {e}");
+                    }
+                    if let Err(e) = f {
+                        tracing::error!("federation handler: {e}");
+                    }
                     (envelope.nack)();
                 }
             }