diff --git a/.github/workflows/pr-validation.yml b/.github/workflows/pr-validation.yml
index ea88fd2a5..6d5efc42a 100644
--- a/.github/workflows/pr-validation.yml
+++ b/.github/workflows/pr-validation.yml
@@ -2,8 +2,10 @@
name: Pull Request Validation
"on":
- pull_request:
+ push:
branches: [master, develop]
+ pull_request:
+ branches: ['**']
# Manual trigger for testing workflow changes
workflow_dispatch:
diff --git a/.gitignore b/.gitignore
index 2d0451d90..d31a327cf 100644
--- a/.gitignore
+++ b/.gitignore
@@ -145,3 +145,5 @@ legacy-analysis-report.*
# MkDocs build output
site/
+
+/src/Web/MeAjudaAi.Web.Customer/layout.css
diff --git a/Directory.Packages.props b/Directory.Packages.props
index 149dc15ee..4e7bafa7d 100644
--- a/Directory.Packages.props
+++ b/Directory.Packages.props
@@ -167,6 +167,7 @@
+
diff --git a/docs/roadmap.md b/docs/roadmap.md
index 7e5ac46f9..684008dae 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -7,41 +7,16 @@ Este documento consolida o planejamento estratégico e tático da plataforma MeA
## 📊 Sumário Executivo
**Projeto**: MeAjudaAi - Plataforma de Conexão entre Clientes e Prestadores de Serviços
-**Status Geral**: Fase 1 ✅ | Sprint 0-5.5 ✅ | Sprint 6 ✅ | Sprint 7-7.15 ✅ CONCLUÍDO | MVP Target: 14/Março/2026
+**Status Geral**: Consulte a [Tabela de Sprints](#cronograma-de-sprints) para o status detalhado atualizado.
**Cobertura de Testes**: Backend 90.56% | Frontend 30 testes bUnit
**Stack**: .NET 10 LTS + Aspire 13 + PostgreSQL + Blazor WASM (Admin) + React 19 + Next.js 15 (Customer) + Tailwind v4
### Marcos Principais
-- ✅ **Janeiro 2025**: Fase 1 concluída - 6 módulos core implementados
-- ✅ **Jan 20 - 21 Nov**: Sprint 0 - Migration .NET 10 + Aspire 13 (CONCLUÍDO e MERGED)
-- ✅ **22 Nov - 2 Dez**: Sprint 1 - Geographic Restriction + Module Integration (CONCLUÍDO e MERGED)
-- ✅ **3 Dez - 10 Dez**: Sprint 2 - Test Coverage 90.56% (CONCLUÍDO - META 35% SUPERADA!)
-- ✅ **10 Dez - 11 Dez**: Sprint 3 Parte 1 - GitHub Pages Migration (CONCLUÍDO - DEPLOYED!)
-- ✅ **11 Dez - 13 Dez**: Sprint 3 Parte 2 - Admin Endpoints & Tools (CONCLUÍDO - MERGED!)
-- ✅ **14 Dez - 18 Dez**: Sprint 4 - Health Checks + Data Seeding + Code Review (CONCLUÍDO - MERGED!)
-- ✅ **Sprint 5**: Tarefas completadas antecipadamente (NSubstitute→Moq, .slnx, UuidGenerator, Design Patterns, Bruno)
-- ✅ **19 Dez - 30 Dez**: Sprint 5.5 - Refactor & Cleanup (CONCLUÍDO - Technical Debt Reduction)
-- ✅ **30 Dez - 5 Jan 2026**: Sprint 6 - Blazor Admin Portal Setup (CONCLUÍDO - 5 Jan 2026, MERGED!)
-- ✅ **6 Jan - 7 Jan 2026**: Sprint 7 - Blazor Admin Portal Features (CONCLUÍDO - 7 Jan 2026, 100%)
-- ✅ **9 Jan 2026**: Sprint 7.5 - Correções de Inicialização e Build (CONCLUÍDO - 0 warnings, 0 erros)
-- ✅ **12 Jan 2026**: Sprint 7.6 - Otimização de Testes de Integração (CONCLUÍDO - 83% faster)
-- ✅ **15-16 Jan 2026**: Sprint 7.7 - Flux Pattern Refactoring (CONCLUÍDO - 5 páginas refatoradas, 87% code reduction)
-- ✅ **16 Jan 2026**: Sprint 7.8 - Dialog Implementation Verification (CONCLUÍDO - 5 dialogs verificados, build fixes)
-- ✅ **16 Jan 2026**: Sprint 7.9 - Magic Strings Elimination (CONCLUÍDO - 30+ strings eliminados, constants centralizados)
-- ✅ **16 Jan 2026**: Sprint 7.10 - Accessibility Features (CONCLUÍDO - WCAG 2.1 AA compliance, ARIA labels, screen reader support)
-- ✅ **16 Jan 2026**: Sprint 7.11 - Error Boundaries (CONCLUÍDO - Global error handling, Fluxor error state, recovery options)
-- ✅ **16 Jan 2026**: Sprint 7.12 - Performance Optimizations (CONCLUÍDO - Virtualization, debounced search, memoization)
-- ✅ **16 Jan 2026**: Sprint 7.13 - Standardized Error Handling (CONCLUÍDO - Retry logic, correlation IDs, HTTP status mapping)
-- ✅ **16 Jan 2026**: Sprint 7.14 - Complete Localization (CONCLUÍDO - pt-BR/en-US, 140+ strings, culture switching)
-- ✅ **16 Jan 2026**: Sprint 7.15 - Package Updates & Resilience Migration (CONCLUÍDO - .NET 10.0.2, deprecated packages removed)
-- ✅ **17-21 Jan 2026**: Sprint 7.16 - Technical Debt Sprint (CONCLUÍDO - Keycloak automation, warnings, tests, records)
-- ✅ **5 Fev 2026**: Sprint 7.20 - Dashboard Charts & Data Mapping Fixes (CONCLUÍDO - JSON property mapping, debug messages removed)
-- ✅ **5 Fev 2026**: Sprint 7.21 - Package Updates & Bug Fixes (CONCLUÍDO - Microsoft.OpenApi 2.6.1, Aspire.Hosting.Redis 13.1.0, SonarAnalyzer.CSharp 10.19.0)
-- ✅ **5-13 Fev 2026**: Sprint 8A - Customer Web App (React + Next.js) (CONCLUÍDO - Features & Test Optimization)
-- ⏳ **19 Fev - 4 Mar 2026**: Sprint 8B - Mobile App (React Native + Expo)
-- ⏳ **5-11 Mar 2026**: Sprint 9 - BUFFER (Polishing, Risk Mitigation, Final Testing)
-- 🎯 **14 Março 2026**: MVP Launch (Admin Portal + Customer App Web + Mobile)
-- 🔮 **Março 2026+**: Fase 3 - Reviews, Assinaturas, Agendamentos
+
+Consulte a seção [Cronograma de Sprints](#cronograma-de-sprints) abaixo para o status detalhado e atualizado de cada sprint, e datas alvo (incluindo o MVP Launch).
+
+**Procedimento de Revisão de Sprints**
+As futuras atualizações da tabela de sprints devem observar a política: análise commit-by-commit newest-first, apresentando um veredicto conciso e resolvendo os follow-ups.
## ⚠️ Notas de Risco
@@ -49,11 +24,53 @@ Este documento consolida o planejamento estratégico e tático da plataforma MeA
- Primeiro projeto Blazor WASM pode revelar complexidade não prevista
- Sprint 9 reservado como buffer de contingência (não para novas features)
+## 🏗️ Decisões Arquiteturais Futuras
+
+### NX Monorepo (Frontend)
+
+**Status**: ⏳ Planejado pós-MVP
+**Branch**: `infra/nx-monorepo` (separada do Sprint 8B)
+
+**Motivação**: Com Customer Web App (Next.js), Provider App (futuro) e Mobile (React Native + Expo), o compartilhamento de código (componentes, hooks, tipos TypeScript, schemas Zod) entre os projetos se torna crítico. NX oferece:
+- Workspace unificado com `libs/` compartilhadas
+- Build cache inteligente (só reconstrói o que mudou)
+- Dependency graph entre projetos
+- Geração de código consistente
+
+**Escopo da Sprint NX**:
+- Migrar `MeAjudaAi.Web.Customer` para workspace NX
+- Criar `apps/customer-web`, `apps/provider-web` (futuro), `apps/mobile`
+- Criar `libs/ui` (componentes compartilhados), `libs/auth`, `libs/api-client`
+- Atualizar `.NET Aspire AppHost` para apontar para nova estrutura
+- Atualizar CI/CD para usar `nx affected`
+
+**Timing recomendado**: Pós-MVP (Sprint Infra), pois o NX facilita exatamente o compartilhamento entre Customer e Provider.
+
+---
+
+### Migração Admin Portal: Blazor WASM → React?
+
+**Status**: ⚪ Não planejado — decisão deliberada manter Blazor
+
+**Análise**:
+
+| Fator | Manter Blazor | Migrar para React |
+|-------|--------------|-------------------|
+| Custo | ✅ Zero | ❌ Alto (reescrever ~5000+ linhas) |
+| Compartilhamento C# DTOs | ✅ Nativo | ❌ Requer geração OpenAPI |
+| Uso interno (não SEO) | ✅ Blazor adequado | ⚠️ React seria over-engineering |
+| Unificação de stack | ⚠️ Dual-stack | ✅ Single-stack |
+| Hiring | ⚠️ Blazor nicho | ✅ React mais fácil |
+
+**Decisão**: **Manter Blazor WASM** para o Admin Portal. O Admin é uma ferramenta interna sem requisitos de SEO ou performance de carga inicial. A vantagem de compartilhar C# DTOs diretamente supera o custo de manter dual-stack. Migração só faria sentido se o time crescer e a curva de aprendizado Blazor se tornar um gargalo real de contratação.
+
+**Revisitar se**: time crescer >5 devs frontend e Blazor se tornar bloqueador de contratação.
+
---
## 🎯 Status Atual
-**📅 Sprint 8B pré-início**: Fevereiro de 2026
+**📅 Sprint 8B concluído**: Fevereiro/Março de 2026 (Finalizado em 4 de Março de 2026)
### ✅ Sprint 8A - Customer Web App & Test Optimization - CONCLUÍDA (5-13 Fev 2026)
@@ -73,7 +90,60 @@ Este documento consolida o planejamento estratégico e tático da plataforma MeA
- **Problema**: Testes E2E lentos devido a acúmulo de dados (40m+).
- **Solução**: Implementado `IAsyncLifetime` e `CleanupDatabaseAsync()` em **todas** as classes de teste E2E (`Documents`, `Locations`, `Providers`, `ServiceCatalogs`, `Users`).
- **Resultado**: Testes rodam com banco limpo a cada execução, prevenindo degradação de performance e falhas por dados sujos (Race Conditions).
-- **Parallelization**: Confirmado que `parallelizeTestCollections: false` é necessário devido ao uso de container de banco compartilhado.
+- `parallelizeTestCollections`: Controla se coleções de teste executam em paralelo no xUnit. Confirmado que `parallelizeTestCollections: false` é necessário para DbContext com TestContainers, pois banco compartilhado causa lock conflicts.
+---
+
+### ✅ Sprint 8B.1 - Provider Onboarding & Registration Experience - CONCLUÍDA (Março 2026)
+
+**Objetivos**:
+1. ✅ **Multi-step Provider Registration**: Implementar UI de "Torne-se um Prestador" com Stepper unificado.
+2. ✅ **Fix Backend Reliability**: Resolver erros 500 nos endpoints críticos de prestador.
+3. ✅ **Visual Alignment**: Alinhar design do prestador com o fluxo de cliente.
+
+**Avanços Entregues**:
+- **Stepper UI**: Componente de linha do tempo implementado em `/cadastro/prestador`, guiando o usuário pelas etapas de Dados Básicos, Endereço e Documentos.
+- **Correção de API (Critical)**: Resolvido erro de resolução de DI para `RegisterProviderCommandHandler`, permitindo a criação de perfis sem falhas internas (500).
+- **Onboarding Flow**: Implementação da lógica de transição entre passos 1 (Dados Básicos) e 2 (Endereço), com persistência correta no banco de dados.
+- **Validation**: Integração com esquema de validação existente e tratamento de erros amigável no frontend.
+
+**Próximos Passos (Pendentes)**:
+- ⏳ **Document Upload (Step 3)**: Implementar componente de upload de documentos no fluxo de onboarding do prestador.
+- ⏳ **Review Dashboard**: Criar interface para o prestador acompanhar o status de sua verificação (hoje parado em `pendingBasicInfo`).
+- ⏳ **Professional Profile Setup**: Permitir que o prestador selecione categorias e serviços logo após o credenciamento básico.
+
+---
+
+### ⏳ Sprint 8B.2 - Technical Excellence & Infrastructure (Planejado - Antes do Mobile)
+
+**Objetivos**:
+1. ⏳ **Slug Implementation**: Substituir IDs por Slugs nas rotas de perfil de prestador para maior segurança e SEO.
+ - **Execução**:
+ - Backend: Adicionar `Slug` ao `BusinessProfile` entity.
+ - Backend: Implementar `slugify` logic e garantir unicidade no Persistence layer.
+ - UI: Alterar rotas de `/prestador/[id]` para `/prestador/[slug]`.
+ - SEO: Adicionar canonical tags e metadados dinâmicos baseados no slug.
+ - **Sucesso**: Navegar via slug e manter compatibilidade com IDs antigos (301 redirect).
+2. ⏳ **Messaging Unification (RabbitMQ Only)**: Remover completamente o Azure Service Bus da solução.
+ - **Execução**:
+ - Remover pacotes `.Azure.ServiceBus` de todos os projetos.
+ - Unificar `MassTransit` configuration em `ServiceDefaults`.
+ - Atualizar scripts de infra (`docker-compose.yaml`) para foco total em RabbitMQ.
+ - Remover segredos e vars de ambiente do ASB no Azure/Staging.
+ - **Sucesso**: Aplicação funcionando sem dependência do Azure Service Bus local ou remoto.
+3. ⏳ **Frontend Testing & CI/CD Suite**: Implementar suíte completa de testes no Next.js.
+ - **Contexto**: Baseado no [Plano de Testes Robusto](./testing/frontend-testing-plan.md).
+ - **Execução**:
+ - Setup do projeto `tests/MeAjudaAi.Web.Customer.Tests`.
+ - Implementar Mocks de API com MSW para os fluxos de busca e perfil.
+ - Criar o primeiro pipeline `.github/workflows/frontend-quality.yml`.
+ - Integrar SonarCloud (SonarQube) para análise estática de TS/React.
+ - **Sucesso**: Pipeline falhando se testes não passarem ou qualidade cair.
+4. ⏳ **Backend Integration Test Optimization**: Reduzir o tempo de execução (hoje ~30 min).
+ - **Execução**:
+ - Migrar os ~20 projetos de teste restantes para o padrão `RequiredModules`.
+ - Implementar `Respawn` ou similar para limpeza ultra-rápida de banco em vez de migrations completas.
+ - Otimizar recursos do TestContainers (reuse containers entre runs se possível).
+ - **Sucesso**: Suíte completa de integração rodando em < 10 minutos.
---
@@ -1460,7 +1530,7 @@ Get-ChildItem -Recurse -Include *.cs | Select-String "record "
---
-### ⏳ Sprint 8B - Authentication & Onboarding Flow (Novo)
+### ✅ Sprint 8B - Authentication & Onboarding Flow - CONCLUÍDO
**Periodo Estimado**: 19 Fev - 4 Mar 2026
**Foco**: Fluxos de Cadastro e Login Segmentados (Cliente vs Prestador)
@@ -1508,7 +1578,7 @@ Get-ChildItem -Recurse -Include *.cs | Select-String "record "
### ⏳ Sprint 8C - Mobile App (React Native)
-**Periodo Estimado**: 5 Mar - 18 Mar 2026 (Deslocado)
+**Periodo Estimado**: 5 Mar - 18 Mar 2026
**Foco**: App Mobile Nativo (iOS/Android) com Expo
**Escopo**:
@@ -2081,11 +2151,12 @@ Frontend Blazor WASM + MAUI Hybrid:
- Sprint 7: Blazor Admin Portal Features (6-24 Jan 2026) - ✅ CONCLUÍDO
- Sprint 7.16: Technical Debt Sprint (17-21 Jan 2026) - 🔄 EM PROGRESSO (Task 5 movida p/ Sprint 9)
- Sprint 8: Customer App (5-18 Fev 2026) - ✅ Concluído
-- Sprint 8B: Mobile App (19 Fev - 4 Mar 2026) - ⏳ Planejado
-- Sprint 8D: Admin Portal Migration (19 Mar - 1 Abr 2026) - ⏳ Planejado
-- Sprint 9: Buffer/Polishing (5-11 Mar 2026) - ⏳ Planejado
-- MVP Final: 14 de Março de 2026
-- *Nota: Data de MVP atualizada para 14 de Março de 2026 para acomodar migração Nx e Mobile App.*
+- Sprint 8B: Authentication & Onboarding (19 Fev - 4 Mar 2026) - ✅ CONCLUÍDO
+- Sprint 8C: Mobile App (5-18 Mar 2026) - ⏳ Planejado
+- Sprint 8D: Admin Portal Migration - 🚫 **CANCELADO**
+- ⏳ **19-25 Mar 2026**: Sprint 9 - BUFFER (Polishing, Risk Mitigation, Final Testing)
+- MVP Final: 28 de Março de 2026
+- *Nota: Data de MVP atualizada para 28 de Março de 2026 para acomodar buffer do Sprint 9 e Mobile App.*
**⚠️ Risk Assessment**: Estimativas assumem velocidade consistente. Primeiro projeto Blazor WASM pode revelar complexidades não previstas (integração Keycloak, curva de aprendizado MudBlazor). Sprint 9 reservado como buffer de contingência.
@@ -2105,6 +2176,7 @@ A implementação segue os princípios arquiteturais definidos em `architecture.
---
+
## 📅 Cronograma de Sprints (Novembro 2025-Março 2026)
| Sprint | Duração | Período | Objetivo | Status |
@@ -2121,14 +2193,15 @@ A implementação segue os princípios arquiteturais definidos em `architecture.
| **Sprint 7** | 3 semanas | 6 - 24 Jan | Blazor Admin Portal - Features | ✅ CONCLUÍDO |
| **Sprint 7.16** | 1 semana | 17-21 Jan | Technical Debt Sprint | 🔄 EM PROGRESSO |
| **Sprint 8** | 2 semanas | 5 - 18 Fev | Customer Web App (Web) | ✅ CONCLUÍDO |
-| **Sprint 8B** | 2 semanas | 19 Fev - 4 Mar | Mobile App (React Native) | ⏳ Planejado |
-| **Sprint 9** | 1 semana | 5-11 Mar | **BUFFER: Polishing, Refactoring & Risk Mitigation** | ⏳ Planejado |
-| **MVP Launch** | - | 14 Mar | Final deployment & launch preparation | 🎯 Target |
+| **Sprint 8B** | 2 semanas | 19 Fev - 4 Mar | Authentication & Onboarding | ✅ CONCLUÍDO |
+| **Sprint 8C** | 2 semanas | 5-18 Mar | Mobile App | ⏳ Planejado |
+| **Sprint 9** | 1 semana | 19-25 Mar | **BUFFER: Polishing, Refactoring & Risk Mitigation** | ⏳ Planejado |
+| **MVP Launch** | - | 28 de Março de 2026 | Final deployment & launch preparation | 🎯 Target |
-**MVP Launch Target**: 14 de Março de 2026 🎯
-*Atualizado para 14 de Março de 2026.*
+**MVP Launch Target**: 28 de Março de 2026 🎯
+*Atualizado para 28 de Março de 2026.*
-**Post-MVP (Fase 3+)**: Reviews, Assinaturas, Agendamentos (Fevereiro 2026+)
+**Post-MVP (Fase 3+)**: Reviews, Assinaturas, Agendamentos (Abril 2026+)
---
@@ -4187,15 +4260,6 @@ public class GeographicRestrictionMiddleware
---
-### ⏳ Sprint 8D - Admin Portal Migration (Novo)
-
-**Periodo Estimado**: 19 Mar - 1 Abr 2026
-**Foco**: Migração do Admin Portal para React e integração no monorepo Nx.
-
-**Objetivos**:
-1. **Nx Workspace Setup**: Garantir suporte a múltiplos apps (Admin + Customer).
-2. **Admin Portal Migration**: Portar Blazor Admin para React (`apps/admin-portal`).
-3. **Shared Components**: Extrair UI kit para `libs/shared-ui`.
4. **Auth Migration**: Configurar Keycloak no novo app React.
**Entregáveis**:
@@ -4352,10 +4416,10 @@ Durante o processo de atualização automática de dependências pelo Dependabot
---
-### 📅 Sprint 9: Buffer - Polishing, Risk Mitigation & Refactoring (3 semanas) 🎯
+### ⏳ **19-25 Mar 2026**: Sprint 9 - BUFFER (Polishing, Risk Mitigation, Final Testing)
**Status**: 📋 PLANEJADO PARA MARÇO 2026
-**Duração**: 1 semana (5-11 Mar 2026)
+**Duração**: 1 semana (19-25 Mar 2026)
**Dependências**: Sprints 6-8 completos
**Natureza**: **BUFFER DE CONTINGÊNCIA** - não alocar novas features
@@ -4485,7 +4549,7 @@ Durante o processo de atualização automática de dependências pelo Dependabot
- ✅ Segurança e performance hardened
- ✅ Documentação completa para usuários e desenvolvedores
- ✅ Monitoring e observabilidade configurados
-- 🎯 **PRONTO PARA LAUNCH EM 14 DE MARÇO DE 2026**
+- 🎯 **PRONTO PARA LAUNCH EM 28 DE MARÇO DE 2026**
> **⚠️ CRITICAL**: Se Sprint 9 não for suficiente para completar todos os itens, considerar delay do MVP launch ou reduzir escopo (mover features não-críticas para post-MVP). A qualidade e estabilidade do MVP são mais importantes que a data de lançamento.
@@ -4950,7 +5014,7 @@ public class ActivityHub : Hub
4. 📋 **Sprint 8: Customer Portal** - React/Next.js (Planejado - Fev/Mar 2026)
- Busca de prestadores
- Gestão de perfil
-5. 📋 **Sprint 8D: Admin Portal Migration** - React/Nx (Planejado - Mar/Abr 2026)
+5. 🚫 **Sprint 8D: Admin Portal Migration** - **CANCELADO**
- Migração completa de Blazor para React
6. 📋 API Collections - Bruno .bru files para todos os módulos
@@ -5012,6 +5076,6 @@ public class ActivityHub : Hub
---
-*📅 Última atualização: 9 de Janeiro de 2026 (Sprint 7.5 - Correções de Inicialização e Build)*
+*📅 Última atualização: 5 de Março de 2026 (Sprint 8B Conclusion Review)*
*🔄 Roadmap em constante evolução baseado em feedback, métricas e aprendizados*
-*📊 Status atual: Sprint 6 CONCLUÍDA (5 Jan 2026) | Sprint 7 - Blazor Admin Portal Features (próxima)*
+*📊 Status atual: Sprint 8B ✅ CONCLUÍDO | MVP Launch em 28 de Março de 2026*
diff --git a/docs/testing/frontend-testing-plan.md b/docs/testing/frontend-testing-plan.md
new file mode 100644
index 000000000..def157fd4
--- /dev/null
+++ b/docs/testing/frontend-testing-plan.md
@@ -0,0 +1,1790 @@
+# Plano de Implementação de Testes - React 19 + TypeScript
+## Projeto: MeAjudaAi.Web.Consumer (Monorepo .NET)
+
+## 📋 Sumário
+
+1. [Contexto do Projeto](#contexto-do-projeto)
+2. [Decisão Arquitetural](#decisão-arquitetural)
+3. [Bibliotecas e Dependências](#bibliotecas-e-dependências)
+4. [Estrutura de Pastas](#estrutura-de-pastas)
+5. [Configuração](#configuração)
+6. [Estrutura dos Arquivos de Teste](#estrutura-dos-arquivos-de-teste)
+7. [Pipeline CI/CD Robusta (Ref. Medium)](#pipeline-cicd-robusta-ref-medium)
+8. [Integração com Pipeline CI/CD](#integração-com-pipeline-cicd)
+9. [Comandos Úteis](#comandos-úteis)
+10. [Boas Práticas](#boas-práticas)
+
+---
+
+## 🏗️ Contexto do Projeto
+
+O projeto está integrado em um **monorepo .NET** com arquitetura de **monolito modular**. A estrutura atual já possui:
+
+- **Backend .NET** com testes completos organizados por camada:
+ - `MeAjudaAi.ApiService.Tests`
+ - `MeAjudaAi.Architecture.Tests`
+ - `MeAjudaAi.E2E.Tests`
+ - `MeAjudaAi.Integration.Tests`
+ - `MeAjudaAi.Shared.Tests`
+ - `MeAjudaAi.Web.Admin.Tests` (Blazor WASM com bUnit)
+
+- **Frontend React** localizado em:
+ - `src/Web/MeAjudaAi.Web.Consumer`
+
+---
+
+## 🎯 Decisão Arquitetural
+
+### ✅ Recomendação: Criar Projeto Separado de Testes
+
+**Criar:** `tests/MeAjudaAi.Web.Consumer.Tests`
+
+### Justificativa
+
+1. **Consistência com a arquitetura existente**: Todos os projetos de teste já estão separados na pasta `tests/`
+2. **Separação de responsabilidades**: Backend (.NET) e Frontend (React) mantêm seus testes isolados
+3. **Pipeline CI/CD independente**: Permite executar testes frontend/backend separadamente
+4. **Mesma abordagem do Web.Admin**: O portal admin Blazor já segue este padrão com `MeAjudaAi.Web.Admin.Tests`
+5. **Facilita manutenção**: Dependências JavaScript não poluem projetos .NET
+6. **Clareza organizacional**: Fica explícito que são testes de frontend
+
+### Estrutura Completa do Monorepo
+
+```text
+MeAjudaAi/
+├── src/
+│ ├── Web/
+│ │ ├── MeAjudaAi.Web.Consumer/ # ← Projeto React
+│ │ │ ├── src/
+│ │ │ ├── public/
+│ │ │ ├── package.json
+│ │ │ ├── vite.config.ts
+│ │ │ └── tsconfig.json
+│ │ └── MeAjudaAi.Web.Admin/ # Blazor WASM
+│ ├── ApiService/
+│ ├── Architecture/
+│ └── Shared/
+├── tests/
+│ ├── MeAjudaAi.ApiService.Tests/ # .NET
+│ ├── MeAjudaAi.Architecture.Tests/ # .NET
+│ ├── MeAjudaAi.E2E.Tests/ # .NET
+│ ├── MeAjudaAi.Integration.Tests/ # .NET
+│ ├── MeAjudaAi.Shared.Tests/ # .NET
+│ ├── MeAjudaAi.Web.Admin.Tests/ # bUnit (Blazor)
+│ └── MeAjudaAi.Web.Consumer.Tests/ # ← NOVO: Vitest/React Testing Library
+│ ├── src/
+│ │ ├── components/
+│ │ ├── hooks/
+│ │ ├── pages/
+│ │ ├── utils/
+│ │ └── __tests__/
+│ ├── e2e/
+│ ├── package.json
+│ ├── vitest.config.ts
+│ ├── playwright.config.ts
+│ └── tsconfig.json
+├── .editorconfig
+├── parallel.runsettings
+├── sequential.runsettings
+├── xunit.runner.json
+└── MeAjudaAi.sln
+```
+
+---
+
+## 📦 Bibliotecas e Dependências
+
+### Instalação Básica
+
+```bash
+# Testing framework e runners
+npm install --save-dev vitest @vitest/ui jsdom
+
+# React Testing Library
+npm install --save-dev @testing-library/react @testing-library/jest-dom @testing-library/user-event
+
+# Suporte a TypeScript para testes
+npm install --save-dev @testing-library/dom@^10.x
+
+# Cobertura de código
+npm install --save-dev @vitest/coverage-v8
+
+# Mock Service Worker (para mock de APIs)
+npm install --save-dev msw
+
+# Testes E2E (opcional mas recomendado)
+npm install --save-dev @playwright/test
+```
+
+### Pacotes Adicionais (Opcionais)
+
+```bash
+# Para testes de acessibilidade
+npm install --save-dev jest-axe
+
+# Para snapshots visuais
+npm install --save-dev @storybook/test-runner
+
+# Nota: O pacote @testing-library/react-hooks está depreciado.
+# Para testar hooks, use renderHook diretamente de '@testing-library/react' (v13.1+).
+```
+
+---
+
+## 📁 Estrutura de Pastas
+
+### Estrutura do Projeto de Testes: `tests/MeAjudaAi.Web.Consumer.Tests/`
+
+```text
+MeAjudaAi.Web.Consumer.Tests/
+├── src/
+│ ├── components/
+│ │ ├── Button/
+│ │ │ ├── Button.test.tsx
+│ │ │ └── Button.integration.test.tsx
+│ │ ├── Input/
+│ │ │ ├── Input.test.tsx
+│ │ │ └── Input.accessibility.test.tsx
+│ │ ├── Card/
+│ │ │ └── Card.test.tsx
+│ │ └── Layout/
+│ │ ├── Header.test.tsx
+│ │ └── Sidebar.test.tsx
+│ ├── hooks/
+│ │ ├── useAuth.test.ts
+│ │ ├── useLocalStorage.test.ts
+│ │ └── useDebounce.test.ts
+│ ├── pages/
+│ │ ├── Home/
+│ │ │ └── Home.test.tsx
+│ │ ├── Dashboard/
+│ │ │ └── Dashboard.test.tsx
+│ │ └── Profile/
+│ │ └── Profile.test.tsx
+│ ├── services/
+│ │ ├── api.test.ts
+│ │ ├── auth.service.test.ts
+│ │ └── storage.service.test.ts
+│ ├── utils/
+│ │ ├── formatters.test.ts
+│ │ ├── validators.test.ts
+│ │ └── helpers.test.ts
+│ └── __tests__/
+│ ├── setup.ts
+│ ├── helpers/
+│ │ ├── test-utils.tsx
+│ │ ├── mock-data.ts
+│ │ ├── custom-matchers.ts
+│ │ └── test-providers.tsx
+│ └── mocks/
+│ ├── handlers.ts
+│ ├── server.ts
+│ └── browser.ts
+├── e2e/
+│ ├── tests/
+│ │ ├── auth/
+│ │ │ ├── login.spec.ts
+│ │ │ ├── register.spec.ts
+│ │ │ └── logout.spec.ts
+│ │ ├── navigation/
+│ │ │ ├── menu.spec.ts
+│ │ │ └── routes.spec.ts
+│ │ └── user-flows/
+│ │ ├── complete-profile.spec.ts
+│ │ └── request-help.spec.ts
+│ ├── fixtures/
+│ │ ├── users.ts
+│ │ └── requests.ts
+│ └── utils/
+│ └── helpers.ts
+├── coverage/
+│ └── (gerado automaticamente)
+├── node_modules/
+├── package.json
+├── package-lock.json
+├── vitest.config.ts
+├── playwright.config.ts
+├── tsconfig.json
+├── .gitignore
+└── README.md
+```
+
+### Mapeamento para o Código Fonte
+
+Os testes espelham a estrutura do projeto principal:
+
+```text
+src/Web/MeAjudaAi.Web.Consumer/src/ → tests/MeAjudaAi.Web.Consumer.Tests/src/
+ components/Button/Button.tsx → components/Button/Button.test.tsx
+ hooks/useAuth.ts → hooks/useAuth.test.ts
+ pages/Home/Home.tsx → pages/Home/Home.test.tsx
+ utils/formatters.ts → utils/formatters.test.ts
+```
+
+### Estrutura de Nomenclatura
+
+- **Testes unitários**: `*.test.tsx` ou `*.test.ts`
+- **Testes de integração**: `*.integration.test.tsx`
+- **Testes de acessibilidade**: `*.accessibility.test.tsx`
+- **Testes E2E**: `*.spec.ts` (dentro de `e2e/tests/`)
+
+### Vantagens desta Estrutura
+
+✅ **Separação clara**: Testes não poluem o código de produção
+✅ **Consistência**: Segue o padrão do monorepo (.NET tests separados)
+✅ **Build otimizado**: Fácil excluir testes do bundle de produção
+✅ **CI/CD independente**: Pode rodar testes frontend/backend separadamente
+✅ **Organização**: Mesma abordagem do `MeAjudaAi.Web.Admin.Tests`
+
+---
+
+## ⚙️ Configuração
+
+### 1. `vitest.config.ts`
+
+```typescript
+import { defineConfig } from 'vitest/config';
+import react from '@vitejs/plugin-react';
+import path from 'path';
+
+export default defineConfig({
+ plugins: [react()],
+ test: {
+ globals: true,
+ environment: 'jsdom',
+ setupFiles: './src/__tests__/setup.ts',
+ css: true,
+ coverage: {
+ provider: 'v8',
+ reporter: ['text', 'json', 'html', 'lcov'],
+ exclude: [
+ 'node_modules/',
+ 'src/__tests__/',
+ '**/*.d.ts',
+ '**/*.config.*',
+ '**/mockData',
+ 'src/main.tsx',
+ ],
+ thresholds: {
+ lines: 80,
+ functions: 80,
+ branches: 80,
+ statements: 80,
+ },
+ },
+ },
+ resolve: {
+ alias: {
+ '@': path.resolve(__dirname, './src'),
+ '@src': path.resolve(__dirname, '../../src/Web/MeAjudaAi.Web.Consumer/src'),
+ '@components': path.resolve(__dirname, '../../src/Web/MeAjudaAi.Web.Consumer/src/components'),
+ '@hooks': path.resolve(__dirname, '../../src/Web/MeAjudaAi.Web.Consumer/src/hooks'),
+ '@utils': path.resolve(__dirname, '../../src/Web/MeAjudaAi.Web.Consumer/src/utils'),
+ '@pages': path.resolve(__dirname, '../../src/Web/MeAjudaAi.Web.Consumer/src/pages'),
+ },
+ },
+});
+```
+
+### 2. `src/__tests__/setup.ts`
+
+```typescript
+import '@testing-library/jest-dom/vitest';
+import { cleanup } from '@testing-library/react';
+import { afterEach, beforeAll, afterAll } from 'vitest';
+import { server } from './mocks/server';
+
+// Estabelece requisições de API mockadas
+beforeAll(() => server.listen({ onUnhandledRequest: 'error' }));
+
+// Reseta handlers entre testes
+afterEach(() => {
+ cleanup();
+ server.resetHandlers();
+});
+
+// Limpa após todos os testes
+afterAll(() => server.close());
+
+// Mock do matchMedia
+Object.defineProperty(window, 'matchMedia', {
+ writable: true,
+ value: (query: string) => ({
+ matches: false,
+ media: query,
+ onchange: null,
+ addListener: () => {}, // deprecated
+ removeListener: () => {}, // deprecated
+ addEventListener: () => {},
+ removeEventListener: () => {},
+ dispatchEvent: () => {},
+ }),
+});
+
+// Mock do IntersectionObserver
+global.IntersectionObserver = class IntersectionObserver {
+ constructor() {}
+ disconnect() {}
+ observe() {}
+ takeRecords() {
+ return [];
+ }
+ unobserve() {}
+} as any;
+```
+
+### 3. `src/__tests__/helpers/test-utils.tsx`
+
+```typescript
+import { ReactElement } from 'react';
+import { render, RenderOptions } from '@testing-library/react';
+import { BrowserRouter } from 'react-router-dom';
+
+// Provider customizado se você tiver (Context, Theme, etc)
+interface AllTheProvidersProps {
+ children: React.ReactNode;
+}
+
+const AllTheProviders = ({ children }: AllTheProvidersProps) => {
+ return (
+
+ {/* Adicione seus providers aqui */}
+ {/* */}
+ {/* */}
+ {children}
+ {/* */}
+ {/* */}
+
+ );
+};
+
+const customRender = (
+ ui: ReactElement,
+ options?: Omit
+) => render(ui, { wrapper: AllTheProviders, ...options });
+
+// Re-exporta tudo
+export * from '@testing-library/react';
+export { customRender as render };
+```
+
+### 4. `src/__tests__/mocks/handlers.ts`
+
+```typescript
+import { http, HttpResponse } from 'msw';
+
+export const handlers = [
+ // GET exemplo
+ http.get('/api/users', () => {
+ return HttpResponse.json([
+ { id: 1, name: 'John Doe', email: 'john@example.com' },
+ { id: 2, name: 'Jane Smith', email: 'jane@example.com' },
+ ]);
+ }),
+
+ // POST exemplo
+ http.post('/api/login', async ({ request }) => {
+ const { email, password } = await request.json();
+
+ if (email === 'test@test.com' && password === 'password123') {
+ return HttpResponse.json({
+ token: 'fake-jwt-token',
+ user: { id: 1, email, name: 'Test User' },
+ });
+ }
+
+ return HttpResponse.json(
+ { message: 'Invalid credentials' },
+ { status: 401 }
+ );
+ }),
+
+ // Erro exemplo
+ http.get('/api/error', () => {
+ return HttpResponse.json(
+ { message: 'Internal Server Error' },
+ { status: 500 }
+ );
+ }),
+];
+```
+
+### 5. `src/__tests__/mocks/server.ts`
+
+```typescript
+import { setupServer } from 'msw/node';
+import { handlers } from './handlers';
+
+export const server = setupServer(...handlers);
+```
+
+### 6. `playwright.config.ts`
+
+```typescript
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+ testDir: './e2e/tests',
+ fullyParallel: true,
+ forbidOnly: !!process.env.CI,
+ retries: process.env.CI ? 2 : 0,
+ workers: process.env.CI ? 1 : undefined,
+ reporter: 'html',
+ use: {
+ baseURL: 'http://localhost:5173',
+ trace: 'on-first-retry',
+ screenshot: 'only-on-failure',
+ },
+ projects: [
+ {
+ name: 'chromium',
+ use: { ...devices['Desktop Chrome'] },
+ },
+ {
+ name: 'firefox',
+ use: { ...devices['Desktop Firefox'] },
+ },
+ {
+ name: 'webkit',
+ use: { ...devices['Desktop Safari'] },
+ },
+ ],
+ webServer: {
+ command: 'npm run dev',
+ url: 'http://localhost:5173',
+ reuseExistingServer: !process.env.CI,
+ },
+});
+```
+
+### 7. `package.json` - Scripts
+
+```json
+{
+ "scripts": {
+ "test": "vitest",
+ "test:ui": "vitest --ui",
+ "test:run": "vitest run",
+ "test:coverage": "vitest run --coverage",
+ "test:e2e": "playwright test",
+ "test:e2e:ui": "playwright test --ui",
+ "test:e2e:report": "playwright show-report"
+ }
+}
+```
+
+---
+
+## 📝 Estrutura dos Arquivos de Teste
+
+### Teste de Componente com Base UI React
+
+**`src/components/Button/Button.tsx`**
+
+```typescript
+import { Button as BaseButton } from '@base-ui/react/Button';
+import { tv, type VariantProps } from 'tailwind-variants';
+import { twMerge } from 'tailwind-merge';
+
+const button = tv({
+ base: 'inline-flex items-center justify-center rounded-md font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 disabled:pointer-events-none disabled:opacity-50',
+ variants: {
+ variant: {
+ primary: 'bg-blue-600 text-white hover:bg-blue-700',
+ secondary: 'bg-gray-200 text-gray-900 hover:bg-gray-300',
+ destructive: 'bg-red-600 text-white hover:bg-red-700',
+ ghost: 'hover:bg-gray-100',
+ },
+ size: {
+ sm: 'h-9 px-3 text-sm',
+ md: 'h-10 px-4',
+ lg: 'h-11 px-8 text-lg',
+ },
+ },
+ defaultVariants: {
+ variant: 'primary',
+ size: 'md',
+ },
+});
+
+export type ButtonProps = VariantProps & {
+ children: React.ReactNode;
+ className?: string;
+ disabled?: boolean;
+ type?: 'button' | 'submit' | 'reset';
+ onClick?: () => void;
+};
+
+export function Button({
+ children,
+ variant,
+ size,
+ className,
+ ...props
+}: ButtonProps) {
+ return (
+
+ {children}
+
+ );
+}
+```
+
+**`src/components/Button/Button.test.tsx`**
+
+```typescript
+import { describe, it, expect, vi } from 'vitest';
+import { render, screen } from '@/__tests__/helpers/test-utils';
+import userEvent from '@testing-library/user-event';
+import { Button } from '@src/components/Button/Button';
+
+describe('Button Component', () => {
+ it('deve renderizar corretamente', () => {
+ render();
+
+ expect(screen.getByRole('button', { name: /clique aqui/i })).toBeInTheDocument();
+ });
+
+ it('deve aplicar a variante primary por padrão', () => {
+ render();
+
+ const button = screen.getByRole('button');
+ expect(button).toHaveClass('bg-blue-600');
+ });
+
+ it('deve aplicar diferentes variantes', () => {
+ const { rerender } = render();
+ expect(screen.getByRole('button')).toHaveClass('bg-gray-200');
+
+ rerender();
+ expect(screen.getByRole('button')).toHaveClass('bg-red-600');
+
+ rerender();
+ expect(screen.getByRole('button')).toHaveClass('hover:bg-gray-100');
+ });
+
+ it('deve aplicar diferentes tamanhos', () => {
+ const { rerender } = render();
+ expect(screen.getByRole('button')).toHaveClass('h-9');
+
+ rerender();
+ expect(screen.getByRole('button')).toHaveClass('h-10');
+
+ rerender();
+ expect(screen.getByRole('button')).toHaveClass('h-11');
+ });
+
+ it('deve aceitar className customizada', () => {
+ render();
+
+ expect(screen.getByRole('button')).toHaveClass('custom-class');
+ });
+
+ it('deve estar desabilitado quando disabled=true', () => {
+ render();
+
+ const button = screen.getByRole('button');
+ expect(button).toBeDisabled();
+ expect(button).toHaveClass('opacity-50');
+ });
+
+ it('deve chamar onClick quando clicado', async () => {
+ const handleClick = vi.fn();
+ const user = userEvent.setup();
+
+ render();
+
+ await user.click(screen.getByRole('button'));
+
+ expect(handleClick).toHaveBeenCalledTimes(1);
+ });
+
+ it('não deve chamar onClick quando desabilitado', async () => {
+ const handleClick = vi.fn();
+ const user = userEvent.setup();
+
+ render();
+
+ await user.click(screen.getByRole('button'));
+
+ expect(handleClick).not.toHaveBeenCalled();
+ });
+
+ it('deve renderizar diferentes tipos de button', () => {
+ const { rerender } = render();
+ expect(screen.getByRole('button')).toHaveAttribute('type', 'submit');
+
+ rerender();
+ expect(screen.getByRole('button')).toHaveAttribute('type', 'reset');
+ });
+});
+```
+
+### Teste de Hook Customizado
+
+**`src/hooks/useLocalStorage.ts`**
+
+```typescript
+import { useState, useEffect } from 'react';
+
+export function useLocalStorage(key: string, initialValue: T) {
+ const [storedValue, setStoredValue] = useState(() => {
+ try {
+ const item = window.localStorage.getItem(key);
+ return item ? JSON.parse(item) : initialValue;
+ } catch (error) {
+ console.error(error);
+ return initialValue;
+ }
+ });
+
+ const setValue = (value: T | ((val: T) => T)) => {
+ try {
+ const valueToStore = value instanceof Function ? value(storedValue) : value;
+ setStoredValue(valueToStore);
+ window.localStorage.setItem(key, JSON.stringify(valueToStore));
+ } catch (error) {
+ console.error(error);
+ }
+ };
+
+ return [storedValue, setValue] as const;
+}
+```
+
+**`src/hooks/useLocalStorage.test.ts`**
+
+```typescript
+import { describe, it, expect, beforeEach } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import { useLocalStorage } from '@src/hooks/useLocalStorage';
+
+describe('useLocalStorage Hook', () => {
+ beforeEach(() => {
+ localStorage.clear();
+ });
+
+ it('deve retornar o valor inicial quando não há valor armazenado', () => {
+ const { result } = renderHook(() => useLocalStorage('test-key', 'initial'));
+
+ expect(result.current[0]).toBe('initial');
+ });
+
+ it('deve retornar o valor armazenado do localStorage', () => {
+ localStorage.setItem('test-key', JSON.stringify('stored-value'));
+
+ const { result } = renderHook(() => useLocalStorage('test-key', 'initial'));
+
+ expect(result.current[0]).toBe('stored-value');
+ });
+
+ it('deve atualizar o localStorage quando setValue é chamado', () => {
+ const { result } = renderHook(() => useLocalStorage('test-key', 'initial'));
+
+ act(() => {
+ result.current[1]('new-value');
+ });
+
+ expect(result.current[0]).toBe('new-value');
+ expect(localStorage.getItem('test-key')).toBe(JSON.stringify('new-value'));
+ });
+
+ it('deve funcionar com objetos', () => {
+ const initialObject = { name: 'John', age: 30 };
+ const { result } = renderHook(() => useLocalStorage('user', initialObject));
+
+ const newObject = { name: 'Jane', age: 25 };
+
+ act(() => {
+ result.current[1](newObject);
+ });
+
+ expect(result.current[0]).toEqual(newObject);
+ });
+
+ it('deve funcionar com função updater', () => {
+ const { result } = renderHook(() => useLocalStorage('counter', 0));
+
+ act(() => {
+ result.current[1](prev => prev + 1);
+ });
+
+ expect(result.current[0]).toBe(1);
+
+ act(() => {
+ result.current[1](prev => prev + 5);
+ });
+
+ expect(result.current[0]).toBe(6);
+ });
+});
+```
+
+### Teste de Página com API
+
+**`src/pages/Users/Users.tsx`**
+
+```typescript
+import { useState, useEffect } from 'react';
+import { Button } from '@src/components/Button/Button';
+
+interface User {
+ id: number;
+ name: string;
+ email: string;
+}
+
+export function Users() {
+ const [users, setUsers] = useState([]);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState(null);
+
+ useEffect(() => {
+ fetch('/api/users')
+ .then(res => res.json())
+ .then(data => {
+ setUsers(data);
+ setLoading(false);
+ })
+ .catch(err => {
+ setError(err.message);
+ setLoading(false);
+ });
+ }, []);
+
+ if (loading) return Carregando...
;
+ if (error) return Erro: {error}
;
+
+ return (
+
+
Usuários
+
+ {users.map(user => (
+ -
+ {user.name} - {user.email}
+
+ ))}
+
+
+