Feature/sprint 12 bookings messaging

docs/roadmap-history.md

@@ -4,6 +4,30 @@ Este documento contém o registro de todas as sprints concluídas para fins de a
 
 ---
 
+## ✅ Sprint 12 - Bookings & Messaging Excellence (Concluída em 21 Abr 2026)
+
+**Objetivo**: Implementar o sistema de agendamentos e consolidar a infraestrutura de mensageria com Rebus.
+
+### Entregas:
+- ✅ **Bookings Module**: Implementação completa (Backend/Frontend) de agendamentos com gestão de disponibilidade do prestador e fluxo de reserva do cliente.
+- ✅ **Messaging Excellence**: Migração final para Rebus v3 e implementação de atributos `[DedicatedTopic]`, `[HighVolumeEvent]` e `[CriticalEvent]` para roteamento avançado.
+- ✅ **Qualidade**: Cobertura total de testes unitários, integração e arquitetura para o novo módulo.
+- ✅ **API & Contratos**: Padronização de enums (`EBookingStatus`) e exposição via Minimal APIs com autorização.
+
+---
+
+## ✅ Sprint 11 - Monetização & Polimento (Concluída em 15 Abr 2026)
+
+**Objetivo**: Habilitar o faturamento da plataforma e finalizar a experiência do usuário.
+
+### Entregas:
+- ✅ **Payments Module**: Implementação de assinaturas (Stripe), webhooks, billing portal e renovações automáticas com padrão ACL.
+- ✅ **Localização Frontend**: Suporte completo a i18n (PT-BR/EN-US) no Customer App, incluindo formulários e erros.
+- ✅ **UX Polish**: Implementação de skeleton loaders animados para melhor percepção de desempenho.
+- ✅ **Qualidade**: Cobertura de testes unitários e de integração para todos os fluxos críticos de pagamento e localização.
+
+---
+
 ## ✅ Sprint 10 - Qualidade & Onboarding (Concluída em 14 Abr 2026)
 
 **Objetivo**: Estabelecer confiança na plataforma através de avaliações e simplificar o acesso de novos prestadores.

docs/roadmap.md

@@ -6,69 +6,40 @@ Este é o planejamento estratégico unificado da plataforma MeAjudaAi.
 
 ## 📊 Status Atual (Abril 2026)
 
-**Sprint Atual**: 11 (Monetização & Polimento)
-**Status**: ✅ Concluído
-**Meta MVP**: 12 - 16 de Maio de 2026
+**Sprint Atual**: 13 (Escala & Provedores Reais)
 
-**Stack Principal**: .NET 10 LTS + Aspire 13 + PostgreSQL + NX Monorepo + React 19 + Next.js 15 + Tailwind v4
-
----
-
-## ✅ Sprint 11 - Monetização & Polimento (13-27 Abr 2026) — Concluída em 15 Abr 2026
+**Status**: 🚀 Em Início
 
-**Objetivo**: Habilitar o faturamento da plataforma e finalizar a experiência do usuário.
+**Meta MVP**: 12 a 16 de maio de 2026
 
-### 🔴 MUST-HAVE:
-
-#### 1. 💳 Payments Module (Módulo de Pagamentos)
-*   **Arquitetura**: Padrão de **Anti-Corruption Layer (ACL)**. A lógica de negócio não conhece tipos do Stripe. Abstração via `IPaymentGateway`. ✅
-*   **Funcionalidades**:
-    *   ✅ **Assinaturas de Prestadores**: Planos Free, Standard e Gold — implementado com `CreateSubscriptionCommandHandler` com padrão gateway-first e compensação em caso de falha.
-    *   ✅ **Stripe Checkout & Webhooks**: Redirecionamento seguro via `CreateSubscriptionEndpoint` e processamento assíncrono via padrão Inbox (`ProcessInboxJob`).
-    *   ✅ **Qualidade & Testes**: Suíte completa de testes unitários e de integração validando fluxos críticos e tratamento de erros.
-    *   ✅ **Handler `invoice.paid`**: Processamento de renovações mensais e registro de `PaymentTransaction` para auditoria.
-    *   ✅ **Billing Portal**: Endpoint para gestão de assinaturas via Stripe Customer Portal.
-    *   **Localização & i18n**:
-        *   ✅ **Frontend (Customer App)**: Localização completa (PT-BR/EN-US) com suporte a pluralização e datas/moedas.
-        *   ✅ **Backend (FluentValidation)**: Integração de mensagens de validação com arquivos de recurso `.resx` (concluído na Sprint 9 e validado nesta).
-*   **Schema DB**: `payments` | **ModuleName**: `Payments`.
-
-#### 2. 🌍 Localização Frontend (i18n)
-*   **Arquitetura**: `i18next` + `react-i18next`. PT-BR como padrão, EN-US como alternativa.
-*   **Escopo Sprint 11**: App **Customer** (`MeAjudaAi.Web.Customer`) — navegação, formulários, erros Zod localizados, seletor de idioma no header. ✅
-*   **Qualidade**: Testes unitários com mock de i18n passando. ✅
-
-#### 3. 🎨 UX Polish
-*   ✅ **Skeletons de Carregamento**: Placeholders visuais animados (pulse) integrados nas listas de busca e perfil do prestador. Testes de unidade criados. ✅
+**Stack Principal**: .NET 10 LTS + Aspire 13 + PostgreSQL + NX Monorepo + React 19 + Next.js 15 + Tailwind v4
 
 ---
 
-## 🔮 Roadmaps Futuros (Pós-MVP)
+## 🔮 Roadmaps Futuros (MVP Launch & Além)
 
-### Fase 3: Escala e Provedores Reais
+### Fase 3: Escala e Provedores Reais (Próximas Atividades)
 *   **Provedores de Comunicação**: Substituir Stubs por SendGrid (E-mail), Twilio (SMS) e Firebase (Push).
 *   **Verificação Automatizada**: OCR via Azure AI Vision e integração com APIs de antecedentes criminais.
 *   **i18n Apps Provider/Admin**: Localização frontend para os apps de Prestador e Administrador.
 *   **Documentação Final**: Manuais de Usuário e Guias de Implantação (revisão global).
 
 ### Fase 4: Experiência e Engajamento
-*   **Módulo de Agendamentos (Bookings)**: Calendário de disponibilidade.
 *   **Sistema de Disputas**: Mediação administrativa para conflitos.
+*   **Melhorias em Bookings**: Sincronização com Google Calendar/Outlook e lembretes automáticos.
 
-### 🚀 Arquitetura Evolutiva e Mensageria (Desejável)
-*   **Evolução do Service Bus**: Implementar lógica de infraestrutura no `Shared.Messaging` para interpretar atributos de mensageria:
-    *   `[DedicatedTopic]`: Uso de `ITopicNameConvention` no Rebus para desviar eventos críticos/frequentes para filas dedicadas, evitando o "vizinho barulhento".
-    *   `[HighVolumeEvent]`: Otimização de I/O no RabbitMQ (mensagens transientes ou Lazy Queues) e paralelismo massivo via `SetNumberOfWorkers`.
-    *   `[CriticalEvent]`: Garantia de persistência via Quorum Queues e priorização de processamento (`x-max-priority`).
+### 🚀 Arquitetura Evolutiva e Mensageria (Objetivos)
+*   **Performance do Service Bus (Planejado)**: Implementar ajuste fino de paralelismo baseado no atributo `[HighVolumeEvent]` e otimizações no `RabbitMqInfrastructureManager`.
+*   **Resiliência Crítica (Planejado)**: Garantir persistência via Quorum Queues para eventos marcados com `[CriticalEvent]`.
+*   **Roteamento por Atributo (Em Andamento)**: Evolução do `AttributeTopicNameConvention` para suporte total a tópicos dedicados.
 
 ---
 
 ## ✅ Concluído Recentemente
 
-*   **Sprint 11**: Monetização completa (Checkout, Webhooks, Billing Portal, Renovação Automática), Localização i18n Frontend, Skeleton Loaders e cobertura de testes abrangente.
-*   **Sprint 10**: Módulo de Ratings, Moderação de Conteúdo, Login Social Instagram (#141), Alinhamento de Realms Keycloak, Infra CI/CD (OpenAPI gating) e Documentação (coleções Bruno).
-*   **Sprint 9**: Estabilização global, Módulo de Comunicações (Infra), Resiliência (`CancellationToken`) e Localização Backend (.resx).
-*   **Sprint 8D/8E**: Migração completa do Admin Portal para React e Testes E2E com Playwright.
+*   **Sprint 12**: Módulo de Bookings completo (Backend/Frontend), Migração final Rebus v3, Atributos de roteamento avançado e testes de arquitetura. (Abril 2026)
+*   **Sprint 11**: Monetização completa (Checkout, Webhooks, Billing Portal, Renovação Automática), Localização i18n Frontend, Skeleton Loaders e cobertura de testes abrangente. (Abril 2026)
+*   **Sprint 10**: Módulo de Ratings, Moderação de Conteúdo, Login Social Instagram (#141), Alinhamento de Realms Keycloak, Infra CI/CD (OpenAPI gating) e Documentação (coleções Bruno). (Abril 2026)
 
 ---
 

docs/technical-debt.md

@@ -13,13 +13,6 @@ Este documento rastreia **débitos técnicos e seu histórico de otimização**.
 
 - [ ] Perfilagem de memória em produção
 
-### 🚀 Infraestrutura & Messaging
-
-**Severidade**: MÉDIA  
-**Sprint**: Backlog
-
-- [ ] Avaliar migração para Rebus v3 ou alternativa de Enterprise Service Bus (ESB) assim que a compatibilidade com .NET 10 e `Rebus.ServiceProvider` (v10+) for estabilizada. Atualmente, o sistema utiliza `RabbitMQ.Client` diretamente com middleware de retry customizado.
-
 ### 🎨 Melhorias de UI/UX
 
 **Severidade**: BAIXA  
@@ -35,6 +28,11 @@ Este documento rastreia **débitos técnicos e seu histórico de otimização**.
 
 ## 📋 Histórico
 
+### 🚀 Infraestrutura & Messaging (Migração Rebus v3)
+
+**Resolvido em**: Abr 2026 (Sprint 12) | **Severidade original**: MÉDIA  
+Migração para Rebus v3 concluída. Implementação do `RebusMessageBus` como abstração principal (`IMessageBus`) e remoção do uso direto de `RabbitMQ.Client` nos módulos. Introdução de atributos de roteamento avançado (`[DedicatedTopic]`, `[HighVolumeEvent]`, `[CriticalEvent]`) e convenções customizadas.
+
 ### ⚠️ Hangfire + Npgsql 10.x Compatibility Risk
 
 **Resolvido em**: Abr 2026 (Sprint 11) | **Severidade original**: CRÍTICA  

src/Aspire/MeAjudaAi.AppHost/packages.lock.json

@@ -1153,6 +1153,30 @@
           "Npgsql": "10.0.2"
         }
       },
+      "OpenTelemetry": {
+        "type": "Transitive",
+        "resolved": "1.15.3",
+        "contentHash": "N0i6WjPoHPbZyms1ugbDIFAJFuGlpeExJMU/+XSL0lQRUkg/D0utFkDoLXf8Z1km5B+xVZ2GyMXXiX8qdeNmPg==",
+        "dependencies": {
+          "Microsoft.Extensions.Diagnostics.Abstractions": "10.0.0",
+          "Microsoft.Extensions.Logging.Configuration": "10.0.0",
+          "OpenTelemetry.Api.ProviderBuilderExtensions": "1.15.3"
+        }
+      },
+      "OpenTelemetry.Api": {
+        "type": "Transitive",
+        "resolved": "1.15.3",
+        "contentHash": "fX+fkCysfPut+qCcT3bKqyX4QN9Saf4CgX8HLOHywEVD+Xr7sULtfuypITpoDysjx8R59dn/3mWhgimMH8cm/g=="
+      },
+      "OpenTelemetry.Api.ProviderBuilderExtensions": {
+        "type": "Transitive",
+        "resolved": "1.15.3",
+        "contentHash": "SYn0lqYDwLMWhv/zlNGsQcl2yX++yTumanX46bmOZE/ZDOd1WjPBO2kZaZgKLEZTZk48pavIFGJ6vOvxXgWVFQ==",
+        "dependencies": {
+          "Microsoft.Extensions.DependencyInjection.Abstractions": "10.0.0",
+          "OpenTelemetry.Api": "1.15.3"
+        }
+      },
       "Pipelines.Sockets.Unofficial": {
         "type": "Transitive",
         "resolved": "2.2.8",
@@ -1446,6 +1470,7 @@
           "Microsoft.Extensions.Caching.StackExchangeRedis": "[10.0.6, )",
           "Microsoft.FeatureManagement.AspNetCore": "[4.4.0, )",
           "Npgsql.EntityFrameworkCore.PostgreSQL": "[10.0.1, )",
+          "OpenTelemetry.Exporter.Console": "[1.15.3, )",
           "RabbitMQ.Client": "[7.2.1, )",
           "Rebus": "[8.9.2, )",
           "Rebus.RabbitMq": "[10.1.1, )",
@@ -1883,6 +1908,15 @@
           "Npgsql.NetTopologySuite": "10.0.2"
         }
       },
+      "OpenTelemetry.Exporter.Console": {
+        "type": "CentralTransitive",
+        "requested": "[1.15.3, )",
+        "resolved": "1.15.3",
+        "contentHash": "QBGOoPwLHDXX+hXeUpspOjsqEn4vMkLw672QN+MzVWFBzjf625DdxLxhzowS1J/dRtW93U34rRbJec+4808fkg==",
+        "dependencies": {
+          "OpenTelemetry": "1.15.3"
+        }
+      },
       "RabbitMQ.Client": {
         "type": "CentralTransitive",
         "requested": "[7.2.1, )",

src/Aspire/MeAjudaAi.ServiceDefaults/packages.lock.json

@@ -542,6 +542,7 @@
           "Microsoft.Extensions.Caching.StackExchangeRedis": "[10.0.6, )",
           "Microsoft.FeatureManagement.AspNetCore": "[4.4.0, )",
           "Npgsql.EntityFrameworkCore.PostgreSQL": "[10.0.1, )",
+          "OpenTelemetry.Exporter.Console": "[1.15.3, )",
           "RabbitMQ.Client": "[7.2.1, )",
           "Rebus": "[8.9.2, )",
           "Rebus.RabbitMq": "[10.1.1, )",

src/Bootstrapper/MeAjudaAi.ApiService/MeAjudaAi.ApiService.csproj

@@ -30,6 +30,7 @@
     <ProjectReference Include="..\..\Modules\Documents\API\MeAjudaAi.Modules.Documents.API.csproj" />
     <ProjectReference Include="..\..\Modules\Locations\API\MeAjudaAi.Modules.Locations.API.csproj" />
     <ProjectReference Include="..\..\Modules\Payments\API\MeAjudaAi.Modules.Payments.API.csproj" />
+    <ProjectReference Include="..\..\Modules\Bookings\API\MeAjudaAi.Modules.Bookings.API.csproj" />
     <ProjectReference Include="..\..\Modules\Providers\API\MeAjudaAi.Modules.Providers.API.csproj" />
     <ProjectReference Include="..\..\Modules\Ratings\API\MeAjudaAi.Modules.Ratings.API.csproj" />
     <ProjectReference Include="..\..\Modules\SearchProviders\API\MeAjudaAi.Modules.SearchProviders.API.csproj" />

src/Bootstrapper/MeAjudaAi.ApiService/MigrationExtensions.cs

@@ -28,7 +28,10 @@ public static async Task ApplyModuleMigrationsAsync(this IHost app, Cancellation
             { "Documents", 4 },
             { "Providers", 5 },
             { "Communications", 6 },
-            { "SearchProviders", 7 }
+            { "Ratings", 7 },
+            { "Payments", 8 },
+            { "Bookings", 9 },
+            { "SearchProviders", 10 }
         };
 
         dbContextTypes = dbContextTypes.OrderBy(t => 

src/Bootstrapper/MeAjudaAi.ApiService/Program.cs

@@ -8,6 +8,7 @@
 using MeAjudaAi.Modules.Providers.API;
 using MeAjudaAi.Modules.Ratings.API;
 using MeAjudaAi.Modules.Payments.API;
+using MeAjudaAi.Modules.Bookings.API;
 using MeAjudaAi.Modules.SearchProviders.API;
 using MeAjudaAi.Modules.ServiceCatalogs.API;
 using MeAjudaAi.Modules.Users.API;
@@ -53,6 +54,7 @@ public static async Task Main(string[] args)
             builder.Services.AddCommunicationsModule(builder.Configuration);
             builder.Services.AddRatingsModule(builder.Configuration, builder.Environment);
             builder.Services.AddPaymentsModule(builder.Configuration, builder.Environment);
+            builder.Services.AddBookingsModule(builder.Configuration, builder.Environment);
 
             // Shared services por último (GlobalExceptionHandler atua como fallback)
             builder.Services.AddSharedServices(builder.Configuration);
@@ -139,8 +141,10 @@ private static async Task ConfigureMiddlewareAsync(WebApplication app)
         app.UseCommunicationsModule();
         app.UseRatingsModule();
         app.UsePaymentsModule();
+        app.UseBookingsModule();
 
         // Endpoints de orquestração cross-módulo (ficam no ApiService)
+        app.MapBookingsEndpoints();
         app.MapProviderRegistrationEndpoints();
         app.MapCommunicationsEndpoints();
     }

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

@@ -578,6 +578,33 @@
           "FluentValidation": "[12.1.1, )"
         }
       },
+      "meajudaai.modules.bookings.api": {
+        "type": "Project",
+        "dependencies": {
+          "MeAjudaAi.Modules.Bookings.Infrastructure": "[1.0.0, )"
+        }
+      },
+      "meajudaai.modules.bookings.application": {
+        "type": "Project",
+        "dependencies": {
+          "MeAjudaAi.Modules.Bookings.Domain": "[1.0.0, )"
+        }
+      },
+      "meajudaai.modules.bookings.domain": {
+        "type": "Project",
+        "dependencies": {
+          "MeAjudaAi.Shared": "[1.0.0, )"
+        }
+      },
+      "meajudaai.modules.bookings.infrastructure": {
+        "type": "Project",
+        "dependencies": {
+          "MeAjudaAi.Modules.Bookings.Application": "[1.0.0, )",
+          "MeAjudaAi.Shared": "[1.0.0, )",
+          "Microsoft.EntityFrameworkCore": "[10.0.6, )",
+          "Npgsql.EntityFrameworkCore.PostgreSQL": "[10.0.1, )"
+        }
+      },
       "meajudaai.modules.communications.api": {
         "type": "Project",
         "dependencies": {
@@ -909,6 +936,7 @@
           "Microsoft.Extensions.Caching.StackExchangeRedis": "[10.0.6, )",
           "Microsoft.FeatureManagement.AspNetCore": "[4.4.0, )",
           "Npgsql.EntityFrameworkCore.PostgreSQL": "[10.0.1, )",
+          "OpenTelemetry.Exporter.Console": "[1.15.3, )",
           "RabbitMQ.Client": "[7.2.1, )",
           "Rebus": "[8.9.2, )",
           "Rebus.RabbitMq": "[10.1.1, )",

src/Contracts/Bookings/Enums/EBookingStatus.cs

@@ -0,0 +1,10 @@
+namespace MeAjudaAi.Contracts.Bookings.Enums;
+
+public enum EBookingStatus
+{
+    Pending = 0,
+    Confirmed = 1,
+    Cancelled = 2,
+    Completed = 3,
+    Rejected = 4
+}

src/Modules/Bookings/API/Endpoints/BookingsEndpoints.cs

@@ -0,0 +1,24 @@
+using MeAjudaAi.Modules.Bookings.API.Endpoints.Public;
+using MeAjudaAi.Shared.Endpoints;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Routing;
+
+namespace MeAjudaAi.Modules.Bookings.API.Endpoints;
+
+public static class BookingsEndpoints
+{
+    public const string Route = "bookings";
+    public const string Tag = "Bookings";
+
+    public static void Map(IEndpointRouteBuilder app)
+    {
+        var group = BaseEndpoint.CreateVersionedGroup(app, Route, Tag);
+
+        group.MapEndpoint<CreateBookingEndpoint>()
+             .MapEndpoint<ConfirmBookingEndpoint>()
+             .MapEndpoint<CancelBookingEndpoint>()
+             .MapEndpoint<GetProviderAvailabilityEndpoint>()
+             .MapEndpoint<SetProviderScheduleEndpoint>();
+    }
+}

src/Modules/Bookings/API/Endpoints/Public/CancelBookingEndpoint.cs

@@ -0,0 +1,52 @@
+using MeAjudaAi.Contracts.Functional;
+using MeAjudaAi.Modules.Bookings.Application.Bookings.Commands;
+using MeAjudaAi.Shared.Commands;
+using MeAjudaAi.Shared.Endpoints;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Routing;
+
+namespace MeAjudaAi.Modules.Bookings.API.Endpoints.Public;
+
+public class CancelBookingEndpoint : IEndpoint
+{
+    public static void Map(IEndpointRouteBuilder app)
+    {
+        app.MapPut("/{id}/cancel", async (
+            Guid id,
+            CancelBookingRequest request,
+            [FromServices] ICommandDispatcher dispatcher,
+            CancellationToken cancellationToken) =>
+        {
+            if (string.IsNullOrWhiteSpace(request.Reason))
+            {
+                return Results.BadRequest(new { error = "O motivo do cancelamento é obrigatório." });
+            }
+
+            if (request.Reason.Length > 500)
+            {
+                return Results.BadRequest(new { error = "O motivo do cancelamento não pode exceder 500 caracteres." });
+            }
+
+            var command = new CancelBookingCommand(id, request.Reason, Guid.NewGuid());
+            var result = await dispatcher.SendAsync<CancelBookingCommand, Result>(command, cancellationToken);
+
+            return result.Match(
+                onSuccess: () => Results.NoContent(),
+                onFailure: error => Results.Problem(error.Message, statusCode: error.StatusCode)
+            );
+        })
+        .RequireAuthorization()
+        .Produces(StatusCodes.Status204NoContent)
+        .ProducesProblem(StatusCodes.Status400BadRequest)
+        .ProducesProblem(StatusCodes.Status401Unauthorized)
+        .ProducesProblem(StatusCodes.Status403Forbidden)
+        .ProducesProblem(StatusCodes.Status404NotFound)
+        .WithTags(BookingsEndpoints.Tag)
+        .WithName("CancelBooking")
+        .WithSummary("Cancela um agendamento.");
+    }
+}
+
+public record CancelBookingRequest(string Reason);