frigini · frigini · Apr 21, 2026 · Apr 21, 2026 · Apr 21, 2026 · Apr 21, 2026
diff --git a/.github/workflows/ci-backend.yml b/.github/workflows/ci-backend.yml
@@ -178,6 +178,7 @@ jobs:
             "src/Modules/Ratings/Tests/MeAjudaAi.Modules.Ratings.Tests.csproj"
             "src/Modules/SearchProviders/Tests/MeAjudaAi.Modules.SearchProviders.Tests.csproj"
             "src/Modules/Payments/Tests/MeAjudaAi.Modules.Payments.Tests.csproj"
+            "src/Modules/Bookings/Tests/MeAjudaAi.Modules.Bookings.Tests.csproj"
             "tests/MeAjudaAi.Shared.Tests/MeAjudaAi.Shared.Tests.csproj"
             "tests/MeAjudaAi.ApiService.Tests/MeAjudaAi.ApiService.Tests.csproj"
             "tests/MeAjudaAi.Architecture.Tests/MeAjudaAi.Architecture.Tests.csproj"
@@ -268,7 +269,7 @@ jobs:
           reporttypes: "Cobertura;JsonSummary"
           groupby: "Namespace"
           assemblyfilters: "+MeAjudaAi.*;-MeAjudaAi.AppHost;-MeAjudaAi.ServiceDefaults;-MeAjudaAi.Contracts;-MeAjudaAi.Modules.Ratings.API"
-          classfilters: "+*;-*.Tests;-*.Tests.*;-*Test*;-testhost;-*.Migrations.*;-*Program*;-*.Seeding.*;-*DbContextFactory;+MeAjudaAi.Modules.Payments.API.*Endpoint;-*Endpoint;-*Options;-*IntegrationEvent;-*Request;-*Response;-*Dto;-*DTO"
+          classfilters: "+*;-*.Tests;-*.Tests.*;-*Test*;-testhost;-*.Migrations.*;-*Program*;-*.Seeding.*;-*DbContextFactory;+MeAjudaAi.Modules.Payments.API.*Endpoint;+MeAjudaAi.Modules.Bookings.API.*Endpoint;-*Endpoint;-*Options;-*IntegrationEvent;-*Request;-*Response;-*Dto;-*DTO"
 
       - name: Upload coverage reports
         uses: actions/upload-artifact@v4
@@ -285,7 +286,7 @@ jobs:
           badge: true
           format: markdown
           output: both
-          thresholds: "85 75" # line branch (temporário - reverter para 90/80 em sprints futuras)
+          thresholds: "90 80" # line branch
           fail_below_min: true
 
       - name: Generate Coverage PR Comment
@@ -363,11 +364,55 @@ jobs:
           fi
 
       - name: Check for Breaking Changes
+        id: breaking-changes
         uses: oasdiff/oasdiff-action/breaking@v0.0.39
+        continue-on-error: true # Permitir falhas durante a Sprint 12 para evolução de contrato
         with:
           base: 'api-base.json'
           revision: 'api-current/api-spec.json'
           fail-on: 'ERR'
+          err-ignore: '.oasdiff-ignore.yaml'
+
+      - name: Warn if Breaking Changes Found
+        if: steps.breaking-changes.outcome == 'failure'
+        run: |
+          echo "::warning title=Breaking Changes Detected::Changes that break the API contract were found. Review the oasdiff output above."
+
+      - name: Post Breaking Changes PR Comment
+        if: steps.breaking-changes.outcome == 'failure'
+        uses: marocchino/sticky-pull-request-comment@v3
+        with:
+          recreate: true
+          header: oasdiff-breaking-changes
+          message: |
+            ## ⚠️ Breaking Changes Detectados
+
+            O `oasdiff` identificou mudanças que quebram o contrato da API em relação à branch base (`${{ github.base_ref }}`).
+
+            **Ação necessária:** Revise os logs do step _Check for Breaking Changes_ acima e garanta que as alterações são intencionais e documentadas em `.oasdiff-ignore.yaml`.
+
+      - name: Clear Breaking Changes PR Comment
+        if: steps.breaking-changes.outcome == 'success'
+        uses: marocchino/sticky-pull-request-comment@v3
+        with:
+          recreate: true
+          header: oasdiff-breaking-changes
+          message: |
+            ## ✅ Contrato da API Validado
+
+            Nenhuma breaking change detectada pelo `oasdiff` em relação à branch base.
+
+      - name: Ensure Breaking Changes PR Comment State
+        if: always() && (steps.breaking-changes.outcome == 'skipped' || steps.breaking-changes.outcome == 'cancelled')
+        uses: marocchino/sticky-pull-request-comment@v3
+        with:
+          recreate: true
+          header: oasdiff-breaking-changes
+          message: |
+            ## ℹ️ Validação de Contrato Indisponível
+
+            A verificação de breaking changes foi **${{ steps.breaking-changes.outcome }}**.
+            Consulte os logs para mais detalhes se necessário.
 
   security-scan:
     name: Security Scan

diff --git a/.gitignore b/.gitignore
@@ -142,6 +142,8 @@ legacy-analysis-report.*
 *-analysis-report.html
 *-analysis-report.json
 *QUALITY_ANALYSIS.md
+*.sarif
+**/errors.json
 
 # Archived scripts
 .archive/

diff --git a/.oasdiff-ignore.yaml b/.oasdiff-ignore.yaml
@@ -0,0 +1,5 @@
+# Configuração para ignorar breaking changes intencionais.
+# Formato: METHOD PATH ERROR_ID
+
+GET /api/v1/providers/public/{idOrSlug} response-property-type-changed
+GET /api/v1/providers/public/{idOrSlug} response-body-type-changed
diff --git a/Directory.Packages.props b/Directory.Packages.props
@@ -48,6 +48,7 @@
     <!-- Microsoft.OpenApi: Mantido em 2.x devido a incompatibilidade com geradores do .NET 10 -->
     <!-- Analisado em 2026-04-12: Versão 3.5.1 causa erro CS0200 em IOpenApiMediaType.Example -->
     <PackageVersion Include="Microsoft.OpenApi" Version="2.7.3" />
+    <PackageVersion Include="Newtonsoft.Json" Version="13.0.4" />
     <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.1" />
     <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite" Version="10.0.1" />
     <!-- Acesso a Dados -->
@@ -113,7 +114,9 @@
     <PackageVersion Include="RabbitMQ.Client" Version="7.2.1" />
     <PackageVersion Include="Rebus" Version="8.9.2" />
     <PackageVersion Include="Rebus.RabbitMq" Version="10.1.1" />
+    <PackageVersion Include="Rebus.Serialization.Json" Version="8.9.2" />
     <PackageVersion Include="Rebus.ServiceProvider" Version="10.7.2" />
+
     <!-- Autenticação e Autorização -->
     <PackageVersion Include="System.IdentityModel.Tokens.Jwt" Version="8.17.0" />
     <PackageVersion Include="Microsoft.IdentityModel.Protocols" Version="8.16.0" />
@@ -178,4 +181,4 @@
     <!-- Testes Blazor -->
     <PackageVersion Include="bUnit" Version="2.6.2" />
   </ItemGroup>
-</Project>
+</Project>
diff --git a/MeAjudaAi.slnx b/MeAjudaAi.slnx
@@ -20,6 +20,22 @@
     <Project Path="src/Client/MeAjudaAi.Client.Contracts/MeAjudaAi.Client.Contracts.csproj" />
   </Folder>
   <Folder Name="/src/Modules/" />
+  <Folder Name="/src/Modules/Bookings/" />
+  <Folder Name="/src/Modules/Bookings/API/">
+    <Project Path="src/Modules/Bookings/API/MeAjudaAi.Modules.Bookings.API.csproj" />
+  </Folder>
+  <Folder Name="/src/Modules/Bookings/Application/">
+    <Project Path="src/Modules/Bookings/Application/MeAjudaAi.Modules.Bookings.Application.csproj" />
+  </Folder>
+  <Folder Name="/src/Modules/Bookings/Domain/">
+    <Project Path="src/Modules/Bookings/Domain/MeAjudaAi.Modules.Bookings.Domain.csproj" />
+  </Folder>
+  <Folder Name="/src/Modules/Bookings/Infrastructure/">
+    <Project Path="src/Modules/Bookings/Infrastructure/MeAjudaAi.Modules.Bookings.Infrastructure.csproj" />
+  </Folder>
+  <Folder Name="/src/Modules/Bookings/Tests/">
+    <Project Path="src/Modules/Bookings/Tests/MeAjudaAi.Modules.Bookings.Tests.csproj" />
+  </Folder>
   <Folder Name="/src/Modules/Communications/" />
   <Folder Name="/src/Modules/Communications/API/">
     <Project Path="src/Modules/Communications/API/MeAjudaAi.Modules.Communications.API.csproj" />

diff --git a/coverlet.runsettings b/coverlet.runsettings
@@ -6,9 +6,10 @@
         <Configuration>
           <Format>cobertura</Format>
           <Include>[MeAjudaAi*]*</Include>
+          <!-- Exclude only glue/DTO/Endpoints patterns, keep Configuration, Extensions and Monitoring -->
           <Exclude>[*.Tests*]*,[*Test*]*,[testhost]*,[*]*Migrations*,[*]*.DbContextFactory,[*Microsoft.AspNetCore.OpenApi.Generated*]*,[*System.Runtime.CompilerServices*]*,[*System.Text.RegularExpressions.Generated*]*,[*]*.Enums.*</Exclude>
           <ExcludeByFile>**/Migrations/*.cs,**/Migrations/**/*.cs,**/*DbContextFactory.cs</ExcludeByFile>
-          <ExcludeByAttribute>Obsolete,GeneratedCode,CompilerGenerated</ExcludeByAttribute>
+          <ExcludeByAttribute>Obsolete,GeneratedCode,CompilerGenerated,ExcludeFromCodeCoverage</ExcludeByAttribute>
           <!-- Threshold set to 0 to allow full report generation. Final check is done by CodeCoverageSummary -->
           <Threshold>0</Threshold>
           <ThresholdType>line</ThresholdType>
@@ -17,4 +18,4 @@
       </DataCollector>
     </DataCollectors>
   </DataCollectionRunSettings>
-</RunSettings>
+</RunSettings>
diff --git a/docs/api-automation.md b/docs/api-automation.md
@@ -281,6 +281,43 @@ python -m http.server 8000
 - ✅ Validação automática
 - ✅ Deploy sem intervenção
 
+## 🛡️ Gestão de Mudanças e Versionamento
+
+### 1. Detecção de Breaking Changes
+
+O CI do backend utiliza a ferramenta `oasdiff` para comparar a especificação da API da branch atual com a branch de destino (`master` ou `develop`). O passo de CI `Check for Breaking Changes` identifica mudanças que quebram a compatibilidade (ex: remover campo, mudar tipo, alterar rota) e posta avisos e comentários detalhados no Pull Request para revisão humana, sem interromper o pipeline (`continue-on-error: true`).
+
+### 2. Mudanças Intencionais (Fase de Desenvolvimento)
+
+Durante o desenvolvimento ativo, breaking changes podem ser necessárias. Para aprová-las e permitir que o CI passe:
+
+1. Edite o arquivo `.oasdiff-ignore.yaml` na raiz do projeto.
+2. Adicione a linha com o método, rota e o ID do erro que deseja ignorar:
+   ```text
+   METHOD PATH ERROR_ID
+   ```
+   Exemplo: `GET /api/v1/providers/public/{idOrSlug} response-property-type-changed`
+3. Documente no commit o motivo da mudança e inclua o PR rationale.
+
+### 3. Estratégias para Produção (Futuro)
+
+Quando o sistema tiver consumidores externos (Mobile ou Terceiros), as seguintes estratégias devem ser adotadas:
+
+*   **Versionamento por Path**: Criar `/api/v2/...` para mudanças estruturais profundas.
+*   **Expansão e Depreciação (Parallel Change)**:
+    1. Adicionar o novo campo/funcionalidade.
+    2. Marcar o antigo como `[Obsolete]` no C# e `deprecated: true` no OpenAPI.
+    3. Monitorar o uso e remover o antigo apenas após migração total dos clientes.
+*   **Versionamento por Header**: Utilizar headers como `X-API-Version` para selecionar a lógica de resposta.
+
+### 4. Política de Limpeza do arquivo Ignore
+
+O arquivo `.oasdiff-ignore.yaml` deve ser revisado periodicamente para evitar o acúmulo de supressões obsoletas:
+- **Revisão Periódica**: A cada ciclo de release ou a cada 3 meses. As entradas com mais de 3 meses devem ser removidas ou justificadas novamente.
+- **Rastreabilidade**: Cada entrada deve estar vinculada a um ticket ou PR explicando o motivo.
+- **Validação de CI**: O passo de CI `Check for Breaking Changes` validará as entradas ativas no arquivo `.oasdiff-ignore.yaml` para manter a rastreabilidade das exceções concedidas.
+- **Alternativas**: Antes de adicionar uma supressão, verifique se estratégias de retrocompatibilidade (ex: `/api/v2`, `[Obsolete]`, versionamento por header) são mais adequadas.
+
 ## 📝 Troubleshooting
 
 ### Workflow falhou

diff --git a/docs/ci-cd.md b/docs/ci-cd.md
@@ -379,7 +379,7 @@ variables:
 
   # Quality Gates
   - name: CodeCoverageThreshold
-    value: "80"
+    value: "90"
   - name: SonarQualityGate
     value: "OK"
 
@@ -722,7 +722,7 @@ Write-Host "✅ Configuração de CI/CD (apenas setup) concluída!" -ForegroundC
 
 #### Build Quality
 - ✅ Compilação sem erros ou warnings
-- ✅ Cobertura de código > 80%
+- ✅ Cobertura de código ≥ 90%
 - ✅ Testes unitários 100% passing
 - ✅ Análise estática sem issues críticos
 

diff --git a/docs/development.md b/docs/development.md
@@ -703,9 +703,8 @@ public async Task CheckPermission_WithAuthorizedUser_ShouldReturnTrue()
 ### **6. Code Coverage Guidelines**
 
 #### Coverage Thresholds
-- **Minimum**: 70% (warning threshold)
-- **Good**: 85% (recommended threshold)
-- **Excellent**: 90%+
+- **Minimum**: 90% (required threshold for CI/CD)
+- **Excellent**: 95%+
 
 #### Viewing Coverage Reports
 ```bash
@@ -721,7 +720,7 @@ reportgenerator -reports:"./coverage/**/coverage.opencover.xml" -targetdir:"./co
 O pipeline automaticamente:
 - Gera relatórios de coverage para cada PR
 - Comenta automaticamente nos PRs com estatísticas
-- Falha se o coverage cair abaixo de 70%
+- Falha se o coverage cair abaixo de 90%
 
 ### **7. Integration Test Setup**