feat: dispositivos e ajustes de csat e relatórios

docs/desktop/handshake-troubleshooting.md

@@ -1,9 +1,9 @@
-# Desktop (Tauri) — Handshake, Sessão de Máquina e Antivírus
+# Desktop (Tauri) — Handshake, Sessão de Dispositivo e Antivírus
 
 Este documento consolida as orientações e diagnósticos sobre o fluxo do agente desktop, handshake na web e possíveis interferências de antivírus.
 
 ## Sintomas observados
-- Ao clicar em “Registrar máquina”, o antivírus aciona (ex.: ATC.SuspiciousBehavior) e o processo é interrompido.
+- Ao clicar em “Registrar dispositivo”, o antivírus aciona (ex.: ATC.SuspiciousBehavior) e o processo é interrompido.
 - Após o registro, ao abrir a UI web: cabeçalho mostra “Cliente / Sem e‑mail definido” e o Portal não permite abrir chamados.
 - No passado, mesmo quando o app “entrava direto”, o Portal não refletia o colaborador/gestor vinculado (sem assignedUser); receio de repetir o problema.
 
@@ -19,11 +19,11 @@ Este documento consolida as orientações e diagnósticos sobre o fluxo do agent
 ## O que já foi aplicado no projeto
 - Middleware permite `GET /machines/handshake` sem exigir login (rota pública).
 - Frontend preenche `machineContext` chamando `GET /api/machines/session` (assignedUserId/email/nome/persona) e usa esse ID ao abrir chamados.
-- UI oculta “Sair” quando a sessão é de máquina (portal e shell interno).
+- UI oculta “Sair” quando a sessão é de dispositivo (portal e shell interno).
 - DevTools habilitado no desktop (F12, Ctrl+Shift+I ou botão direito com Ctrl/Shift).
 - Desktop salva dados em `C:\\Raven\\data\\machine-agent.json` (ou equivalente ao lado do executável), com fallback para AppData se a pasta do app não permitir escrita.
 
-## Validação rápida (após “Registrar máquina”)
+## Validação rápida (após “Registrar dispositivo”)
 1) No executável, com DevTools:
    ```js
    fetch('/api/machines/session').then(r => r.status).then(console.log)
@@ -33,7 +33,7 @@ Este documento consolida as orientações e diagnósticos sobre o fluxo do agent
    ```
 2) Na UI (Portal/Topo):
    - Mostrar nome/e‑mail do colaborador/gestor (não “Cliente / Sem e‑mail definido”).
-   - Sem botão “Sair” (sessão de máquina).
+   - Sem botão “Sair” (sessão de dispositivo).
 3) No Portal, o formulário “Abrir chamado” deve habilitar normalmente (usa `machineContext.assignedUserId`).
 
 Se `GET /api/machines/session` retornar 403:
@@ -68,4 +68,4 @@ Se `GET /api/machines/session` retornar 403:
 
 ---
 
-Última atualização: automatização do handshake no middleware, ocultação de “Sair” em sessão de máquina, dados persistidos junto ao executável e DevTools habilitado.
+Última atualização: automatização do handshake no middleware, ocultação de “Sair” em sessão de dispositivo, dados persistidos junto ao executável e DevTools habilitado.