docs: refinamento integral da documentação didática

Índices por jornada, convenções, diagramas Mermaid, correções de
arquitetura (MainShellFrame, TCP/PluginManager), tutoriais com
verificações e troubleshooting; remove redirect pitiupi/docs.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/documentation/08_heartbeat_e_presenca.md

@@ -1,4 +1,6 @@
-# Heartbeat
+# Heartbeat e presença
+
+**Presença ≠ conexão TCP:** ver um peer na lista lateral significa que heartbeats UDP recentes foram recebidos; ainda assim o primeiro envio TCP pode abrir um novo socket.
 
 ### Heartbeat
 
@@ -60,3 +62,24 @@ Lista de peers ativos
 | 
 +----> Plugins (PeerListener)
 ```
+
+### Parâmetros práticos
+
+| Item | Valor no núcleo | Efeito na sala |
+| --- | --- | --- |
+| Grupo multicast | `224.0.0.3` | Todos na mesma porta participam |
+| Intervalo de envio | ~5 s | Lista atualiza em alguns segundos |
+| Timeout de ausência | ~15 s | Peer some após queda ou fechamento sem goodbye |
+| Goodbye | multicast ao sair | Remove peer mais rápido que só timeout |
+
+Em **Wi‑Fi de laboratório**, heartbeat usa o mesmo multicast que o chat na sala geral — mesma porta no login, mesma sub-rede, sem isolamento AP→AP. Checklist: [appendix_portas_e_multicast.md](appendix_portas_e_multicast.md).
+
+```mermaid
+flowchart LR
+    HM[HeartbeatManager] -->|HeartbeatMessage| UDP[SocketUDP multicast]
+    UDP --> LAN[LAN]
+    LAN --> UDP2[SocketUDP outro peer]
+    UDP2 --> HM2[HeartbeatManager]
+    HM2 --> PS[PresenceService]
+    PS --> UI[NetworkUsersPanel]
+```