frigini · frigini · Dec 2, 2025 · Nov 27, 2025 · Nov 27, 2025 · Nov 27, 2025
diff --git a/.github/workflows/aspire-ci-cd.yml b/.github/workflows/aspire-ci-cd.yml
@@ -26,7 +26,7 @@ jobs:
     runs-on: ubuntu-latest
     services:
       postgres:
-        image: postgres:15
+        image: postgis/postgis:16-3.4
         env:
           POSTGRES_PASSWORD: ${{ secrets.POSTGRES_PASSWORD || 'test123' }}
           POSTGRES_USER: ${{ secrets.POSTGRES_USER || 'postgres' }}

diff --git a/.github/workflows/ci-cd.yml b/.github/workflows/ci-cd.yml
@@ -94,10 +94,21 @@ jobs:
           dotnet test tests/MeAjudaAi.Integration.Tests/MeAjudaAi.Integration.Tests.csproj \
             --configuration Release --no-build --verbosity normal \
             --collect:"XPlat Code Coverage" --results-directory TestResults/Integration
-          # Executar testes de módulos (Users, etc)
+          # Executar testes de módulos
+          echo "🧪 Executando testes de módulos..."
           dotnet test src/Modules/Users/Tests/MeAjudaAi.Modules.Users.Tests.csproj \
             --configuration Release --no-build --verbosity normal \
             --collect:"XPlat Code Coverage" --results-directory TestResults/Users
+          dotnet test src/Modules/Documents/Tests/MeAjudaAi.Modules.Documents.Tests.csproj \
+            --configuration Release --no-build --verbosity normal \
+            --collect:"XPlat Code Coverage" --results-directory TestResults/Documents
+          dotnet test src/Modules/Providers/Tests/MeAjudaAi.Modules.Providers.Tests.csproj \
+            --configuration Release --no-build --verbosity normal \
+            --collect:"XPlat Code Coverage" --results-directory TestResults/Providers
+          dotnet test src/Modules/ServiceCatalogs/Tests/MeAjudaAi.Modules.ServiceCatalogs.Tests.csproj \
+            --configuration Release --no-build --verbosity normal \
+            --collect:"XPlat Code Coverage" --results-directory TestResults/ServiceCatalogs
+
           # Executar testes E2E
           echo "🔍 Executando testes E2E..."
           dotnet test tests/MeAjudaAi.E2E.Tests/MeAjudaAi.E2E.Tests.csproj \
@@ -116,7 +127,7 @@ jobs:
             -targetdir:"TestResults/Coverage" \
             -reporttypes:"Html;Cobertura;JsonSummary" \
             -assemblyfilters:"-*.Tests*" \
-            -classfilters:"-*.Migrations*"
+            -classfilters:"-*.Migrations*;-*OpenApi.Generated*;-*.Metrics.*;-*.HealthChecks.*;-*.Jobs.Hangfire*;-*.Jobs.Configuration*;-*Program*;-*AppHost*;-*.ServiceDefaults*"
 
       - name: Upload code coverage
         uses: actions/upload-artifact@v4

diff --git a/Directory.Packages.props b/Directory.Packages.props
@@ -23,6 +23,7 @@
     <PackageVersion Include="Microsoft.AspNetCore.Http.Abstractions" Version="2.3.0" />
     <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.0" />
     <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.0" />
+    <PackageVersion Include="Microsoft.AspNetCore.TestHost" Version="10.0.0" />
     <PackageVersion Include="Microsoft.Extensions.ApiDescription.Server" Version="10.0.0" />
     <!-- API Versioning -->
     <PackageVersion Include="Asp.Versioning.Http" Version="8.1.0" />
@@ -176,10 +177,12 @@
     <!-- Testing Libraries -->
     <PackageVersion Include="FluentAssertions" Version="8.6.0" />
     <PackageVersion Include="Moq" Version="4.20.72" />
+    <PackageVersion Include="NSubstitute" Version="5.3.0" />
     <PackageVersion Include="Bogus" Version="35.6.4" />
     <PackageVersion Include="AutoFixture" Version="4.18.1" />
     <PackageVersion Include="AutoFixture.AutoMoq" Version="4.18.1" />
     <!-- Test Containers -->
+    <PackageVersion Include="Testcontainers.Azurite" Version="4.7.0" />
     <PackageVersion Include="Testcontainers.PostgreSql" Version="4.7.0" />
     <PackageVersion Include="Testcontainers.Redis" Version="4.7.0" />
     <PackageVersion Include="Respawn" Version="6.2.1" />

diff --git a/README.md b/README.md
@@ -28,7 +28,7 @@ O **MeAjudaAi** é uma plataforma moderna de marketplace de serviços que implem
 - **Docker** - Containerização
 - **Azure** - Hospedagem em nuvem
 
-## � Estrutura do Projeto
+## 📦 Estrutura do Projeto
 
 O projeto foi organizado para facilitar navegação e manutenção:
 
@@ -63,11 +63,13 @@ O projeto foi organizado para facilitar navegação e manutenção:
 | `config/` | Configurações de ferramentas | Linting, segurança, cobertura |
 | `automation/` | Setup de CI/CD | Scripts de configuração |
 
-## �🚀 Início Rápido
+## 🚀 Início Rápido
 
 ### Para Desenvolvedores
 
-**Setup completo (recomendado):**
+Para instruções detalhadas, consulte o [**Guia de Desenvolvimento Completo**](./docs/development.md).
+
+**Setup completo (recomendado):****
 ```bash
 ./run-local.sh setup
 ```
@@ -173,21 +175,20 @@ MeAjudaAi/
 │   │   └── MeAjudaAi.ServiceDefaults/ # Configurações compartilhadas
 │   ├── Bootstrapper/               # API service bootstrapper
 │   │   └── MeAjudaAi.ApiService/   # Ponto de entrada da API
-│   ├── Modules/                    # Módulos de domínio
-│   │   ├── Users/                  # Módulo de usuários
-│   │   │   ├── API/                # Endpoints e controllers
-│   │   │   ├── Application/        # Use cases e handlers CQRS
-│   │   │   ├── Domain/             # Entidades, value objects, eventos
-│   │   │   ├── Infrastructure/     # Persistência e serviços externos
-│   │   │   └── Tests/              # Testes do módulo
-│   │   └── Providers/              # Módulo de prestadores
-│   │       ├── API/                # Endpoints e controllers
-│   │       ├── Application/        # Use cases e handlers CQRS
-│   │       ├── Domain/             # Entidades, value objects, eventos
-│   │       ├── Infrastructure/     # Persistência e event handlers
-│   │       └── Tests/              # Testes unitários e integração
+│   ├── Modules/                    # Módulos de domínio (Clean Architecture + DDD)
+│   │   ├── Users/                  # Gestão de usuários e autenticação
+│   │   │   ├── API/                # Endpoints (Minimal APIs)
+│   │   │   ├── Application/        # Use cases, CQRS handlers, DTOs
+│   │   │   ├── Domain/             # Entidades, agregados, eventos de domínio
+│   │   │   ├── Infrastructure/     # EF Core, repositórios, event handlers
+│   │   │   └── Tests/              # Testes unitários e de integração
+│   │   ├── Providers/              # Prestadores de serviços e verificação
+│   │   ├── Documents/              # Processamento de documentos com AI
+│   │   ├── ServiceCatalogs/        # Catálogo de serviços e categorias
+│   │   ├── SearchProviders/        # Busca geoespacial de prestadores (PostGIS)
+│   │   └── Locations/              # Integração com API IBGE (CEP, cidades)
 │   └── Shared/                     # Componentes compartilhados
-│       └── MeAjudaAi.Shared/       # Abstrações e utilities
+│       └── MeAjudaAi.Shared/       # Abstrações, contratos, utilidades
 ├── tests/                          # Testes de integração
 ├── infrastructure/                 # Infraestrutura e deployment
 │   ├── compose/                    # Docker Compose
@@ -198,23 +199,47 @@ MeAjudaAi/
 
 ## 🧩 Módulos do Sistema
 
-### 📱 Módulo Users
-- **Domain**: Gestão de usuários, perfis e autenticação
-- **Features**: Registro, login, perfis, papéis (cliente, prestador, admin)
-- **Integração**: Keycloak para autenticação OAuth2/OIDC
+### 👥 Users
+- **Domínio**: Gestão de usuários, perfis e autenticação
+- **Features**: Registro, autenticação, perfis, RBAC (cliente, prestador, admin)
+- **Tecnologias**: Keycloak OAuth2/OIDC, PostgreSQL, Event-Driven
+- **Comunicação**: Module API pattern para validação cross-module
 
-### 🏢 Módulo Providers
-- **Domain**: Gestão de prestadores de serviços e verificação
+### 🏢 Providers
+- **Domínio**: Prestadores de serviços e processo de verificação
 - **Features**: Cadastro, perfis empresariais, documentos, qualificações, status de verificação
-- **Eventos**: Sistema completo de eventos de domínio e integração para comunicação inter-modular
-- **Arquitetura**: Clean Architecture com CQRS, DDD e event-driven design
-
-### 🔮 Módulos Futuros
-- **Services**: Catálogo de serviços e categorias
+- **Eventos**: Domain Events + Integration Events para auditoria e comunicação
+- **Arquitetura**: Clean Architecture, CQRS, DDD, Event Sourcing
+
+### 📄 Documents
+- **Domínio**: Processamento e validação de documentos
+- **Features**: Upload, OCR com Azure Document Intelligence, validação, armazenamento (Azure Blob)
+- **AI/ML**: Extração automática de dados de documentos (CNH, RG, CPF)
+- **Integração**: Azure Storage, eventos para notificação de processamento
+
+### 📋 ServiceCatalogs
+- **Domínio**: Catálogo de serviços e categorias
+- **Features**: CRUD de serviços/categorias, ativação/desativação, hierarquia de categorias
+- **Testes**: 141 testes (100% passing), cobertura 26% Domain, 50% Infrastructure
+- **Otimização**: Testes paralelos desabilitados para evitar conflitos de chave única
+
+### 🔍 SearchProviders
+- **Domínio**: Busca geoespacial de prestadores
+- **Features**: Busca por coordenadas/raio, filtros (serviços, rating), paginação
+- **Tecnologias**: PostGIS para queries espaciais, PostgreSQL 16 com extensão PostGIS 3.4
+- **Performance**: Índices GiST para consultas geoespaciais otimizadas
+
+### 📍 Locations
+- **Domínio**: Integração com dados geográficos brasileiros
+- **Features**: Consulta de CEP, cidades, estados via API IBGE
+- **Validação**: Middleware de restrição geográfica (ex: disponível apenas RJ)
+- **Caching**: Redis para otimizar consultas frequentes
+
+### 🔮 Roadmap - Próximos Módulos
 - **Bookings**: Agendamentos e reservas
-- **Payments**: Processamento de pagamentos
-- **Reviews**: Avaliações e feedback
-- **Notifications**: Sistema de notificações
+- **Payments**: Processamento de pagamentos (Stripe/PagSeguro)
+- **Reviews**: Avaliações, feedback e rating de prestadores
+- **Notifications**: Sistema de notificações multi-canal (email, SMS, push)
 
 ## ⚡ Melhorias Recentes
 

diff --git a/config/coverage.runsettings b/config/coverage.runsettings
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<RunSettings>
+  <DataCollectionRunSettings>
+    <DataCollectors>
+      <DataCollector friendlyName="XPlat code coverage">
+        <Configuration>
+          <Format>cobertura,json,opencover</Format>
+          <Exclude>[*.Tests]*,[*.Testing]*,[testhost]*,[MeAjudaAi.AppHost]*,[MeAjudaAi.ServiceDefaults]*</Exclude>
+          <ExcludeByAttribute>Obsolete,GeneratedCodeAttribute,CompilerGeneratedAttribute,ExcludeFromCodeCoverageAttribute</ExcludeByAttribute>
+          <ExcludeByFile>**/Migrations/**/*.cs,**/bin/**,**/obj/**,**/Logging/**/*.cs,**/Jobs/Hangfire*.cs,**/Messaging/RabbitMq/**/*.cs,**/Messaging/ServiceBus/**/*.cs,**/Monitoring/**/*.cs,**/HealthChecks/**/*.cs</ExcludeByFile>
+          <IncludeDirectory>./src/</IncludeDirectory>
+          <SingleHit>false</SingleHit>
+          <UseSourceLink>true</UseSourceLink>
+          <IncludeTestAssembly>false</IncludeTestAssembly>
+          <SkipAutoProps>true</SkipAutoProps>
+          <DeterministicReport>false</DeterministicReport>
+          <DoesNotReturnAttribute>DoesNotReturnAttribute</DoesNotReturnAttribute>
+        </Configuration>
+      </DataCollector>
+    </DataCollectors>
+  </DataCollectionRunSettings>
+  <RunConfiguration>
+    <MaxCpuCount>0</MaxCpuCount>
+    <ResultsDirectory>.\TestResults\Coverage</ResultsDirectory>
+    <TargetFramework>net10.0</TargetFramework>
+  </RunConfiguration>
+</RunSettings>
diff --git a/config/coverlet.json b/config/coverlet.json
@@ -5,24 +5,61 @@
       "name": "default",
       "reportTypes": ["Html", "Cobertura", "JsonSummary", "TextSummary"],
       "targetdir": "TestResults/Coverage",
-      "reporttitle": "MeAjudaAi - Code Coverage Report",
+      "reporttitle": "MeAjudaAi - Code Coverage Report (Business Modules Focus)",
       "assemblyfilters": [
         "-*.Tests*",
         "-*.Testing*",
-        "-testhost*"
+        "-testhost*",
+        "-MeAjudaAi.AppHost",
+        "-MeAjudaAi.ServiceDefaults"
       ],
       "classfilters": [
         "-*.Migrations*",
+        "-*MigrationBuilder*",
+        "-*DbContextModelSnapshot*",
         "-Program",
-        "-Startup"
+        "-Startup",
+        "-*KeycloakConfiguration*",
+        "-*KeycloakPermissionResolver*",
+        "-*KeycloakRole*",
+        "-*KeycloakUser*",
+        "-*RabbitMq*",
+        "-*ServiceBus*",
+        "-*Hangfire*",
+        "-*Serilog*",
+        "-*HealthCheck*",
+        "-*Metrics*",
+        "-*Monitoring*",
+        "-*OpenApi.Generated*",
+        "-System.Runtime.CompilerServices*",
+        "-System.Text.RegularExpressions.Generated*"
       ],
       "filefilters": [
         "-**/Migrations/**",
         "-**/bin/**",
-        "-**/obj/**"
+        "-**/obj/**",
+        "-**/Logging/**",
+        "-**/Jobs/Hangfire*",
+        "-**/Messaging/RabbitMq/**",
+        "-**/Messaging/ServiceBus/**",
+        "-**/Monitoring/**",
+        "-**/HealthChecks/**"
+      ],
+      "sourcefiles": [
+        "-**/*OpenApi.Generated*.cs",
+        "-**/System.Runtime.CompilerServices*.cs",
+        "-**/System.Text.RegularExpressions.Generated*.cs",
+        "-**/<RegexGenerator_g>*.cs"
+      ],
+      "attributefilters": [
+        "GeneratedCodeAttribute",
+        "CompilerGeneratedAttribute",
+        "ExcludeFromCodeCoverageAttribute"
       ],
       "verbosity": "Info",
-      "tag": "main"
+      "tag": "business-focus",
+      "thresholdType": "line,branch,method",
+      "threshold": "80,70,75"
     }
   ]
 }
diff --git a/docs/README.md b/docs/README.md
@@ -21,7 +21,7 @@ Se você é novo no projeto, comece por aqui:
 | **[🛠️ Guia de Desenvolvimento](./development.md)** | Setup completo, convenções, workflows, debugging e testes |
 | **[🚀 Infraestrutura](./infrastructure.md)** | Docker, Aspire, Azure e configuração de ambientes |
 | **[🗺️ Roadmap do Projeto](./roadmap.md)** | Funcionalidades futuras e planejamento |
-| **[🔩 Débito Técnico](./technical_debt.md)** | Itens de débito técnico e melhorias planejadas |
+| **[🔩 Débito Técnico](./technical-debt.md)** | Itens de débito técnico e melhorias planejadas |
 
 ## 📁 Documentação Especializada
 
@@ -37,9 +37,9 @@ Se você é novo no projeto, comece por aqui:
 
 | Documento | Descrição |
 |-----------|-----------|
-| **[🆔 Correlation ID](./logging/CORRELATION_ID.md)** | Melhores práticas para implementação e uso de Correlation IDs |
-| **[⏱️ Desempenho](./logging/PERFORMANCE.md)** | Estratégias e ferramentas de monitoramento de desempenho |
-| **[📊 Seq Setup](./logging/SEQ_SETUP.md)** | Configuração do Seq para logging estruturado |
+| **[🆔 Correlation ID](./logging/correlation-id.md)** | Melhores práticas para implementação e uso de Correlation IDs |
+| **[⏱️ Desempenho](./logging/performance.md)** | Estratégias e ferramentas de monitoramento de desempenho |
+| **[📊 Seq Setup](./logging/seq-setup.md)** | Configuração do Seq para logging estruturado |
 
 ### **💬 Messaging**
 
@@ -53,11 +53,11 @@ Se você é novo no projeto, comece por aqui:
 
 | Documento | Descrição |
 |-----------|-----------|
-| **[📅 Módulo Bookings](./modules/bookings.md)** | Sistema de agendamentos (planejado) |
+| **📅 Módulo Bookings** | Sistema de agendamentos (planejado - documentação pendente) |
 | **[📄 Módulo Documents](./modules/documents.md)** | Gerenciamento de documentos |
 | **[🔧 Módulo Providers](./modules/providers.md)** | Prestadores de serviços, verificação e documentos |
-| **[🔍 Módulo SearchProviders](./modules/search_providers.md)** | Busca geoespacial de prestadores com PostGIS |
-| **[📋 Módulo Services](./modules/services.md)** | Catálogo de serviços (planejado) |
+| **[🔍 Módulo SearchProviders](./modules/search-providers.md)** | Busca geoespacial de prestadores com PostGIS |
+| **📋 Módulo Service Catalogs** | Catálogo de serviços - ver [service-catalogs.md](./modules/service-catalogs.md) |
 | **[👥 Módulo Users](./modules/users.md)** | Gestão de usuários, autenticação e perfis |
 
 ### **🧪 Testes**
@@ -66,14 +66,10 @@ Se você é novo no projeto, comece por aqui:
 |-----------|-----------|
 | **[📊 Guia de Cobertura de Código](./testing/code_coverage_guide.md)** | Como visualizar e interpretar a cobertura de código |
 | **[⚙️ Testes de Integração](./testing/integration_tests.md)** | Guia para escrever e manter testes de integração |
-| **[🔒 Exemplos de Testes de Autenticação](./testing/test_auth_examples.md)** | Exemplos práticos do TestAuthenticationHandler |
-
-### **📚 Guias e Relatórios**
-
-| Documento | Descrição |
-|-----------|-----------|
-| **[📝 Guia de Implementação do EditorConfig](./guides/editorconfig_implementation_guide.md)** | Guia de implementação do EditorConfig |
-| **[🔒 Relatório de Melhorias de Segurança](./reports/security_improvements_report.md)** | Relatório de melhorias de segurança |
+| **[🏗️ Infraestrutura de Testes](./testing/test-infrastructure.md)** | Setup e configuração da infraestrutura de testes |
+| **[🔒 Exemplos de Testes de Autenticação](./testing/test-auth-examples.md)** | Exemplos práticos do TestAuthenticationHandler |
+| **[🔍 Análise de Testes Skipped](./testing/skipped-tests-analysis.md)** | Análise e plano de correção de testes skipped |
+| **[🎯 Arquitetura E2E](./testing/e2e-architecture-analysis.md)** | Análise da arquitetura de testes end-to-end |
 
 ## 🤝 Como Contribuir
 

diff --git a/docs/skipped-tests-tracker.md → ...archive/sprint-1/skipped-tests-tracker.md b/docs/skipped-tests-tracker.md → ...archive/sprint-1/skipped-tests-tracker.md
@@ -4,6 +4,8 @@
 **Status**: 12 testes skipped em 4 categorias  
 **Meta**: Resolver todos até Sprint 2
 
+> **Nota**: Este documento de arquivo contém referências a arquivos da Sprint 1 que foram reorganizados ou removidos. Para informações atualizadas sobre testes, consulte [Guia de Testes](../../testing/).
+
 ---
 
 ## 📊 Resumo Executivo
@@ -330,10 +332,9 @@ Um teste skipped pode ser considerado **resolvido** quando:
 
 ## 📚 Referências
 
-- [E2E Test Failures Analysis](./e2e-test-failures-analysis.md)
-- [Sprint 1 Checklist](./sprint-1-checklist.md)
-- [Architecture Decision Records](./architecture.md)
-- [Testing Strategy](./testing/README.md)
+> **Note**: Este é um documento arquivado do Sprint 1. As referências originais foram reorganizadas ou removidas. Para documentação atualizada, consulte:
+> - [Architecture Decision Records](../../architecture.md)
+> - [Testing Strategy](../../testing/test-infrastructure.md)
 
 ---
 

diff --git a/docs/authentication_and_authorization.md → docs/authentication-and-authorization.md b/docs/authentication_and_authorization.md → docs/authentication-and-authorization.md
diff --git a/docs/ci_cd.md → docs/ci-cd.md b/docs/ci_cd.md → docs/ci-cd.md
diff --git a/docs/database/database_boundaries.md → docs/database/database-boundaries.md b/docs/database/database_boundaries.md → docs/database/database-boundaries.md
diff --git a/docs/database/db_context_factory.md → docs/database/db-context-factory.md b/docs/database/db_context_factory.md → docs/database/db-context-factory.md
diff --git a/docs/database/scripts_organization.md → docs/database/scripts-organization.md b/docs/database/scripts_organization.md → docs/database/scripts-organization.md