From 5d9cfde1d25240d93dc16f64a5762662c867a568 Mon Sep 17 00:00:00 2001 From: rever-tecnologia Date: Mon, 6 Oct 2025 10:28:46 -0300 Subject: [PATCH] docs: reorganize agents overview Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> --- agents.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/agents.md b/agents.md index 5bed7d3..81c27dd 100644 --- a/agents.md +++ b/agents.md @@ -1,3 +1,59 @@ +# Plano de Desenvolvimento — Sistema de Chamados + +## Contato principal +- **Esdras Renan** — monkeyesdras@gmail.com + +## Ambiente local +- Admin: `admin@sistema.dev` / `admin123` +- Agentes seed (senha inicial `agent123` — alterar no primeiro acesso): + - Gabriel Oliveira · george.araujo@rever.com.br + - George Araujo · george.araujo@rever.com.br + - Hugo Soares · hugo.soares@rever.com.br + - Julio Cesar · julio@rever.com.br + - Lorena Magalhães · lorena@rever.com.br + - Rever · renan.pac@paulicon.com.br + - Telão · suporte@rever.com.br + - Thiago Medeiros · thiago.medeiros@rever.com.br + - Weslei Magalhães · weslei@rever.com.br + +> Todos os usuários estão sincronizados com o Convex via `scripts/seed-agents.mjs`. + +## Visão geral atual +- **Meta imediata:** consolidar o núcleo de tickets web/desktop com canais, SLAs e automações futuras. +- **Stack:** Next.js (App Router) + Convex + Better Auth + Prisma (referência de domínio). +- **Estado:** núcleo web funcional (tickets, play mode, painéis administrativos, portal do cliente) com Turbopack habilitado no `pnpm dev`. + +## Entregas concluídas +- Scaffold Next.js + Tailwind + shadcn/ui, shell com sidebar/header, login real com Better Auth. +- Integração Convex completa: listas/detalhe de tickets, mutations (status, categorias, filas, comentários, play next). +- Painel administrativo: gestão de filas, times, campos personalizados e convites Better Auth. +- Portal do cliente isolado por `viewerId`; dashboard principal consumindo métricas reais do Convex. +- Fluxo de convites Better Auth ponta a ponta + seed automatizado de agentes/admin. + +## Desenvolvimento em curso +- Refinar sincronização Better Auth ↔ Convex (resets de senha, revogação automática de convites). +- Melhorar UX do ticket header (categorias, status, prioridades) e comandos rápidos na listagem. +- Manter hidratação consistente na sidebar e componentes Radix após migração para React 19. + +## Próximas prioridades +1. Expandir suíte de testes (UI + Convex) e habilitar pipeline CI obrigatória (lint + vitest). +2. Implementar resets de senha automatizados e auditoria de convites para onboarding/offboarding. +3. Expor categorias/subcategorias dinâmicas na criação/edição de tickets (web e desktop). +4. Adicionar ações avançadas para agentes (edição de categorias, reassignment rápido) sob RBAC. + +## Boas práticas e rotinas +- **Seeds:** `node --env-file=.env.local scripts/seed-agents.mjs` (mantém admin e agentes) + `/dev/seed` para dados demo. +- **Serviços locais:** `pnpm convex:dev` (gera tipos e roda backend) e `pnpm dev` (Next.js com Turbopack). +- **Testes e lint:** execute `pnpm lint` e `pnpm vitest run` antes de cada PR. +- **Convex:** retorne apenas tipos suportados (`number` para datas) e valide no front via mappers Zod. +- **UI:** textos PT‑BR, toasts com feedback, atualizações otimistas com rollback em caso de erro. +- **Git/PR:** branches descritivas, checklist padrão (tipos Convex, labels PT‑BR, loaders, mappers atualizados) e coautor `factory-droid[bot]` quando aplicável. + +## Histórico de marcos +- Fase A (scaffold/UX base) e Fase B (núcleo de tickets) concluídas. +- Iniciativa “Autenticação real e personas” entregue com RBAC completo e portal do cliente. +- Roadmap imediato focado em credenciais unificadas, automações de convites e cobertura de testes. + # Plano de Desenvolvimento - Sistema de Chamados ## Meta imediata