Merge pull request #273 from MikeFalcon77/refactor/233-move_local_clients_last

chore(layout and doc): local clients moved under ./domain folders

Author: Artifizer

docs/ARCHITECTURE_MANIFEST.md

@@ -252,26 +252,6 @@ hyperspot/
  Every module follows a **Domain-Driven Design (DDD-light)** structure:
 
 ```
-modules/<module-name>/
-├── Cargo.toml
-├── src/
-│   ├── lib.rs                        # Public exports
-│   ├── module.rs                     # Module struct + #[modkit::module(...)]
-│   ├── config.rs                     # Typed module config
-│   ├── local_client.rs               # Local adapter implementing an SDK API trait (optional)
-│   ├── api/
-│   │   └── rest/
-│   │       ├── dto.rs                # REST-only DTOs (serde + ToSchema)
-│   │       ├── handlers.rs           # Thin HTTP handlers
-│   │       ├── routes.rs             # Route + OpenAPI registration (OperationBuilder)
-│   │       ├── error.rs              # DomainError -> Problem mapping
-│   │       └── mappers.rs            # DTO <-> domain mapping
-│   ├── domain/                       # Business logic
-│   └── infra/                        # Infrastructure adapters (optional)
-├── tests/                            # Optional
-└── (optional extras: gts/, openspec/, build.rs, etc.)
-
-# SDK pattern (used by e.g. `modules/system/types-registry/` and `examples/modkit/users_info/`)
 modules/<module-dir>/
 ├── <module-name>-sdk/
 │   ├── Cargo.toml
@@ -285,13 +265,21 @@ modules/<module-dir>/
 └── <module-name>/
     ├── Cargo.toml
     └── src/
-        ├── lib.rs                    # Re-exports SDK + module struct
-        ├── module.rs                 # Module struct + #[modkit::module(...)]
-        ├── config.rs
-        ├── local_client.rs
+        ├── lib.rs                        # Public exports
+        ├── module.rs                     # Module struct + #[modkit::module(...)]
+        ├── config.rs                     # Typed module config
         ├── api/
-        ├── domain/
-        └── infra/
+        │   └── rest/
+        │       ├── dto.rs                # REST-only DTOs (serde + ToSchema)
+        │       ├── handlers.rs           # Thin HTTP handlers
+        │       ├── routes.rs             # Route + OpenAPI registration (OperationBuilder)
+        │       ├── error.rs              # DomainError -> Problem mapping
+        │       └── mappers.rs            # DTO <-> domain mapping
+        ├── domain/                       # Business logic
+        ├── local_client.rs               # Local adapter implementing an SDK API trait (optional)
+        ├── infra/                        # Infrastructure adapters (optional)
+        ├── tests/                        # Optional
+        └── (optional extras: gts/, openspec/, build.rs, etc.)
 ```
 
 Additional common patterns (see `examples/`):

docs/MODKIT_PLUGINS.md

@@ -220,10 +220,10 @@ modules/<gateway-name>/
 │       ├── lib.rs              # Re-exports SDK + module struct
 │       ├── module.rs           # Module declaration, init, REST registration
 │       ├── config.rs           # Gateway config (e.g., vendor selection)
-│       ├── local_client.rs     # Public client adapter (implements PublicClient)
 │       ├── api/rest/           # REST handlers, DTOs, routes
 │       └── domain/
 │           ├── service.rs      # Plugin resolution and delegation
+│           ├── local_client.rs # Public client adapter (implements PublicClient)
 │           └── error.rs        # Domain errors
 │
 └── plugins/                    # Plugin implementations

…info/src/infra/local_client/addresses.rs …nfo/src/domain/local_client/addresses.rsexamples/modkit/users_info/users_info/src/infra/local_client/addresses.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/addresses.rs examples/modkit/users_info/users_info/src/infra/local_client/addresses.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/addresses.rs

@@ -10,7 +10,7 @@ use user_info_sdk::{
     UpdateUserRequest, User, UserFull, UsersInfoClient, UsersInfoError,
 };
 
-use crate::infra::local_client::{
+use crate::domain::local_client::{
     addresses::LocalAddressesStreamingClient, cities::LocalCitiesStreamingClient,
     users::LocalUsersStreamingClient,
 };

…rs_info/src/infra/local_client/cities.rs …s_info/src/domain/local_client/cities.rsexamples/modkit/users_info/users_info/src/infra/local_client/cities.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/cities.rs examples/modkit/users_info/users_info/src/infra/local_client/cities.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/cities.rs

@@ -1,5 +1,6 @@
 pub mod error;
 pub mod events;
+pub mod local_client;
 pub mod ports;
 pub mod repos;
 pub mod service;

…rs_info/src/infra/local_client/client.rs …s_info/src/domain/local_client/client.rsexamples/modkit/users_info/users_info/src/infra/local_client/client.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/client.rs examples/modkit/users_info/users_info/src/infra/local_client/client.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/client.rs

@@ -1,3 +1,2 @@
 pub mod audit;
-pub mod local_client;
 pub mod storage;

…users_info/src/infra/local_client/mod.rs …sers_info/src/domain/local_client/mod.rsexamples/modkit/users_info/users_info/src/infra/local_client/mod.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/mod.rs examples/modkit/users_info/users_info/src/infra/local_client/mod.rs renamed to examples/modkit/users_info/users_info/src/domain/local_client/mod.rs

@@ -21,10 +21,10 @@ use crate::api::rest::routes;
 use crate::api::rest::sse_adapter::SseUserEventPublisher;
 use crate::config::UsersInfoConfig;
 use crate::domain::events::UserDomainEvent;
+use crate::domain::local_client::client::UsersInfoLocalClient;
 use crate::domain::ports::{AuditPort, EventPublisher};
 use crate::domain::service::{AppServices, ServiceConfig};
 use crate::infra::audit::HttpAuditClient;
-use crate::infra::local_client::client::UsersInfoLocalClient;
 use crate::infra::storage::{OrmAddressesRepository, OrmCitiesRepository, OrmUsersRepository};
 
 /// Type alias for the concrete `AppServices` type used with ORM repositories.