feat: add agent reset flow and document machine handover

docs/OPERATIONS.md

@@ -58,6 +58,29 @@ Este documento consolida as mudanças recentes, o racional por trás delas e o p
       - “Acquire Convex admin key” (via container `sistema_convex_backend`).
       - “Bring convex.json from live app if present” (usa o arquivo de link do projeto em `/srv/apps/sistema`).
       - “convex env list” e “convex deploy” com `CONVEX_SELF_HOSTED_URL` + `CONVEX_SELF_HOSTED_ADMIN_KEY`.
+
+## 4) Troca de colaborador / reaproveitamento de máquina
+
+Quando um computador muda de dono (ex.: João entrega o equipamento antigo para Maria e recebe uma máquina nova), siga este checklist para manter o inventário consistente:
+
+1. **No painel (Admin → Máquinas)**
+   - Abra os detalhes da máquina que será reaproveitada (ex.: a “amarela” que passará da TI/João para a Maria).
+   - Clique em **Resetar agente**. Isso revoga todos os tokens gerados para aquele equipamento; ele precisará ser reprovisionado antes de voltar a reportar dados.
+   - Abra **Ajustar acesso** e altere o e-mail para o do novo usuário (Maria). Assim, quando o agente se registrar novamente, o painel já mostrará a responsável correta.
+
+2. **Na máquina física que ficará com o novo colaborador**
+   - Desinstale o desktop agent (Painel de Controle → remover programas).
+   - Instale novamente o desktop agent. Use o mesmo **código da empresa/tenant** e informe o **e-mail do novo usuário** (Maria). O backend emite um token novo e reaproveita o registro da máquina, mantendo o histórico.
+
+3. **Máquina nova para o colaborador antigo**
+   - Instale o desktop agent do zero na máquina que o João vai usar (ex.: a “azul”). Utilize o mesmo código da empresa e o e-mail do João.
+   - A máquina azul aparecerá como um **novo registro** no painel (inventário/tickets começarão do zero). Renomeie/associe conforme necessário.
+
+4. **Verificação final**
+   - A máquina antiga (amarela) continua listada, agora vinculada à Maria, com seus tickets históricos.
+   - A máquina nova (azul) aparece como um segundo registro para o João. Ajuste hostname/descrição para facilitar a identificação.
+
+> Não é necessário excluir registros. Cada máquina mantém seu histórico; o reset garante apenas que o token antigo não volte a sobrescrever dados quando o hardware mudar de mãos.
     - Importante: não usar `CONVEX_DEPLOYMENT` em conjunto com URL + ADMIN_KEY.
 
 - Como forçar o deploy do Convex