diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md
index e804d4e..7a72fdc 100644
--- a/docs/OPERATIONS.md
+++ b/docs/OPERATIONS.md
@@ -174,6 +174,17 @@ Resumo das mudanças aplicadas no painel administrativo para simplificar “Usu
 - Novo e‑mail como nova conta: se criar um usuário novo (novo `userId`), será considerado um colaborador distinto e não herdará o histórico.
 - Caso precise migrar histórico entre contas diferentes (merge), recomendamos endpoint/rotina de “fusão de contas” (remapear `userId` antigo → novo). Não é necessário para a troca de e‑mail da mesma conta.
 
+### Vínculos múltiplos de usuários por máquina (Fase 2)
+
+- Estrutura (Convex):
+  - `machines.linkedUserIds: Id<"users">[]` — lista de vínculos adicionais além do `assignedUserId` (principal).
+  - Mutations: `machines.linkUser(machineId, email)`, `machines.unlinkUser(machineId, userId)`.
+  - APIs admin: `POST /api/admin/machines/links` (body: `{ machineId, email }`), `DELETE /api/admin/machines/links?machineId=..&userId=..`.
+- UI:
+  - Detalhes da máquina mostram “Usuários vinculados” com remoção por item e campo para adicionar por e‑mail.
+  - Editor de usuário mostra “Máquinas vinculadas” consolidando assignment, metadata e `linkedUserIds`.
+- Racional: permitir que uma máquina tenha mais de um colaborador/gestor associado, mantendo um “principal” (persona) para políticas e contexto.
+
 ### Onde editar
 
 - Usuários (pessoas): editar nome, e‑mail, papel, tenant e empresa; redefinir senha pelo painel. Arquivo: `src/components/admin/admin-users-manager.tsx`.