Refactor and enhance SurrealDB integration and resource management

- Updated `lib.rs` to selectively expose specific entities and services for better clarity.
- Improved SurrealDB client initialization with detailed logging in `surrealdb/mod.rs`.
- Enhanced resource definitions in `resource.rs` with additional utility methods for better resource management.
- Refactored user data retrieval logic in `auth_middleware/mod.rs` for improved readability and efficiency.
- Cleaned up middleware exports in `lib.rs` for clearer API surface.
- Added detailed comments and documentation throughout the SurrealDB module for better maintainability.
- Updated tests to ensure compatibility with new changes and improved structure.
- Introduced new permissions module structure in `imphnen-utils` for future enhancements.

imphnen-gateway/src/lib.rs

@@ -1,51 +1,60 @@
 use axum::{
-	Extension, Router, middleware::from_fn, response::Redirect, routing::get,
+    Extension,
+    Router,
+    middleware::from_fn,
+    response::Redirect,
+    routing::get,
 };
 use imphnen_cms::{
-	events_protected_routes, events_public_routes, testimonials_protected_routes,
-	testimonials_public_routes,
+    events_protected_routes,
+    events_public_routes,
+    testimonials_protected_routes,
+    testimonials_public_routes,
 };
 use imphnen_dimentorin::dimentorin_router;
-use imphnen_libs::{AppState, SurrealMemClient, SurrealWsClient};
 use imphnen_gacha::gacha_router;
-use imphnen_iam::{iam_protected_routes, iam_public_routes, v1::users::users_service::UsersService, v1::auth::auth_repository::AuthRepoImpl};
+use imphnen_iam::{
+    iam_protected_routes,
+    iam_public_routes,
+    v1::users::users_service::UsersService,
+    v1::auth::auth_repository::AuthRepoImpl,
+};
+use imphnen_libs::{AppState, SurrealMemClient, SurrealWsClient};
 use imphnen_middleware::{auth_middleware, cors_middleware};
 use std::sync::Arc;
 use utoipa_swagger_ui::SwaggerUi;
 
 pub mod docs;
-pub use docs::*;
+pub use docs::{ApiDoc, SecurityAddon, docs_router};
 
 pub async fn gateway_service(
-	surrealdb_ws: SurrealWsClient,
-	surrealdb_mem: SurrealMemClient,
+    surrealdb_ws: SurrealWsClient,
+    surrealdb_mem: SurrealMemClient,
 ) -> Router {
-	let state = AppState {
-		surrealdb_ws,
-		surrealdb_mem: surrealdb_mem.clone(),
-		user_lookup_service: Arc::new(UsersService),
-		auth_repository: Arc::new(AuthRepoImpl { db: surrealdb_mem }),
-	};
+    let state = AppState {
+        surrealdb_ws,
+        surrealdb_mem: surrealdb_mem.clone(),
+        user_lookup_service: Arc::new(UsersService),
+        auth_repository: Arc::new(AuthRepoImpl { db: surrealdb_mem }),
+    };
 
-	let public_routes = Router::new()
-		.merge(iam_public_routes())
-		.merge(testimonials_public_routes())
-		.merge(events_public_routes());
+    let public_routes = Router::new()
+        .merge(iam_public_routes())
+        .merge(testimonials_public_routes())
+        .merge(events_public_routes());
 
-	let protected_routes = Router::new()
-		.merge(iam_protected_routes())
-		.merge(events_protected_routes())
-		.merge(testimonials_protected_routes())
-		.merge(dimentorin_router())
-		.merge(gacha_router())
-		.layer(from_fn(auth_middleware));
+    let protected_routes = Router::new()
+        .merge(iam_protected_routes())
+        .merge(events_protected_routes())
+        .merge(testimonials_protected_routes())
+        .merge(dimentorin_router())
+        .merge(gacha_router())
+        .layer(from_fn(auth_middleware));
 
-	let routes = public_routes.merge(protected_routes);
-
-	Router::new()
-		.route("/", get(Redirect::to("/docs")))
-		.nest("/v1", routes)
-		.merge(SwaggerUi::new("/docs").url("/openapi.json", docs_router()))
-		.layer(cors_middleware())
-		.layer(Extension(state))
+    Router::new()
+        .route("/", get(Redirect::to("/docs")))
+        .nest("/v1", public_routes.merge(protected_routes))
+        .merge(SwaggerUi::new("/docs").url("/openapi.json", docs_router()))
+        .layer(cors_middleware())
+        .layer(Extension(state))
 }