From 81c37225fac91d24e8651da729d0282cc09af6a2 Mon Sep 17 00:00:00 2001
From: GustavoHMDS <gusttavoh2602@gmail.com>
Date: Tue, 11 Aug 2026 14:35:51 -0300
Subject: [PATCH] atualizando o arquivo documentation.md

---
 .idea/workspace.xml           |  7 +------
 pitiupi/docs/Documentation.md | 16 +++++++++++-----
 2 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index e7c6da3..fa1cc34 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -4,12 +4,7 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="62118a1b-608f-4144-b29c-cf46419ca676" name="Changes" comment="">
-      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/pitiupi/src/pitiupi/GUI/MenuBar.java" beforeDir="false" afterPath="$PROJECT_DIR$/pitiupi/src/pitiupi/GUI/MenuBar.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/pitiupi/src/pitiupi/control/HeartbeatManager.java" beforeDir="false" afterPath="$PROJECT_DIR$/pitiupi/src/pitiupi/control/HeartbeatManager.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/pitiupi/src/pitiupi/net/Socket.java" beforeDir="false" afterPath="$PROJECT_DIR$/pitiupi/src/pitiupi/net/Socket.java" afterDir="false" />
-    </list>
+    <list default="true" id="62118a1b-608f-4144-b29c-cf46419ca676" name="Changes" comment="" />
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
diff --git a/pitiupi/docs/Documentation.md b/pitiupi/docs/Documentation.md
index 68d9697..2b9fee1 100644
--- a/pitiupi/docs/Documentation.md
+++ b/pitiupi/docs/Documentation.md
@@ -60,7 +60,7 @@ O método `send()` recebe uma mensagem já serializada em bytes e cria um
 
 De forma geral, o socket atua apenas como mecanismo de transporte das mensagens. 
 A única exceção é o tratamento de HeartbeatMessage, utilizado pela infraestrutura
-da aplicação para manter a lista de usuários ativos.
+da aplicação para manter a lista de peers ativos.
 
 #### Recepção de mensagens
 
@@ -98,9 +98,15 @@ comportamentos necessários para cada funcionalidade.
 O mecanismo de heartbeat é utilizado para identificar quais usuários estão
 ativos na rede.
 
-A aplicação envia periodicamente uma `HeartbeatMessage` contendo informações
-do usuário e um timestamp. Quando outra instância recebe essa mensagem, o
-`HeartbeatManager` atualiza o registro do usuário correspondente.
+A aplicação envia periodicamente uma `HeartbeatMessage` contendo
+informações do usuário, um identificador único da instância da aplicação
+e um timestamp. Quando outra instância recebe essa mensagem, o `HeartbeatManager`
+registra ou atualiza o peer correspondente, utilizando o identificador
+da instância para diferenciá-lo das demais.
+
+Um peer é considerado inativo quando permanece mais de 15 segundos
+sem receber um novo heartbeat. O `HeartbeatManager` então remove o peer
+da lista e notifica os listeners sobre a alteração.
 
 O fluxo de heartbeat é independente das mensagens dos plugins:
 
@@ -109,7 +115,7 @@ O fluxo de heartbeat é independente das mensagens dos plugins:
 3. O `Socket` transmite a mensagem pela rede multicast.
 4. O `Socket` identifica mensagens de heartbeat recebidas e encaminha ao
    `HeartbeatManager`.
-5. O `HeartbeatManager` atualiza a lista de usuários ativos e notifica os
+5. O `HeartbeatManager` atualiza a lista de peers ativos e notifica os
    listeners.
 
 ## Sistema de plugins