Merge pull request #17 from esdrasrenan/feat/convex-tickets-core

docs:update-agents-roadmap
This commit is contained in:
esdrasrenan 2025-10-05 23:08:55 -03:00 committed by GitHub
commit 487edd222f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -44,10 +44,11 @@ Construir o nucleo de tickets compartilhado entre web e desktop (Tauri), garanti
## Backlog imediato ## Backlog imediato
- [x] Expor portal do cliente com listagem de tickets filtrada por `viewerId` (Convex + UI) - [x] Expor portal do cliente com listagem de tickets filtrada por `viewerId` (Convex + UI)
- [x] Completar painel administrativo (times, filas, campos e SLAs) com RBAC server/client - [x] Completar painel administrativo (times, filas, campos e SLAs) com RBAC server/client
- [ ] Consolidar sincronização Better Auth ↔ Convex para fluxo de convites e resets de senha - [ ] Finalizar sincronização Better Auth ↔ Convex para resets de senha e revogações automáticas de convites
- [ ] Expandir suite de testes (UI + Convex) cobrindo guardas, relatórios e mapeadores críticos - [ ] Expandir suite de testes (UI + Convex) cobrindo guardas, relatórios e mapeadores críticos
- [ ] Implementar fluxo completo de convites (criação, envio, revogação e aceite) para administradores - [x] Implementar fluxo completo de convites (criação, envio, revogação e aceite) para administradores
- [ ] Habilitar ações avançadas para agentes (edição de categorias, reassigação rápida) com as devidas permissões - [ ] Habilitar ações avançadas para agentes (edição de categorias, reassigação rápida) com as devidas permissões
- [ ] Integrar campos personalizados e categorias dinâmicas nos formulários de criação/edição de tickets
### Iniciativa atual — Autenticação real e personas ### Iniciativa atual — Autenticação real e personas
- [x] Migrar placeholder para Better Auth + Prisma (handlers Next, cliente React e sync Convex). - [x] Migrar placeholder para Better Auth + Prisma (handlers Next, cliente React e sync Convex).
@ -55,14 +56,15 @@ Construir o nucleo de tickets compartilhado entre web e desktop (Tauri), garanti
- [x] Ajustar middleware e componentes para usar `viewerId`/`actorId`, evitando vazamento de dados entre tenants. - [x] Ajustar middleware e componentes para usar `viewerId`/`actorId`, evitando vazamento de dados entre tenants.
- [x] Criar portal do cliente para abertura/consulta de chamados e comentários públicos. - [x] Criar portal do cliente para abertura/consulta de chamados e comentários públicos.
- [x] Consolidar painel administrativo (times, filas, campos e SLAs) com UI protegida por RBAC completo. - [x] Consolidar painel administrativo (times, filas, campos e SLAs) com UI protegida por RBAC completo.
- [ ] Entregar fluxo de convites Better Auth (criação, envio, revogação) e gerenciamento de agentes. - [x] Entregar fluxo de convites Better Auth (criação, envio, revogação) e gerenciamento de agentes.
- [ ] Unificar ciclo de vida de credenciais (reset de senha, expiração automática e reenvio de convites).
## Proximas entregas sugeridas ## Proximas entregas sugeridas
1. Finalizar onboarding/offboarding de agentes com convites Better Auth, sincronização Convex e trilhas de auditoria. 1. Consolidar onboarding/offboarding de agentes com resets de senha, reenvio automático e auditoria de convites Better Auth.
2. Evoluir painel administrativo com gestão de categorias avançadas e permissões granulares para agentes. 2. Expor categorias, subcategorias e campos personalizados dinamicamente nas telas de criação/edição de tickets (web e desktop).
3. Expandir relatórios operacionais (workSummary, tendências de SLA/CSAT) com alertas e comparativos configuráveis. 3. Definir permissões intermediárias para agentes (edição limitada de categorias/campos) e refletir no Convex.
4. Automatizar pipeline CI (lint + vitest) integrando checagens obrigatórias. 4. Expandir relatórios operacionais (workSummary, métricas por canal/categoria) usando os novos campos personalizados.
5. Revisar UX dos fluxos de atendimento (play next, comentários) com feedback otimista e trilha de auditoria. 5. Automatizar pipeline CI (lint + vitest) integrando checagens obrigatórias antes de merge.
## Acompanhamento ## Acompanhamento
Atualizar este arquivo a cada marco relevante (setup concluido, nucleo funcional, etc.). Atualizar este arquivo a cada marco relevante (setup concluido, nucleo funcional, etc.).
@ -377,3 +379,11 @@ Manter este arquivo atualizado ao concluir cada item estratégico ou quando surg
- Painel administrativo atualizado para consumir as novas assinaturas protegidas, com validações de sessão Better Auth e feedback de toasts. - Painel administrativo atualizado para consumir as novas assinaturas protegidas, com validações de sessão Better Auth e feedback de toasts.
- Dashboard principal passou a exibir métricas reais via `reports.dashboardOverview` e séries históricas por canal com `reports.ticketsByChannel`. - Dashboard principal passou a exibir métricas reais via `reports.dashboardOverview` e séries históricas por canal com `reports.ticketsByChannel`.
- Portal do cliente publicado com isolamento por `viewerId`, garantindo que clientes visualizem apenas seus chamados. - Portal do cliente publicado com isolamento por `viewerId`, garantindo que clientes visualizem apenas seus chamados.
## Atualizações recentes (ago/2026)
- Convites Better Auth finalizados ponta a ponta: novos modelos Prisma, utilitários de servidor, rotas Next e tabela `userInvites` no Convex com sincronização e RBAC.
- Painel administrativo reorganizado com `CategoriesManager`, permitindo CRUD completo de categorias e subcategorias, inclusive cadastro em lote na criação.
- Campos personalizados de tickets agora são validados e persistidos no Convex (`tickets.customFields`) com normalização por tipo, `displayValue` e mapeamento seguro no frontend.
- Consultas e componentes que consomem `queues.summary` passaram a enviar `viewerId`, eliminando erros de autorização na UI de tickets.
- Suite de testes estendida com `invite-utils.test.ts` e configuração `vitest.setup.ts`, garantindo ambiente consistente com variáveis Better Auth.