docs: reorganize agents overview

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

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