doc(main): Updated documentation (#339)

Author: ekkinox

docs/demos/grpc-application.md

@@ -22,11 +22,12 @@ This demo application is following the [recommended project layout](https://go.d
 
 - `cmd/`: entry points
 - `configs/`: configuration files
-- `internal/`:
-  	- `interceptor/`: gRPC interceptors
-  	- `service/`: gRPC services
-  	- `bootstrap.go`: bootstrap
-  	- `register.go`: dependencies registration
+  - `internal/`:
+    - `api/`: gRPC API
+      - `interceptor/`: gRPC interceptors
+      - `service/`: gRPC services
+    - `bootstrap.go`: bootstrap
+    - `register.go`: dependencies registration
 - `proto/`: protobuf definition and stubs
 
 ### Makefile
@@ -76,7 +77,7 @@ This demo application also provides [reflection](../modules/fxgrpcserver.md#refl
 
 ### Authentication
 
-This demo application provides example [authentication interceptors](https://github.com/ankorstore/yokai-showroom/tree/main/grpc-demo/internal/interceptor/authentication.go).
+This demo application provides example [authentication interceptors](https://github.com/ankorstore/yokai-showroom/tree/main/grpc-demo/internal/api/interceptor/authentication.go).
 
 You can enable authentication in the application [configuration file](https://github.com/ankorstore/yokai-showroom/tree/main/grpc-demo/configs/config.yaml) with `config.authentication.enabled=true`.
 

docs/demos/http-application.md

@@ -27,11 +27,13 @@ This demo application is following the [recommended project layout](https://go.d
 	- `migrations/`: database migrations
 	- `seeds/`: database seeds
 - `internal/`:
-	- `handler/`: HTTP handlers
-	- `middleware/`: HTTP middlewares
-	- `model/`: models
-	- `repository/`: models repositories
-	- `service/`: services
+	- `api/`: HTTP API
+		- `handler/`: HTTP handlers
+		- `middleware/`: HTTP middlewares
+	- `domain/`: domain
+		- `model.go`: gophers model
+		- `repository.go`: gophers repository
+		- `service.go`: gophers service
 	- `bootstrap.go`: bootstrap
 	- `register.go`: dependencies registration
 	- `router.go`: routing registration
@@ -81,7 +83,7 @@ On [http://localhost:8080](http://localhost:8080), you can use:
 
 ### Authentication
 
-This demo application provides an example [authentication middleware](https://github.com/ankorstore/yokai-showroom/blob/main/http-demo/internal/middleware/authentication.go).
+This demo application provides an example [authentication middleware](https://github.com/ankorstore/yokai-showroom/blob/main/http-demo/internal/api/middleware/authentication.go).
 
 You can enable authentication in the application [configuration file](https://github.com/ankorstore/yokai-showroom/blob/main/http-demo/configs/config.yaml) with `config.authentication.enabled=true`.
 

docs/modules/fxmcpserver.md

@@ -694,7 +694,7 @@ func TestMCPPing(t *testing.T) {
 
 	// assertion on the metrics registry
 	expectedMetric := `
-		# HELP mcp_server_requests_total Number of processed HTTP requests
+		# HELP mcp_server_requests_total Number of processed MCP requests
 		# TYPE mcp_server_requests_total counter
 		mcp_server_requests_total{method="ping",status="success",target=""} 1
 	`