Fix/aspire initialization

.github/workflows/master-ci-cd.yml

@@ -191,6 +191,31 @@ jobs:
           echo "✅ Frontend component tests completed successfully"
           echo "===================================="
 
+      - name: Free Disk Space for Integration Tests
+        run: |
+          echo "🧹 Freeing disk space before integration tests..."
+
+          # Show disk usage before cleanup
+          echo "📊 Disk usage before cleanup:"
+          df -h
+
+          # Remove Docker images and containers that are not needed
+          echo "🗑️  Removing unused Docker resources..."
+          docker system prune -af --volumes || true
+
+          # Remove large packages/tools not needed for tests
+          echo "🗑️  Removing unnecessary packages..."
+          sudo apt-get clean
+          sudo rm -rf /usr/local/lib/android || true
+          sudo rm -rf /opt/ghc || true
+          sudo rm -rf /usr/local/.ghcup || true
+
+          # Show disk usage after cleanup
+          echo "📊 Disk usage after cleanup:"
+          df -h
+
+          echo "✅ Disk space cleanup completed"
+
       - name: Run integration tests
         env:
           ASPNETCORE_ENVIRONMENT: Testing

.github/workflows/pr-validation.yml

@@ -259,8 +259,8 @@
           # ⚠️ TEST CREDENTIALS ONLY - These are the standard Azurite local emulator credentials
           # These are intentionally public and documented at:
           # https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azurite#well-known-storage-account-and-key
           AZURE_STORAGE_CONNECTION_STRING: "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://localhost:10000/devstoreaccount1;"
           AzureStorage__ConnectionString: "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://localhost:10000/devstoreaccount1;"
           # Map connection strings to .NET configuration using double underscore
           ConnectionStrings__DefaultConnection: ${{ steps.db.outputs.connection-string }}
           ConnectionStrings__Users: ${{ steps.db.outputs.connection-string }}
@@ -467,7 +467,7 @@
           find ./coverage -type f \( -name "*.opencover.xml" -o -name "*.cobertura.xml" \) | wc -l
           echo ""
           echo "Coverage files by module:"
           find ./coverage -type f \( -name "*.opencover.xml" -o -name "*.cobertura.xml" \) -printf "%f\n" | sort | head -20
           echo ""
 
           echo "🔍 DEBUG: Verifying coverage files for CodeCoverageSummary..."
@@ -601,6 +601,31 @@
           echo "✅ Frontend component tests completed successfully"
           echo "===================================="
 
+      - name: Free Disk Space for Integration Tests
+        run: |
+          echo "🧹 Freeing disk space before integration tests..."
+
+          # Show disk usage before cleanup
+          echo "📊 Disk usage before cleanup:"
+          df -h
+
+          # Remove Docker images and containers that are not needed
+          echo "🗑️  Removing unused Docker resources..."
+          docker system prune -af --volumes || true
+
+          # Remove large packages/tools not needed for tests
+          echo "🗑️  Removing unnecessary packages..."
+          sudo apt-get clean
+          sudo rm -rf /usr/local/lib/android || true
+          sudo rm -rf /opt/ghc || true
+          sudo rm -rf /usr/local/.ghcup || true
+
+          # Show disk usage after cleanup
+          echo "📊 Disk usage after cleanup:"
+          df -h
+
+          echo "✅ Disk space cleanup completed"
+
       - name: Run Integration Tests
         env:
           ASPNETCORE_ENVIRONMENT: Testing

Directory.Packages.props

@@ -12,6 +12,7 @@
     <!-- Microsoft.Extensions.* family version alignment -->
     <!-- Keep all Microsoft.Extensions.* packages on the same major version (10.x) -->
     <!-- This prevents Refit.HttpClientFactory from pulling in 9.x versions -->
+    <PackageVersion Include="HtmlSanitizer" Version="8.1.870" />
     <PackageVersion Include="Microsoft.Extensions.Http" Version="10.0.1" />
     <!-- .NET & Microsoft Core -->
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="18.0.1" />
@@ -142,6 +143,9 @@
     <PackageVersion Include="Microsoft.Extensions.TimeProvider.Testing" Version="10.0.1" />
     <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.1" />
     <PackageVersion Include="Microsoft.Extensions.Http.Resilience" Version="10.1.0" />
+    <PackageVersion Include="Microsoft.Extensions.Http.Polly" Version="10.0.1" />
+    <PackageVersion Include="Polly" Version="8.6.0" />
+    <PackageVersion Include="Polly.Extensions.Http" Version="3.0.0" />
     <PackageVersion Include="Microsoft.Extensions.Logging" Version="10.0.1" />
     <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.1" />
     <PackageVersion Include="Microsoft.Extensions.Logging.Configuration" Version="10.0.1" />
@@ -173,6 +177,7 @@
     <!-- Validation -->
     <PackageVersion Include="FluentValidation" Version="12.1.1" />
     <PackageVersion Include="FluentValidation.DependencyInjectionExtensions" Version="12.1.1" />
+    <PackageVersion Include="FluentValidation.AspNetCore" Version="12.1.1" />
     <!-- Azure -->
     <PackageVersion Include="Azure.AI.DocumentIntelligence" Version="1.0.0" />
     <PackageVersion Include="Azure.Storage.Blobs" Version="12.26.0" />
@@ -232,11 +237,10 @@
     <PackageVersion Include="Aspire.Hosting.Azure.ServiceBus" Version="13.1.0" />
     <PackageVersion Include="Aspire.Hosting.Testing" Version="13.1.0" />
     <!-- Aspire.Hosting.Keycloak: NO STABLE VERSION EXISTS - using latest preview -->
-    <!-- ERROR NU1102: Unable to find package Aspire.Hosting.Keycloak with version >= 13.0.2 -->
-    <!-- Nearest available: 13.0.2-preview.1.25603.5 (updated from 13.0.0-preview.1.25560.3) -->
+    <!-- Nearest available: 13.1.0-preview.1.25616.3 (updated from 13.0.2-preview.1.25603.5) -->
     <!-- MONITORING: Check https://www.nuget.org/packages/Aspire.Hosting.Keycloak for stable release -->
     <!-- DECISION: Package will remain in preview until Keycloak integration stabilizes in Aspire -->
-    <PackageVersion Include="Aspire.Hosting.Keycloak" Version="13.0.2-preview.1.25603.5" />
+    <PackageVersion Include="Aspire.Hosting.Keycloak" Version="13.1.0-preview.1.25616.3" />
     <PackageVersion Include="Aspire.Hosting.PostgreSQL" Version="13.1.0" />
     <PackageVersion Include="Aspire.Hosting.RabbitMQ" Version="13.1.0" />
     <PackageVersion Include="Aspire.Hosting.Redis" Version="13.1.0" />
@@ -248,7 +252,7 @@
     <!-- Code Analysis -->
     <PackageVersion Include="SonarAnalyzer.CSharp" Version="10.18.0.131500" />
     <!-- Blazor UI & State Management -->
-    <PackageVersion Include="MudBlazor" Version="7.21.0" />
+    <PackageVersion Include="MudBlazor" Version="8.0.0" />
     <PackageVersion Include="Fluxor.Blazor.Web" Version="6.9.0" />
     <PackageVersion Include="Fluxor.Blazor.Web.ReduxDevTools" Version="6.9.0" />
     <PackageVersion Include="Refit" Version="9.0.2" />

MeAjudaAi.slnx

@@ -116,8 +116,10 @@
   <Folder Name="/src/Modules/Users/Tests/">
     <Project Path="src/Modules/Users/Tests/MeAjudaAi.Modules.Users.Tests.csproj" />
   </Folder>
+  <Folder Name="/src/Contracts/">
+    <Project Path="src/Contracts/MeAjudaAi.Contracts.csproj" />
+  </Folder>
   <Folder Name="/src/Shared/">
-    <Project Path="src/Shared/MeAjudaAi.Shared.Contracts/MeAjudaAi.Shared.Contracts.csproj" />
     <Project Path="src/Shared/MeAjudaAi.Shared.csproj" />
   </Folder>
   <Folder Name="/src/Web/">

README.md

@@ -2,7 +2,7 @@
 
 Uma plataforma abrangente de serviços construída com .NET Aspire, projetada para conectar prestadores de serviços com clientes usando arquitetura monólito modular.
 
-<!-- Last updated: January 5, 2026 - Sprint 6 COMPLETED (Blazor Admin Portal Setup) / Sprint 7 Planning -->
+<!-- Last updated: January 9, 2026 - Sprint 7.5 COMPLETED (0 warnings, automação, Aspire fix) -->
 
 ## 🎯 Visão Geral
 
@@ -19,10 +19,13 @@ O **MeAjudaAi** é uma plataforma moderna de marketplace de serviços que implem
 ### 🚀 Tecnologias Principais
 
 - **.NET 10** - Framework principal
-- **.NET Aspire 13** - Orquestração e observabilidade
+- **.NET Aspire 13.1** - Orquestração e observabilidade
+- **Blazor WASM** - Admin Portal SPA
+- **MudBlazor 8.0** - Material Design UI components
+- **Fluxor 6.9** - Redux state management
 - **Entity Framework Core 10** - ORM e persistência
 - **PostgreSQL** - Banco de dados principal
-- **Keycloak** - Autenticação e autorização
+- **Keycloak** - Autenticação OAuth2/OIDC
 - **Redis** - Cache distribuído
 - **RabbitMQ/Azure Service Bus** - Messaging
 - **Docker** - Containerização
@@ -107,85 +110,103 @@ O projeto foi organizado para facilitar navegação e manutenção:
 
 ## 🚀 Início Rápido
 
-### Para Desenvolvedores
+### ⚡ Setup em 2 Comandos (Primeira Vez)
 
-Para instruções detalhadas, consulte o [**Guia de Desenvolvimento Completo**](./docs/development.md).
-
-**Setup via .NET Aspire:**
 ```powershell
-# Execute o AppHost do Aspire
-cd src/Aspire/MeAjudaAi.AppHost
-dotnet run
-```
+# 1. Setup inicial (verificar dependências + build)
+.\scripts\setup.ps1
 
-**Ou via Docker Compose:**
-```powershell
-cd infrastructure/compose
-docker compose -f environments/development.yml up -d
+# 2. Iniciar desenvolvimento
+.\scripts\dev.ps1
 ```
 
-### Para Testes
+**Pronto!** 🎉 Acesse:
+- **Aspire Dashboard**: https://localhost:17063
+- **Admin Portal**: Veja no dashboard (tab Resources)
+- **API Swagger**: https://localhost:7524/swagger
+- **Keycloak**: http://localhost:8080 (admin/admin)
+
+---
+
+### 🔄 Uso Diário
 
 ```powershell
-# Todos os testes
+# Iniciar desenvolvimento
+.\scripts\dev.ps1
+
+# OU usar Make (se tiver Make instalado)
+make dev
+
+# Executar testes
 dotnet test
 
-# Com relatório de cobertura
-dotnet test --collect:"XPlat Code Coverage"
+# Ver comandos disponíveis
+make help
 ```
 
-📖 **[Guia Completo de Desenvolvimento](docs/development.md)**
+### 📝 Configuração Necessária (Uma Vez)
 
-### Pré-requisitos
+⚠️ **Keycloak Client**: O Admin Portal Blazor precisa de configuração manual no Keycloak.
 
-- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
-- [Docker Desktop](https://www.docker.com/products/docker-desktop)
-- [Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli) (para deploy em produção)
-- [Git](https://git-scm.com/) para controle de versão
+👉 Siga: [docs/keycloak-admin-portal-setup.md](docs/keycloak-admin-portal-setup.md)
 
-### ⚙️ Configuração de Ambiente
-
-**Para deployments não-desenvolvimento:** Configure as variáveis de ambiente necessárias copiando `infrastructure/.env.example` para `infrastructure/.env` e definindo valores seguros. As seguintes variáveis são obrigatórias:
-- `POSTGRES_PASSWORD` - Senha do banco de dados PostgreSQL
-- `RABBITMQ_USER` e `RABBITMQ_PASS` - Credenciais do RabbitMQ
+---
 
-### Scripts de Automação
+### 📖 Documentação Completa
 
-O projeto inclui scripts automatizados na raiz:
+- [**Guia de Desenvolvimento**](docs/development.md) - Setup detalhado e workflows
+- [**Arquitetura**](docs/architecture.md) - Design e padrões do sistema
+- [**Documentação Online**](https://frigini.github.io/MeAjudaAi/) - GitHub Pages
 
-| Script | Descrição | Quando usar |
-|--------|-----------|-------------|
-| `setup-cicd.ps1` | Setup completo CI/CD com Azure | Para pipelines com deploy |
-| `setup-ci-only.ps1` | Setup apenas CI sem custos | Para validação de código apenas |
-| `run-local.sh` | Execução local com orquestração | Desenvolvimento local |
+---
 
-### Execução Local
+### 🧪 Para Testes
 
-#### Opção 1: .NET Aspire (Recomendado)
+```powershell
+# Todos os testes
+dotnet test
 
-```bash
-# Clone o repositório
-git clone https://github.com/frigini/MeAjudaAi.git
-cd MeAjudaAi
+# Com relatório de cobertura
+dotnet test --collect:"XPlat Code Coverage"
 
-# Execute o AppHost do Aspire
-cd src/Aspire/MeAjudaAi.AppHost
-dotnet run
+# Testes rápidos (make)
+make test
 ```
 
-#### Opção 2: Docker Compose
+### Pré-requisitos
 
-```bash
-# PRIMEIRO: Defina as senhas necessárias
-export KEYCLOAK_ADMIN_PASSWORD=$(openssl rand -base64 32)
-export RABBITMQ_PASS=$(openssl rand -base64 32)
+| Ferramenta | Versão | Link |
+|------------|--------|------|
+| **.NET SDK** | 10.0+ | [Download](https://dotnet.microsoft.com/download/dotnet/10.0) |
+| **Docker Desktop** | Latest | [Download](https://www.docker.com/products/docker-desktop) |
+| **Git** | Latest | [Download](https://git-scm.com/) |
+| Azure CLI (opcional) | Latest | Para deploy em produção |
 
-# Execute usando Docker Compose
-cd infrastructure/compose
-docker compose -f environments/development.yml up -d
-```
+✅ **Verificar instalação**: Execute `.\scripts\setup.ps1` que valida tudo automaticamente.
+
+### 🛠️ Scripts Disponíveis
+
+| Script | Descrição | Uso |
+|--------|-----------|-----|
+| **`scripts/setup.ps1`** | Setup inicial completo | Primeira vez no projeto |
+| **`scripts/dev.ps1`** | Iniciar desenvolvimento | Uso diário |
+| `scripts/ef-migrate.ps1` | Entity Framework migrations | Gerenciar banco de dados |
+| `scripts/seed-dev-data.ps1` | Popular dados de teste | Ambiente de desenvolvimento |
+| `scripts/export-openapi.ps1` | Exportar especificação API | Gerar documentação/clientes |
 
-### URLs dos Serviços
+**Automação CI/CD** (em `infrastructure/automation/`):
+- `setup-cicd.ps1` - Setup completo CI/CD com Azure
+- `setup-ci-only.ps1` - Setup apenas CI sem deploy
+
+**Makefile** (em `build/Makefile`):
+- `make help` - Ver todos os comandos disponíveis
+- `make dev` - Iniciar desenvolvimento
+- `make test` - Executar testes
+- `make clean` - Limpar artefatos
+
+---
+
+## 🌐 URLs dos Serviços
 
 > **📝 Nota**: As URLs abaixo são baseadas nas configurações em `launchSettings.json` e `docker-compose.yml`. 
 > Para atualizações de portas, consulte:
@@ -276,56 +297,66 @@ MeAjudaAi/
 
 ---
 
-## 🎨 Admin Portal (NEW - Sprint 6)
+## 🎨 Admin Portal (Sprint 6 + 7)
 
 ### Blazor WebAssembly + Fluxor + MudBlazor
 
-Portal administrativo moderno para gestão da plataforma MeAjudaAi.
+Portal administrativo moderno para gestão completa da plataforma MeAjudaAi.
 
 **Stack Tecnológica:**
 - **Blazor WebAssembly**: .NET 10 SPA client-side
-- **MudBlazor 7.21.0**: Material Design UI components
-- **Fluxor 6.1.0**: Redux-pattern state management
+- **MudBlazor 8.0.0**: Material Design UI components
+- **Fluxor 6.9.0**: Redux-pattern state management
 - **Refit 9.0.2**: Type-safe HTTP clients
 - **Keycloak OIDC**: Authentication via Authorization Code flow
 
-**Funcionalidades Implementadas (Sprint 6):**
-- ✅ **Autenticação**: Login/Logout via Keycloak OIDC
-- ✅ **Dashboard**: 3 KPIs (Total Providers, Pending Verifications, Active Services)
-- ✅ **Providers Management**: Listagem paginada (read-only)
+**Funcionalidades Implementadas:**
+- ✅ **Autenticação**: Login/Logout via Keycloak OIDC (Sprint 6)
+- ✅ **Dashboard**: KPIs + Charts com MudBlazor (Sprints 6-7)
+- ✅ **Providers**: CRUD completo (Create, Update, Delete, Verify) - Sprint 7
+- ✅ **Documents**: Upload, verificação, gestão - Sprint 7
+- ✅ **Service Catalogs**: CRUD de categorias e serviços - Sprint 7
+- ✅ **Geographic Restrictions**: Gestão de cidades permitidas - Sprint 7
 - ✅ **Dark Mode**: Toggle com Fluxor state management
 - ✅ **Portuguese Localization**: UI completa em português
+- ✅ **30 testes bUnit**: Cobertura de componentes principais
 
 **Como Executar:**
 
 ```powershell
 # Via Aspire AppHost (recomendado)
+.\scripts\dev.ps1
+
+# OU diretamente
 cd src/Aspire/MeAjudaAi.AppHost
 dotnet run
 
-# Acessar: https://localhost:7281
-# Login: admin.portal / admin123 (após criar client no Keycloak)
+# Acessar Admin Portal via Aspire Dashboard
+# https://localhost:17063 -> Resources -> admin-portal
 ```
 
 **Configuração Keycloak:**
 
-Siga o guia completo em [docs/keycloak-admin-portal-setup.md](docs/keycloak-admin-portal-setup.md) para criar o client `admin-portal` no realm `meajudaai`.
+⚠️ Necessário criar client `admin-portal` no Keycloak (uma vez apenas).
+
+👉 Siga: [docs/keycloak-admin-portal-setup.md](docs/keycloak-admin-portal-setup.md)
 
 **Testes:**
 
 ```powershell
 # Executar testes bUnit
-dotnet test tests/MeAjudaAi.Web.Admin.Tests
+dotnet test src/Web/MeAjudaAi.Web.Admin.Tests
 
-# 10 testes: ProvidersPage, Dashboard, DarkMode
+# 30 testes: Providers, Documents, Categories, Services, AllowedCities, Dashboard
 ```
 
 **Estrutura:**
 
 ```text
 src/Web/MeAjudaAi.Web.Admin/
-├── Pages/                # Razor pages (Dashboard, Providers, Authentication)
-├── Features/             # Fluxor stores (Providers, Dashboard, Theme)
+├── Pages/                # Razor pages (Dashboard, Providers, Documents, Categories, Services, AllowedCities)
+├── Features/             # Fluxor stores (state management por feature)
+├── Components/           # Dialogs e componentes reutilizáveis
 ├── Layout/               # MainLayout, NavMenu
 └── wwwroot/              # appsettings.json, static assets