From 619fb949a7c750467128469b12c9ebfa7b5cdd05 Mon Sep 17 00:00:00 2001
From: Rafael Alves Lopes <rafael.lopes@sothis.com.br>
Date: Wed, 27 May 2026 16:40:06 -0300
Subject: [PATCH] Adicionar Agent

---
 Agent.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 Agent.md

diff --git a/Agent.md b/Agent.md
new file mode 100644
index 0000000..423191b
--- /dev/null
+++ b/Agent.md
@@ -0,0 +1,57 @@
+# Modulo Agente
+
+O backend do agente esta dentro de `src/modules/admin`, dividido em presenca e notas.
+
+## Presenca do agente
+
+Arquivos:
+
+- `agent-presence.controller.ts`
+- `agent-presence.service.ts`
+
+Prefixo:
+
+```txt
+/agent/presence
+```
+
+### Endpoints
+
+| Metodo | Rota | Descricao |
+|---|---|---|
+| GET | `/agent/presence` | Lista presenca dos agentes |
+| GET | `/agent/presence/me?userId=` | Retorna presenca de um agente |
+| POST | `/agent/presence/pause` | Marca agente como pausado |
+| POST | `/agent/presence/resume` | Retoma agente |
+| POST | `/agent/presence/offline` | Marca agente como offline |
+
+### Regras
+
+- Pausar move atendimentos do agente para fila e cria reserva temporaria.
+- Retomar tenta recuperar atendimentos reservados ainda livres.
+- Offline remove reserva e evita atribuicao direta.
+
+## Notas do agente
+
+Arquivos:
+
+- `agent-notes.controller.ts`
+- `agent-notes.service.ts`
+
+Prefixo:
+
+```txt
+/agent/notes
+```
+
+### Endpoints
+
+| Metodo | Rota | Descricao |
+|---|---|---|
+| GET | `/agent/notes?userId=` | Lista notas do agente |
+| POST | `/agent/notes` | Cria nota |
+| DELETE | `/agent/notes/:id?userId=` | Remove nota |
+
+## Code review
+
+Hoje `userId` vem por query/body. Em producao, deve sair do JWT validado no backend.