feat(filters): ticket company filter + column; reports: company filter in CSVs; dashboard: queue summary; docs: agents.md and roadmap updates

agents.md

@@ -35,12 +35,20 @@
 9. Inicie o backend Convex em um terminal (`pnpm convex:dev`) e, em outro, suba a aplicação Next.js (`pnpm dev`).
 10. Acesse `http://localhost:3000` e teste login com os usuários padrão listados acima antes de continuar o desenvolvimento.
 
-## Estado atual
-- Autenticação Better Auth com guardas client-side (`AuthGuard`) bloqueando rotas protegidas.
-- Menu de usuário no rodapé da sidebar com link para `/settings` e logout confiável.
-- Formulários de novo ticket (dialog, página e portal) com seleção de responsável, placeholders claros e validação obrigatória de assunto/descrição/categorias.
-- Portal do cliente restringe visualização e criação ao próprio requester; clientes não atribuem responsáveis.
-- Relatórios e dashboards utilizam `AppShell`, garantindo header/sidebar consistentes.
+## Estado atual
+- Autenticação Better Auth com guardas client-side (`AuthGuard`) bloqueando rotas protegidas.
+- Menu de usuário no rodapé da sidebar com link para `/settings` e logout confiável.
+- Formulários de novo ticket (dialog, página e portal) com seleção de responsável, placeholders claros e validação obrigatória de assunto/descrição/categorias.
+- Relatórios e dashboards utilizam `AppShell`, garantindo header/sidebar consistentes.
+
+## Entregas recentes
+- Exportações CSV (Backlog, Canais, CSAT, SLA e Horas por cliente) com parâmetros de período.
+- PDF do ticket (via pdfkit standalone), com espaçamento e traduções PT-BR.
+- Play interno/externo com somatório por tipo por ticket e relatório por cliente.
+- Admin > Empresas & clientes: cadastro/edição, `Cliente avulso?` e `Horas contratadas/mês`.
+- Admin > Usuários: vincular colaborador à empresa.
+- Dashboard: cards de filas (Chamados/Laboratório/Visitas) e indicadores principais.
+- Lista de tickets: filtro por Empresa, coluna Empresa, alinhamento vertical e melhor espaçamento entre colunas.
 
 ## Entregas recentes relevantes
 - Correção do redirecionamento após logout evitando retorno imediato ao dashboard.
@@ -56,16 +64,22 @@
 - Abrir novos tickets diretamente a partir do detalhe via dialog reutilizável.
 - Acessar `/settings` para ajustes pessoais e efetuar logout pelo menu.
 
-### Clientes
-- Autenticam com `cliente.demo@sistema.dev`.
-- Abrem tickets para si mesmos a partir do portal com assunto/descrição obrigatórios.
-- Não visualizam campo de responsável nem tickets de outros usuários.
+### Papéis
+- Papéis válidos: `admin`, `manager`, `agent`, `collaborator` (papel `customer` removido).
+- Gestores veem os tickets da própria empresa e só podem registrar comentários públicos.
 
-## Próximos passos sugeridos
-1. Finalizar redefinição de senha/auditoria de convites Better Auth.
-2. Expandir cobertura de testes (`vitest`) para guardas de autenticação e criação de tickets.
-3. Implementar ações rápidas (status/fila) diretamente na listagem de tickets.
-4. Definir limites e monitoramento para anexos por tenant.
+## Próximos passos sugeridos
+1. Disparo de e-mails automáticos quando uso de horas ≥ 90% do contratado.
+2. Ações rápidas (status/fila) diretamente na listagem de tickets.
+3. Limites e monitoramento para anexos por tenant.
+4. PDF do ticket com layout idêntico ao app (logo/cores/fontes).
+
+## Referências de endpoints úteis
+- Backlog CSV: `/api/reports/backlog.csv?range=7d|30d|90d[&companyId=...]`
+- Canais CSV: `/api/reports/tickets-by-channel.csv?range=7d|30d|90d[&companyId=...]`
+- CSAT CSV: `/api/reports/csat.csv?range=7d|30d|90d`
+- SLA CSV: `/api/reports/sla.csv`
+- Horas por cliente CSV: `/api/reports/hours-by-client.csv?range=7d|30d|90d`
 
 ## Rotina antes de abrir PR
 - `pnpm lint`