# 2026-04-13 - Extração do TemplateClass e migração das métricas de dashboard

## O que mudou
- Removido o uso ativo de `TemplateClass` do layout compartilhado, substituindo breadcrumb, título de página e título da aba por `App\Shared\View\PageChrome`.
- Atualizados os templates de admin e parceiro para usar o renderer novo em `includes/template/head.php`, `includes/template/body-start.php`, `pages/parceiro/includes/template/head.php` e `pages/parceiro/includes/template/body-start.php`.
- Eliminado o carregamento indireto de modais via `TemplateClass->carregarModais(...)` nas páginas admin revisadas, trocando por includes explícitos dos arquivos necessários.
- Convertido `includes/helpers/DashboardHelper.php` em bridge de compatibilidade: ele não executa mais SQL direto e passa a delegar as métricas para o novo serviço PSR.
- Criados `src/Modules/Kpi/DashboardMetricsRepository.php` e `src/Modules/Kpi/DashboardMetricsService.php` para concentrar as consultas de leads, faturas, assinaturas e clientes em código modular.
- Atualizado `src/Http/Controllers/DashController.php` para consumir `DashboardMetricsService` diretamente, removendo a dependência do helper legado no fluxo novo da API.
- Removido o arquivo morto `includes/template/body-start-v1.php`.

## Observações
- Após esta rodada, `TemplateClass` deixou de ser dependência do layout compartilhado e das páginas admin/parceiro que foram revisadas.
- O `DashboardHelper` ainda existe apenas para preservar compatibilidade com dashboards legados que chamam `DashboardHelper::...` diretamente em PHP.
- Os usos diretos remanescentes de `DashboardHelper` estão em `legado/index-v2.php` e `legado/index-profissional.php`; o próximo passo natural é migrar essas telas para AJAX/API e então remover o helper.

## Validação
- `php -l src/Shared/View/PageChrome.php`
- `php -l includes/template/head.php`
- `php -l includes/template/body-start.php`
- `php -l pages/parceiro/includes/template/head.php`
- `php -l pages/parceiro/includes/template/body-start.php`
- `php -l pages/admin/atendimento-profissional.php`
- `php -l pages/admin/centro-usuarios.php`
- `php -l pages/admin/contrato-materiais.php`
- `php -l pages/admin/contrato-site-ativos.php`
- `php -l includes/modais/modalAjudaTela.php`
- `php -l includes/helpers/DashboardHelper.php`
- `php -l src/Modules/Kpi/DashboardMetricsRepository.php`
- `php -l src/Modules/Kpi/DashboardMetricsService.php`
- `php -l src/Http/Controllers/DashController.php`