feat: add agent reset flow and document machine handover

README.md

@@ -1,11 +1,11 @@
 ## Sistema de Chamados
 
-Aplicação Next.js 15 com Convex e Better Auth para gestão de tickets da Rever. Todo o código-fonte está organizado diretamente na raiz do repositório, conforme convenções do Next.js.
+Aplicação **Next.js 16 (App Router)** com **React 19**, **Convex** e **Better Auth** para gestão de tickets da Rever. A stack ainda inclui **Prisma 6** (SQLite padrão para DEV), **Tailwind** e **Turbopack** como bundler padrão. Todo o código-fonte fica na raiz do monorepo seguindo as convenções do App Router.
 
 ## Requisitos
 
 - Node.js >= 20
-- pnpm >= 8
+- pnpm >= 9 (habilite via `corepack prepare pnpm@9 --activate`)
 - CLI do Convex (`pnpm dlx convex dev` instalará automaticamente no primeiro uso)
 
 ## Configuração rápida
@@ -34,7 +34,7 @@ Aplicação Next.js 15 com Convex e Better Auth para gestão de tickets da Rever
    ```bash
    pnpm convex:dev
    ```
-7. Em outro terminal, suba o frontend Next.js:
+7. Em outro terminal, suba o frontend Next.js (Turbopack):
    ```bash
    pnpm dev
    ```
@@ -44,7 +44,7 @@ Aplicação Next.js 15 com Convex e Better Auth para gestão de tickets da Rever
 
 ### Documentação
 - Índice de docs: `docs/README.md`
-- Operações (produção): `docs/operations.md`
+- Operações (produção): `docs/OPERATIONS.md` (versão EN) e `docs/OPERACAO-PRODUCAO.md` (PT-BR)
 - Guia de DEV: `docs/DEV.md`
 - Testes automatizados (Vitest/Playwright): `docs/testes-vitest.md`
 - Stack Swarm: `stack.yml` (roteado por Traefik, rede `traefik_public`).
@@ -62,11 +62,22 @@ Para fluxos detalhados de desenvolvimento — banco de dados local (SQLite/Prism
 ## Scripts úteis
 
 - `pnpm lint` — ESLint com as regras do projeto.
-- `pnpm exec vitest run` — suíte de testes unitários.
+- `pnpm test` — suíte de testes unitários (Vitest) em modo não interativo.
+- `pnpm build` — `next build --turbopack` com otimizações para produção.
 - `pnpm auth:seed` — atualiza/cria contas padrão do Better Auth (credenciais em `agents.md`).
 - `pnpm prisma migrate deploy` — aplica migrações ao banco SQLite local.
 - `pnpm convex:dev` — roda o Convex em modo desenvolvimento, gerando tipos em `convex/_generated`.
 
+## Transferir máquina entre colaboradores
+
+Quando uma máquina trocar de responsável:
+
+1. Abra `Admin > Máquinas`, selecione o equipamento e clique em **Resetar agente**.
+2. No equipamento, execute o reset local do agente (`rever-agent reset` ou reinstale o serviço) e reprovisione com o código da empresa.
+3. Após o agente gerar um novo token, associe a máquina ao novo colaborador no painel.
+
+Sem o reset de agente, o Convex reaproveita o token anterior e o inventário continua vinculado ao usuário antigo.
+
 ## Estrutura principal
 
 - `app/` dentro de `src/` — rotas e layouts do Next.js (App Router).