Entrega v1 aula: shell com abas, PITIUPI_HOME e plugins de referência.

Consolida núcleo (presença, peer actions, MessageDispatcher), chat e screencast na galeria, documentação PT-BR e testes JUnit; remove mpChat do catálogo em favor do chat unificado.

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

docs/documentation/12_menus_unicast_multicast.md

@@ -1,35 +1,34 @@
-# Menus — unicast e multicast
+# Menus, peer actions e transportes
 
-## MenuCategory
+## Interface atual (shell v1)
 
-Enum em `pitiupi.models.Menus.MenuCategory`:
+Plugins de referência **não** dependem da barra de menus superior para o fluxo principal:
 
-| Valor | Uso sugerido |
-| --- | --- |
-| `Jogos` | Plugins de jogos entre peers |
-| `Social` | Chat, presença, mensagens sociais |
-| `Streaming` | Screen cast, mídia |
+- **Galeria** na aba **Plugins** abre cada extensão em aba própria (fechável com ×).
+- **Peer actions** na lista **Usuários nesta rede** (clique em um peer ou em **Todos**) agrupam ações de todos os plugins instalados.
+- Dentro da aba do plugin, **`PluginRoutingPanel`** padroniza destino (sala geral vs IP), forma de envio (multicast UDP, UDP unicast, TCP) e texto de ajuda.
 
-## Registrar menu (padrão atual)
+Ver [04_inicializacao_e_gui.md](04_inicializacao_e_gui.md) e [09_sistema_de_plugins.md](09_sistema_de_plugins.md).
 
-Via `GuiManager.createMenu(MenuCategory category, Menu menu)` — ver `ChatPlugin`:
+## MenuCategory (legado)
 
-```java
-guiManager.createMenu(MenuCategory.Social, new ChatMenu(chatWindow));
-```
+Enum em `pitiupi.models.Menus.MenuCategory` (`Jogos`, `Social`, `Streaming`) ainda aparece no **catálogo** (`menuCategory` em `plugins.registry.json`) e em plugins antigos que chamam `GuiManager.createMenu(...)`.
 
-A hierarquia de menus unicast/multicast do núcleo (`UnicastMenu`, `MulticastMenu`, etc.) permite ações por peer ou broadcast; plugins de referência encapsulam isso em classes `*Menu` próprias.
+Novos plugins devem preferir `PluginWorkspace` + peer actions. O menu da shell expõe apenas **Ajuda → Sobre**.
 
 ## Unicast vs multicast na aplicação
 
 | Modo | API típica | Semântica |
 | --- | --- | --- |
-| Multicast | `ConnectionManager` → `SocketUDP.sendMulticast` | Todos no grupo na porta configurada |
+| Multicast | `MessageDispatcher` / `SocketUDP.sendMulticast` | Todos no grupo na porta configurada |
 | Unicast UDP | envio para IP de um peer | Um destinatário, sem estabelecer TCP |
-| TCP | `ConnectionManager` / `SocketTCP` | Canal persistente, framing 4+N bytes |
+| TCP | `ConnectionManager` / `SocketTCP` | Canal com framing 4+N bytes |
 
 Detalhes de rede: [05_udp_multicast.md](05_udp_multicast.md), [06_tcp_conexoes.md](06_tcp_conexoes.md).
 
-## mpChat
+## Referência de código
 
-`MulticastMpChatMenu` e `UnicastMpChatMenu` mostram como expor as duas modalidades no mesmo plugin — [11_plugins_referencia.md](11_plugins_referencia.md).
+- Chat e screencast: peer actions em `ChatPlugin` e `ScreenCastPlugin`.
+- Envio unificado: `pitiupi.application.messaging.MessageDispatcher` e `TransportMode`.
+
+O antigo plugin **mpChat** foi unificado no módulo `plugins/chat` (mensagens `LegacyMpChatMessage` para compatibilidade TCP privado). Ver [11_plugins_referencia.md](11_plugins_referencia.md) e decisão D19 no [decision-register.md](../decision-register.md).