Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions MeAjudaAi.sln
Original file line number Diff line number Diff line change
Expand Up @@ -127,23 +127,23 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Search", "Search", "{6FF68F
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "API", "API", "{977BE21B-C0F0-4625-9C9D-8A5A6D8C2D49}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.Search.API", "src\Modules\Search\API\MeAjudaAi.Modules.Search.API.csproj", "{68F39D90-3AF5-9037-B03D-B08B48E4A9A8}"
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.SearchProviders.API", "src\Modules\SearchProviders\API\MeAjudaAi.Modules.SearchProviders.API.csproj", "{68F39D90-3AF5-9037-B03D-B08B48E4A9A8}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Application", "Application", "{6F70C0C2-B928-4F73-9D70-038F3E625A95}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.Search.Application", "src\Modules\Search\Application\MeAjudaAi.Modules.Search.Application.csproj", "{0A5B25B9-7991-B208-5D91-476CF0A14A1B}"
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.SearchProviders.Application", "src\Modules\SearchProviders\Application\MeAjudaAi.Modules.SearchProviders.Application.csproj", "{0A5B25B9-7991-B208-5D91-476CF0A14A1B}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Domain", "Domain", "{855F30AA-D1A2-4A1F-BB2B-68DE6D78AFEF}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.Search.Domain", "src\Modules\Search\Domain\MeAjudaAi.Modules.Search.Domain.csproj", "{C5E6E9C4-A027-5880-D304-BE3FC5E9B964}"
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.SearchProviders.Domain", "src\Modules\SearchProviders\Domain\MeAjudaAi.Modules.SearchProviders.Domain.csproj", "{C5E6E9C4-A027-5880-D304-BE3FC5E9B964}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Infrastructure", "Infrastructure", "{9BC7D786-47F5-44BB-88A1-DDEB0022FF23}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.Search.Infrastructure", "src\Modules\Search\Infrastructure\MeAjudaAi.Modules.Search.Infrastructure.csproj", "{0A64D976-2B75-C6F2-9C87-3A780C963FA3}"
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.SearchProviders.Infrastructure", "src\Modules\SearchProviders\Infrastructure\MeAjudaAi.Modules.SearchProviders.Infrastructure.csproj", "{0A64D976-2B75-C6F2-9C87-3A780C963FA3}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Tests", "Tests", "{4726175B-331E-49FA-A49A-EE5AC30B495A}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.Search.Tests", "src\Modules\Search\Tests\MeAjudaAi.Modules.Search.Tests.csproj", "{C7F6B6F4-4F9C-C844-500C-87E3802A6C4B}"
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MeAjudaAi.Modules.SearchProviders.Tests", "src\Modules\SearchProviders\Tests\MeAjudaAi.Modules.SearchProviders.Tests.csproj", "{C7F6B6F4-4F9C-C844-500C-87E3802A6C4B}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Catalogs", "Catalogs", "{8B551008-B254-EBAF-1B6D-AB7C420234EA}"
EndProject
Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ Se você é novo no projeto, comece por aqui:
| **[📅 Módulo Bookings](./modules/bookings.md)** | Sistema de agendamentos (planejado) |
| **[📄 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 Search](./modules/search.md)** | Busca geoespacial de prestadores com PostGIS |
| **[🔍 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 Users](./modules/users.md)** | Gestão de usuários, autenticação e perfis |

Expand Down
34 changes: 18 additions & 16 deletions docs/modules/search.md → docs/modules/search_providers.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# 🔍 Módulo Search - Busca Geoespacial de Prestadores
# 🔍 módulo SearchProviders - Busca Geoespacial de Prestadores

Este documento detalha a implementação completa do módulo Search, responsável pela busca geoespacial de prestadores de serviços na plataforma MeAjudaAi.
Este documento detalha a implementação completa do módulo SearchProviders, responsável pela busca geoespacial de prestadores de serviços na plataforma MeAjudaAi.

## 🎯 Visão Geral

O módulo Search implementa um **read model otimizado** para buscas geoespaciais de prestadores, utilizando **PostGIS** para queries eficientes baseadas em localização. Segue os princípios de **Domain-Driven Design (DDD)** e **Clean Architecture**.
O módulo SearchProviders implementa um **read model otimizado** para buscas geoespaciais de prestadores, utilizando **PostGIS** para queries eficientes baseadas em localização. Segue os princípios de **Domain-Driven Design (DDD)** e **Clean Architecture**.

### **Responsabilidades Principais**
- ✅ **Busca por proximidade** (raio de distância em quilômetros)
Expand All @@ -29,7 +29,7 @@ src/Modules/Search/
│ └── DTOs/ # Data Transfer Objects
├── Domain/ # Camada de domínio
│ ├── Entities/ # SearchableProvider (aggregate)
│ ├── ValueObjects/ # SearchResult, SearchableProviderId
│ ├── ValueObjects/ # SearchProvidersProvidersResult, SearchableProviderId
│ ├── Enums/ # ESubscriptionTier
│ └── Repositories/ # ISearchableProviderRepository
├── Infrastructure/ # Camada de infraestrutura
Expand Down Expand Up @@ -71,7 +71,7 @@ Read model denormalizado com dados necessários para busca:
### **Requisitos de Sistema**

#### **PostgreSQL com PostGIS**
O módulo Search requer PostgreSQL 12+ com a extensão PostGIS para queries geoespaciais.
O módulo SearchProviders requer PostgreSQL 12+ com a extensão PostGIS para queries geoespaciais.

**Instalação do PostGIS:**

Expand All @@ -95,7 +95,7 @@ SELECT PostGIS_Version();

### **Migrações de Banco de Dados**

O módulo usa schema isolado `search` com suporte PostGIS.
O módulo usa schema isolado `SearchProviders` com suporte PostGIS.

**Aplicar migrações:**

Expand All @@ -113,7 +113,7 @@ dotnet ef migrations add <MigrationName> --startup-project ..\..\..\..\Bootstrap
```

**Estrutura criada:**
- Schema: `search`
- Schema: `SearchProviders`
- Tabela: `searchable_providers` (snake_case)
- Extensão: `postgis` (geolocalização)
- Índices: GIST spatial index na coluna `location`
Expand All @@ -139,16 +139,16 @@ export DB_CONNECTION_STRING="Host=prod-server;Database=MeAjudaAi;..."
O módulo é registrado automaticamente no `Program.cs`:

```csharp
// Registra o módulo Search completo (Domain, Application, Infrastructure, API)
// Registra o módulo SearchProviders completo (Domain, Application, Infrastructure, API)
// Internamente registra DbContext, Repositories, Handlers, Validators
builder.Services.AddSearchModule(builder.Configuration);
builder.Services.AddSearchProvidersModule(builder.Configuration);

// Mapeia todos os endpoints do módulo Search
// Mapeia todos os endpoints do módulo SearchProviders
// Substitui a necessidade de chamar métodos individuais de registro
app.UseSearchModule();
app.UseSearchProvidersModule();
```

**Nota:** Os métodos `AddSearchModule()` e `UseSearchModule()` substituem as chamadas individuais anteriores (`AddSearchInfrastructure`, `AddSearchApplication`, `MapSearchEndpoints`), consolidando o registro em dois métodos simples.
**Nota:** Os métodos `AddSearchProvidersModule()` e `UseSearchProvidersModule()` substituem as chamadas individuais anteriores (`AddSearchProvidersInfrastructure`, `AddSearchProvidersApplication`, `MapSearchProvidersEndpoints`), consolidando o registro em dois métodos simples.

---

Expand Down Expand Up @@ -351,11 +351,11 @@ USING GIST (location);
## 🔗 Integração com Outros Módulos

> ⚠️ **IMPORTANTE**: A integração automática com outros módulos ainda não está implementada.
> O módulo Search atualmente opera de forma independente sem sincronização automática.
> O módulo SearchProviders atualmente opera de forma independente sem sincronização automática.
> Os dados são estáticos até que a integração via eventos de domínio seja implementada.

### **Providers Module**
O módulo Search é um **read model** sincronizado com o módulo Providers:
O módulo SearchProviders é um **read model** sincronizado com o módulo Providers:
- Eventos de domínio disparam atualização do SearchableProvider
- Sincronização via domain events ou mensageria (futura implementação)

Expand Down Expand Up @@ -402,7 +402,9 @@ Tests/
### **Executar Testes**

```powershell
# Todos os testes do módulo Search
```powershell
# Todos os testes do módulo SearchProviders
dotnet test src\Modules\Search\Tests\
dotnet test src\Modules\Search\Tests\

# Apenas testes unitários
Expand Down Expand Up @@ -529,7 +531,7 @@ redis-cli ping # Deve retornar PONG

## 🤝 Contribuindo

Para contribuir com o módulo Search:
Para contribuir com o módulo SearchProviders:

1. Leia o [Guia de Desenvolvimento](../development.md)
2. Implemente testes (cobertura mínima: 80%)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
<ProjectReference Include="..\..\Modules\Documents\API\MeAjudaAi.Modules.Documents.API.csproj" />
<ProjectReference Include="..\..\Modules\Locations\Infrastructure\MeAjudaAi.Modules.Locations.Infrastructure.csproj" />
<ProjectReference Include="..\..\Modules\Providers\API\MeAjudaAi.Modules.Providers.API.csproj" />
<ProjectReference Include="..\..\Modules\Search\API\MeAjudaAi.Modules.Search.API.csproj" />
<ProjectReference Include="..\..\Modules\SearchProviders\API\MeAjudaAi.Modules.SearchProviders.API.csproj" />
<ProjectReference Include="..\..\Modules\Users\API\MeAjudaAi.Modules.Users.API.csproj" />
<ProjectReference Include="..\..\Shared\MeAjudaAi.Shared.csproj" />
</ItemGroup>
Expand Down
6 changes: 3 additions & 3 deletions src/Bootstrapper/MeAjudaAi.ApiService/Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
using MeAjudaAi.Modules.Documents.API;
using MeAjudaAi.Modules.Locations.Infrastructure;
using MeAjudaAi.Modules.Providers.API;
using MeAjudaAi.Modules.Search.API;
using MeAjudaAi.Modules.SearchProviders.API;
using MeAjudaAi.Modules.Users.API;
using MeAjudaAi.ServiceDefaults;
using MeAjudaAi.Shared.Extensions;
Expand Down Expand Up @@ -32,7 +32,7 @@ public static async Task Main(string[] args)
builder.Services.AddUsersModule(builder.Configuration);
builder.Services.AddProvidersModule(builder.Configuration);
builder.Services.AddDocumentsModule(builder.Configuration);
builder.Services.AddSearchModule(builder.Configuration);
builder.Services.AddSearchProvidersModule(builder.Configuration);
builder.Services.AddLocationModule(builder.Configuration);
builder.Services.AddCatalogsModule(builder.Configuration);

Expand Down Expand Up @@ -106,7 +106,7 @@ private static async Task ConfigureMiddlewareAsync(WebApplication app)
app.UseUsersModule();
app.UseProvidersModule();
app.UseDocumentsModule();
app.UseSearchModule();
app.UseSearchProvidersModule();
app.UseLocationModule();
app.UseCatalogsModule();
}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
using MeAjudaAi.Modules.Search.Application.DTOs;
using MeAjudaAi.Modules.Search.Application.Queries;
using MeAjudaAi.Modules.Search.Domain.Enums;
using MeAjudaAi.Modules.SearchProviders.Application.DTOs;
using MeAjudaAi.Modules.SearchProviders.Application.Queries;
using MeAjudaAi.Modules.SearchProviders.Domain.Enums;
using MeAjudaAi.Shared.Contracts;
using MeAjudaAi.Shared.Endpoints;
using MeAjudaAi.Shared.Functional;
Expand All @@ -10,7 +10,7 @@
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Routing;

namespace MeAjudaAi.Modules.Search.API.Endpoints;
namespace MeAjudaAi.Modules.SearchProviders.API.Endpoints;

/// <summary>
/// Endpoint para buscar provedores de serviço por localização e critérios.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,46 +1,46 @@
using MeAjudaAi.Modules.Search.API.Endpoints;
using MeAjudaAi.Modules.Search.Application;
using MeAjudaAi.Modules.Search.Infrastructure;
using MeAjudaAi.Modules.SearchProviders.API.Endpoints;
using MeAjudaAi.Modules.SearchProviders.Application;
using MeAjudaAi.Modules.SearchProviders.Infrastructure;
using Microsoft.AspNetCore.Routing;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

namespace MeAjudaAi.Modules.Search.API;
namespace MeAjudaAi.Modules.SearchProviders.API;

/// <summary>
/// Extensões em nível de módulo para registrar o módulo completo de Search & Discovery.
/// Extensões em nível de módulo para registrar o módulo completo de SearchProviders.
/// </summary>
public static class ModuleExtensions
{
/// <summary>
/// Registra todos os serviços do módulo Search (Domain, Application, Infrastructure, API).
/// Registra todos os serviços do módulo SearchProviders (Domain, Application, Infrastructure, API).
/// </summary>
/// <param name="services">A coleção de serviços.</param>
/// <param name="configuration">A configuração para ler strings de conexão e configurações.</param>
/// <returns>A coleção de serviços para encadeamento.</returns>
public static IServiceCollection AddSearchModule(
public static IServiceCollection AddSearchProvidersModule(
this IServiceCollection services,
IConfiguration configuration)
{
// Domain layer não tem dependências externas para registrar

// Application layer
services.AddSearchApplication();
services.AddSearchProvidersApplication();

// Infrastructure layer (requer configuration para conexão do BD)
services.AddSearchInfrastructure(configuration);
services.AddSearchProvidersInfrastructure(configuration);

// API layer - sem serviços adicionais para registrar

return services;
}

/// <summary>
/// Mapeia todos os endpoints do módulo Search.
/// Mapeia todos os endpoints do módulo SearchProviders.
/// </summary>
/// <param name="app">O construtor de rotas de endpoint.</param>
/// <returns>O construtor de rotas de endpoint para encadeamento.</returns>
public static IEndpointRouteBuilder UseSearchModule(this IEndpointRouteBuilder app)
public static IEndpointRouteBuilder UseSearchProvidersModule(this IEndpointRouteBuilder app)
{
SearchProvidersEndpoint.Map(app);
return app;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
<RootNamespace>MeAjudaAi.Modules.Search.API</RootNamespace>
<RootNamespace>MeAjudaAi.Modules.SearchProviders.API</RootNamespace>
<OutputType>Library</OutputType>
</PropertyGroup>

Expand All @@ -14,8 +14,8 @@

<ItemGroup>
<ProjectReference Include="..\..\..\Shared\MeAjudaAi.Shared.csproj" />
<ProjectReference Include="..\Application\MeAjudaAi.Modules.Search.Application.csproj" />
<ProjectReference Include="..\Infrastructure\MeAjudaAi.Modules.Search.Infrastructure.csproj" />
<ProjectReference Include="..\Application\MeAjudaAi.Modules.SearchProviders.Application.csproj" />
<ProjectReference Include="..\Infrastructure\MeAjudaAi.Modules.SearchProviders.Infrastructure.csproj" />
</ItemGroup>

</Project>
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
using System.ComponentModel.DataAnnotations;

namespace MeAjudaAi.Modules.Search.Application.DTOs;
namespace MeAjudaAi.Modules.SearchProviders.Application.DTOs;

/// <summary>
/// DTO representing geographic coordinates.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
namespace MeAjudaAi.Modules.Search.Application.DTOs;
namespace MeAjudaAi.Modules.SearchProviders.Application.DTOs;

/// <summary>
/// DTO representando resultados de busca paginados.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
using MeAjudaAi.Modules.Search.Domain.Enums;
using MeAjudaAi.Modules.SearchProviders.Domain.Enums;

namespace MeAjudaAi.Modules.Search.Application.DTOs;
namespace MeAjudaAi.Modules.SearchProviders.Application.DTOs;

/// <summary>
/// DTO representando um provedor pesquisável nos resultados de busca.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
using FluentValidation;
using MeAjudaAi.Modules.Search.Application.DTOs;
using MeAjudaAi.Modules.Search.Application.ModuleApi;
using MeAjudaAi.Modules.Search.Application.Queries;
using MeAjudaAi.Modules.SearchProviders.Application.DTOs;
using MeAjudaAi.Modules.SearchProviders.Application.ModuleApi;
using MeAjudaAi.Modules.SearchProviders.Application.Queries;
using MeAjudaAi.Shared.Contracts;
using MeAjudaAi.Shared.Contracts.Modules.Search;
using MeAjudaAi.Shared.Functional;
using MeAjudaAi.Shared.Queries;
using Microsoft.Extensions.DependencyInjection;

namespace MeAjudaAi.Modules.Search.Application;
namespace MeAjudaAi.Modules.SearchProviders.Application;

/// <summary>
/// Métodos de extensão para registrar serviços da camada de Application do Search.
/// Métodos de extensão para registrar serviços da camada de Application do SearchProviders.
/// </summary>
public static class Extensions
{
/// <summary>
/// Registra serviços da camada de Application do Search.
/// Registra serviços da camada de Application do SearchProviders.
/// </summary>
public static IServiceCollection AddSearchApplication(this IServiceCollection services)
public static IServiceCollection AddSearchProvidersApplication(this IServiceCollection services)
{
// Registrar query handlers
services.AddScoped<IQueryHandler<SearchProvidersQuery, Result<PagedResult<SearchableProviderDto>>>, Handlers.SearchProvidersQueryHandler>();
Expand Down
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
using MeAjudaAi.Modules.Search.Application.DTOs;
using MeAjudaAi.Modules.Search.Application.Queries;
using MeAjudaAi.Modules.Search.Domain.Repositories;
using MeAjudaAi.Modules.Search.Domain.ValueObjects;
using MeAjudaAi.Modules.SearchProviders.Application.DTOs;
using MeAjudaAi.Modules.SearchProviders.Application.Queries;
using MeAjudaAi.Modules.SearchProviders.Domain.Repositories;
using MeAjudaAi.Modules.SearchProviders.Domain.ValueObjects;
using MeAjudaAi.Shared.Contracts;
using MeAjudaAi.Shared.Functional;
using MeAjudaAi.Shared.Geolocation;
using MeAjudaAi.Shared.Queries;
using Microsoft.Extensions.Logging;

namespace MeAjudaAi.Modules.Search.Application.Handlers;
namespace MeAjudaAi.Modules.SearchProviders.Application.Handlers;

/// <summary>
/// Handler for searching providers based on location and criteria.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,12 @@

<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
<RootNamespace>MeAjudaAi.Modules.Search.Application</RootNamespace>
<RootNamespace>MeAjudaAi.Modules.SearchProviders.Application</RootNamespace>
</PropertyGroup>

<ItemGroup>
<ProjectReference Include="..\..\..\Shared\MeAjudaAi.Shared.csproj" />
<ProjectReference Include="..\Domain\MeAjudaAi.Modules.Search.Domain.csproj" />
<ProjectReference Include="..\Domain\MeAjudaAi.Modules.SearchProviders.Domain.csproj" />
</ItemGroup>

</Project>
Loading