feat(providers): implementar integração Providers ↔ ServiceCatalogs

- Criar comando e handler AddServiceToProviderCommand
  - Validação via IServiceCatalogsModuleApi.ValidateServicesAsync
  - Verifica existência e status ativo do serviço
  - Previne duplicação

- Criar comando e handler RemoveServiceFromProviderCommand
  - Remove associação provider-service
  - Valida que serviço está sendo oferecido

- Criar endpoints POST e DELETE /api/v1/providers/{providerId}/services/{serviceId}
  - Autorização SelfOrAdmin
  - Documentação OpenAPI completa
  - Códigos HTTP apropriados (204, 400, 404)

- Adicionar Bruno collections
  - AddServiceToProvider.bru
  - RemoveServiceFromProvider.bru

- Adicionar project reference ServiceCatalogs.Application ao Providers.Application

- Corrigir warning S1144 em ProviderService.Provider (remover setter privado)

Migrations e entities já existiam (criados previamente)
Tabela provider_services com chave composta (provider_id, service_id)
Eventos de domínio: ProviderServiceAddedDomainEvent, ProviderServiceRemovedDomainEvent

Author: Filipe Frigini

src/Bootstrapper/MeAjudaAi.ApiService/packages.lock.json

@@ -687,8 +687,7 @@
         "type": "Project",
         "dependencies": {
           "MeAjudaAi.Modules.Locations.Domain": "[1.0.0, )",
-          "MeAjudaAi.Shared": "[1.0.0, )",
-          "MediatR": "(, )"
+          "MeAjudaAi.Shared": "[1.0.0, )"
         }
       },
       "meajudaai.modules.locations.domain": {
@@ -718,6 +717,7 @@
         "type": "Project",
         "dependencies": {
           "MeAjudaAi.Modules.Providers.Domain": "[1.0.0, )",
+          "MeAjudaAi.Modules.ServiceCatalogs.Application": "[1.0.0, )",
           "MeAjudaAi.Shared": "[1.0.0, )"
         }
       },

src/Modules/Documents/Tests/packages.lock.json

@@ -1230,8 +1230,7 @@
         "type": "Project",
         "dependencies": {
           "MeAjudaAi.Modules.Locations.Domain": "[1.0.0, )",
-          "MeAjudaAi.Shared": "[1.0.0, )",
-          "MediatR": "(, )"
+          "MeAjudaAi.Shared": "[1.0.0, )"
         }
       },
       "meajudaai.modules.locations.domain": {
@@ -1264,6 +1263,7 @@
         "type": "Project",
         "dependencies": {
           "MeAjudaAi.Modules.Providers.Domain": "[1.0.0, )",
+          "MeAjudaAi.Modules.ServiceCatalogs.Application": "[1.0.0, )",
           "MeAjudaAi.Shared": "[1.0.0, )"
         }
       },

src/Modules/Locations/Tests/packages.lock.json

@@ -1241,6 +1241,7 @@
         "type": "Project",
         "dependencies": {
           "MeAjudaAi.Modules.Providers.Domain": "[1.0.0, )",
+          "MeAjudaAi.Modules.ServiceCatalogs.Application": "[1.0.0, )",
           "MeAjudaAi.Shared": "[1.0.0, )"
         }
       },

src/Modules/Providers/API/API.Client/ProviderServices/AddServiceToProvider.bru

@@ -0,0 +1,69 @@
+meta {
+  name: Add Service to Provider
+  type: http
+  seq: 14
+}
+
+post {
+  url: {{baseUrl}}/api/v1/providers/{{providerId}}/services/{{serviceId}}
+  body: none
+  auth: bearer
+}
+
+auth:bearer {
+  token: {{accessToken}}
+}
+
+headers {
+  Accept: application/json
+}
+
+docs {
+  # Add Service to Provider
+  
+  Adiciona um serviço do catálogo a um provider.
+  
+  ## Autorização
+  - **Permissão**: SelfOrAdmin
+  - **Requer token**: Sim
+  
+  ## Path Parameters
+  - **providerId**: ID do provider (UUID)
+  - **serviceId**: ID do serviço do catálogo (UUID)
+  
+  ## Validações
+  - O serviço deve existir no catálogo
+  - O serviço deve estar ativo
+  - O provider não pode já oferecer o serviço
+  - O provider não pode estar deletado
+  
+  ## Response
+  - **204 No Content**: Serviço adicionado com sucesso
+  - **400 Bad Request**: Serviço inválido, inativo ou já adicionado
+  - **404 Not Found**: Provider não encontrado
+  
+  ## Eventos de Domínio
+  - **ProviderServiceAddedDomainEvent**: Emitido após adição bem-sucedida
+  
+  ## Integração
+  - Valida serviço via **IServiceCatalogsModuleApi.ValidateServicesAsync**
+  - Verifica existência e status (ativo/inativo)
+}
+
+vars:post-response {
+  res: res.status
+}
+
+assert {
+  res.status: eq 204
+}
+
+tests {
+  test("Status code is 204", function() {
+    expect(res.getStatus()).to.equal(204);
+  });
+  
+  test("Service added successfully", function() {
+    console.log("Service added to provider: " + bru.getEnvVar("providerId"));
+  });
+}

src/Modules/Providers/API/API.Client/ProviderServices/RemoveServiceFromProvider.bru

@@ -0,0 +1,64 @@
+meta {
+  name: Remove Service from Provider
+  type: http
+  seq: 15
+}
+
+delete {
+  url: {{baseUrl}}/api/v1/providers/{{providerId}}/services/{{serviceId}}
+  body: none
+  auth: bearer
+}
+
+auth:bearer {
+  token: {{accessToken}}
+}
+
+headers {
+  Accept: application/json
+}
+
+docs {
+  # Remove Service from Provider
+  
+  Remove um serviço do catálogo de um provider.
+  
+  ## Autorização
+  - **Permissão**: SelfOrAdmin
+  - **Requer token**: Sim
+  
+  ## Path Parameters
+  - **providerId**: ID do provider (UUID)
+  - **serviceId**: ID do serviço do catálogo (UUID)
+  
+  ## Validações
+  - O provider deve existir
+  - O provider deve oferecer o serviço
+  - O provider não pode estar deletado
+  
+  ## Response
+  - **204 No Content**: Serviço removido com sucesso
+  - **400 Bad Request**: Serviço não é oferecido pelo provider
+  - **404 Not Found**: Provider não encontrado
+  
+  ## Eventos de Domínio
+  - **ProviderServiceRemovedDomainEvent**: Emitido após remoção bem-sucedida
+}
+
+vars:delete-response {
+  res: res.status
+}
+
+assert {
+  res.status: eq 204
+}
+
+tests {
+  test("Status code is 204", function() {
+    expect(res.getStatus()).to.equal(204);
+  });
+  
+  test("Service removed successfully", function() {
+    console.log("Service removed from provider: " + bru.getEnvVar("providerId"));
+  });
+}

src/Modules/Providers/API/Endpoints/ProviderServices/AddServiceToProviderEndpoint.cs

@@ -0,0 +1,62 @@
+using MeAjudaAi.Modules.Providers.Application.Commands;
+using MeAjudaAi.Shared.Commands;
+using MeAjudaAi.Shared.Endpoints;
+using MeAjudaAi.Shared.Functional;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Routing;
+
+namespace MeAjudaAi.Modules.Providers.API.Endpoints.ProviderServices;
+
+/// <summary>
+/// Endpoint para adicionar um serviço do catálogo a um provider.
+/// </summary>
+public class AddServiceToProviderEndpoint : BaseEndpoint
+{
+    public static void Map(IEndpointRouteBuilder app)
+        => app.MapPost("/api/v1/providers/{providerId:guid}/services/{serviceId:guid}", AddServiceAsync)
+            .WithName("AddServiceToProvider")
+            .WithTags("Providers - Services")
+            .WithSummary("Adiciona serviço ao provider")
+            .WithDescription("""
+                ### Adiciona um serviço do catálogo ao provider
+                
+                **Funcionalidades:**
+                - ✅ Valida existência e status do serviço via IServiceCatalogsModuleApi
+                - ✅ Verifica se o serviço está ativo
+                - ✅ Previne duplicação de serviços
+                - ✅ Emite evento de domínio ProviderServiceAddedDomainEvent
+                
+                **Campos obrigatórios:**
+                - providerId: ID do provider (UUID)
+                - serviceId: ID do serviço do catálogo (UUID)
+                
+                **Validações:**
+                - Serviço deve existir no catálogo
+                - Serviço deve estar ativo
+                - Provider não pode já oferecer o serviço
+                - Provider não pode estar deletado
+                """)
+            .Produces(StatusCodes.Status204NoContent)
+            .Produces(StatusCodes.Status400BadRequest)
+            .Produces(StatusCodes.Status404NotFound)
+            .RequireAuthorization("SelfOrAdmin");
+
+    /// <summary>
+    /// Processa requisição de adição de serviço ao provider.
+    /// </summary>
+    private static async Task<IResult> AddServiceAsync(
+        [FromRoute] Guid providerId,
+        [FromRoute] Guid serviceId,
+        ICommandDispatcher commandDispatcher,
+        CancellationToken cancellationToken)
+    {
+        var command = new AddServiceToProviderCommand(providerId, serviceId);
+        var result = await commandDispatcher.SendAsync<AddServiceToProviderCommand, Result>(command, cancellationToken);
+
+        return result.IsSuccess
+            ? Results.NoContent()
+            : Handle(result);
+    }
+}

src/Modules/Providers/API/Endpoints/ProviderServices/RemoveServiceFromProviderEndpoint.cs

@@ -0,0 +1,60 @@
+using MeAjudaAi.Modules.Providers.Application.Commands;
+using MeAjudaAi.Shared.Commands;
+using MeAjudaAi.Shared.Endpoints;
+using MeAjudaAi.Shared.Functional;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Routing;
+
+namespace MeAjudaAi.Modules.Providers.API.Endpoints.ProviderServices;
+
+/// <summary>
+/// Endpoint para remover um serviço do catálogo de um provider.
+/// </summary>
+public class RemoveServiceFromProviderEndpoint : BaseEndpoint
+{
+    public static void Map(IEndpointRouteBuilder app)
+        => app.MapDelete("/api/v1/providers/{providerId:guid}/services/{serviceId:guid}", RemoveServiceAsync)
+            .WithName("RemoveServiceFromProvider")
+            .WithTags("Providers - Services")
+            .WithSummary("Remove serviço do provider")
+            .WithDescription("""
+                ### Remove um serviço do catálogo do provider
+                
+                **Funcionalidades:**
+                - ✅ Remove associação entre provider e serviço
+                - ✅ Emite evento de domínio ProviderServiceRemovedDomainEvent
+                - ✅ Valida que o provider oferece o serviço antes de remover
+                
+                **Campos obrigatórios:**
+                - providerId: ID do provider (UUID)
+                - serviceId: ID do serviço do catálogo (UUID)
+                
+                **Validações:**
+                - Provider deve existir
+                - Provider deve oferecer o serviço
+                - Provider não pode estar deletado
+                """)
+            .Produces(StatusCodes.Status204NoContent)
+            .Produces(StatusCodes.Status400BadRequest)
+            .Produces(StatusCodes.Status404NotFound)
+            .RequireAuthorization("SelfOrAdmin");
+
+    /// <summary>
+    /// Processa requisição de remoção de serviço do provider.
+    /// </summary>
+    private static async Task<IResult> RemoveServiceAsync(
+        [FromRoute] Guid providerId,
+        [FromRoute] Guid serviceId,
+        ICommandDispatcher commandDispatcher,
+        CancellationToken cancellationToken)
+    {
+        var command = new RemoveServiceFromProviderCommand(providerId, serviceId);
+        var result = await commandDispatcher.SendAsync<RemoveServiceFromProviderCommand, Result>(command, cancellationToken);
+
+        return result.IsSuccess
+            ? Results.NoContent()
+            : Handle(result);
+    }
+}

src/Modules/Providers/API/packages.lock.json

@@ -484,6 +484,7 @@
         "type": "Project",
         "dependencies": {
           "MeAjudaAi.Modules.Providers.Domain": "[1.0.0, )",
+          "MeAjudaAi.Modules.ServiceCatalogs.Application": "[1.0.0, )",
           "MeAjudaAi.Shared": "[1.0.0, )"
         }
       },
@@ -502,6 +503,19 @@
           "MeAjudaAi.Shared": "[1.0.0, )"
         }
       },
+      "meajudaai.modules.servicecatalogs.application": {
+        "type": "Project",
+        "dependencies": {
+          "MeAjudaAi.Modules.ServiceCatalogs.Domain": "[1.0.0, )",
+          "MeAjudaAi.Shared": "[1.0.0, )"
+        }
+      },
+      "meajudaai.modules.servicecatalogs.domain": {
+        "type": "Project",
+        "dependencies": {
+          "MeAjudaAi.Shared": "[1.0.0, )"
+        }
+      },
       "meajudaai.shared": {
         "type": "Project",
         "dependencies": {

src/Modules/Providers/Application/Commands/AddServiceToProviderCommand.cs

@@ -0,0 +1,14 @@
+using MeAjudaAi.Shared.Commands;
+using MeAjudaAi.Shared.Functional;
+
+namespace MeAjudaAi.Modules.Providers.Application.Commands;
+
+/// <summary>
+/// Comando para adicionar um serviço do catálogo a um provider.
+/// </summary>
+/// <param name="ProviderId">ID do provider</param>
+/// <param name="ServiceId">ID do serviço do catálogo (módulo ServiceCatalogs)</param>
+public sealed record AddServiceToProviderCommand(
+    Guid ProviderId,
+    Guid ServiceId
+) : Command<Result>;

src/Modules/Providers/Application/Commands/RemoveServiceFromProviderCommand.cs

@@ -0,0 +1,14 @@
+using MeAjudaAi.Shared.Commands;
+using MeAjudaAi.Shared.Functional;
+
+namespace MeAjudaAi.Modules.Providers.Application.Commands;
+
+/// <summary>
+/// Comando para remover um serviço do catálogo de um provider.
+/// </summary>
+/// <param name="ProviderId">ID do provider</param>
+/// <param name="ServiceId">ID do serviço do catálogo (módulo ServiceCatalogs)</param>
+public sealed record RemoveServiceFromProviderCommand(
+    Guid ProviderId,
+    Guid ServiceId
+) : Command<Result>;