# 2026-04-13 - Migração do DashController para serviço PSR

## O que mudou
- Criados `src/Modules/Kpi/DashboardMetricsRepository.php` e `src/Modules/Kpi/DashboardMetricsService.php` para centralizar as métricas de leads, faturas, assinaturas e clientes no módulo `Kpi`.
- Atualizado `src/Http/Controllers/DashController.php` para consumir `DashboardMetricsService` diretamente no endpoint `/adm/api/Dash/overview` e no gráfico `leads_status`.
- Removida a dependência do `DashController` em `DashboardHelper` e eliminada a bridge interna `safeCall(...)`.
- Convertido `includes/helpers/DashboardHelper.php` em compatibilidade temporária para as telas legadas, delegando as consultas ao novo serviço PSR em vez de executar SQL próprio.

## Observações
- O backend novo do dashboard passou a ficar concentrado em `src`, enquanto o helper antigo sobrevive só como casca de compatibilidade.
- Os únicos usos diretos remanescentes de `DashboardHelper::...` continuam em `legado/index-v2.php` e `legado/index-profissional.php`.
- O endpoint `faturas_mes` em `DashController` continua com série stub temporária; a próxima etapa natural é extrair essa série mensal para o serviço também.

## Validação
- `php -l src/Modules/Kpi/DashboardMetricsRepository.php`
- `php -l src/Modules/Kpi/DashboardMetricsService.php`
- `php -l src/Http/Controllers/DashController.php`
- `php -l includes/helpers/DashboardHelper.php`