From f6b2cf3ecd6fa0be86955dfaecb409fb7b362b5e Mon Sep 17 00:00:00 2001 From: Gabriel Felipe Souza Santos Date: Tue, 27 Oct 2026 15:59:45 -0300 Subject: [PATCH] =?UTF-8?q?docs:=20registrar=20D22=20PeerIpv4=20e=20link?= =?UTF-8?q?=20tutorial=20Ping=20no=20=C3=ADndice?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Documenta normalização de IP de peer no Windows; apêndice multicast atualizado. Co-authored-by: Cursor --- docs/README.md | 2 +- docs/decision-register.md | 1 + docs/documentation/appendix_portas_e_multicast.md | 4 ++++ 3 files changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/README.md b/docs/README.md index d5f2fbf..960a3ba 100644 --- a/docs/README.md +++ b/docs/README.md @@ -14,7 +14,7 @@ Entrada na raiz do repositório: [README.md](../README.md). | Leitor | Começar por | | --- | --- | -| **Aluno (TP)** | [documentation/00_quickstart.md](documentation/00_quickstart.md) → [10_tutorial_plugin.md](documentation/10_tutorial_plugin.md) → [11_plugins_referencia.md](documentation/11_plugins_referencia.md) | +| **Aluno (TP)** | [documentation/00_quickstart.md](documentation/00_quickstart.md) → [10_tutorial_plugin.md](documentation/10_tutorial_plugin.md) → [17_tutorial_ping_aula.md](documentation/17_tutorial_ping_aula.md) → [11_plugins_referencia.md](documentation/11_plugins_referencia.md) | | **Monitor / docência** | [documentation/01_visao_disciplina_e_tp.md](documentation/01_visao_disciplina_e_tp.md) → [15_testes_e_gate.md](documentation/15_testes_e_gate.md) | | **Desenvolvedor** | [documentation/13_guia_dev_e_agente.md](documentation/13_guia_dev_e_agente.md) → [14_arquitetura_e_manutencao.md](documentation/14_arquitetura_e_manutencao.md) | | **Professor / banca** | [documentation/16_fundamentacao_redes.md](documentation/16_fundamentacao_redes.md) → [references/README.md](references/README.md) | diff --git a/docs/decision-register.md b/docs/decision-register.md index c17f29c..9e46771 100644 --- a/docs/decision-register.md +++ b/docs/decision-register.md @@ -19,5 +19,6 @@ | D19 | Chat unificado | Um JAR `plugins/chat` com sala geral, peer/IP e TCP privado; mpChat removido do catálogo | [11_plugins_referencia.md](documentation/11_plugins_referencia.md) | | D20 | Peer actions por plugin no popup | Lista lateral agrupa ações de todos os plugins (submenus), não só a aba ativa | [09_sistema_de_plugins.md](documentation/09_sistema_de_plugins.md) | | D21 | `onShellTabClosed` | Fechar aba do plugin na shell notifica o plugin (ex.: parar screencast) | [09_sistema_de_plugins.md](documentation/09_sistema_de_plugins.md) | +| D22 | `PeerIpv4` para IP de peer na UI | No Windows, `InetAddress.getHostAddress()` pode devolver IPv6-mapeado e sufixo de zona (`%n`); chat e roteamento usam IPv4 pontilhado | [appendix_portas_e_multicast.md](documentation/appendix_portas_e_multicast.md) | Novas decisões: adicionar linha nesta tabela e detalhar no arquivo técnico correspondente. diff --git a/docs/documentation/appendix_portas_e_multicast.md b/docs/documentation/appendix_portas_e_multicast.md index 2be7e1c..1c61e53 100644 --- a/docs/documentation/appendix_portas_e_multicast.md +++ b/docs/documentation/appendix_portas_e_multicast.md @@ -33,6 +33,10 @@ Executar o Pitiupi no WSL e peers no Windows (ou vice-versa) pode falhar em mult O núcleo associa o socket multicast à interface de rede preferida: **cabo (Ethernet) antes de Wi‑Fi**; em cabo com link-local APIPA, prioriza IPv4 **`169.254.*`**. Isso não substitui a exigência de **mesma sub-rede** entre os dois PCs — `169.254.x` e `192.168.x` ao mesmo tempo em hosts diferentes não compartilham heartbeat. +## IP do peer na UI (Windows) + +Ao abrir conversa pela lista de presença, o campo de destino usa **`PeerIpv4`**: IPv4 pontilhado legível, sem forma IPv6-mapeada (`::ffff:…`) nem sufixo de zona (`%7`). Ver [decision-register.md](../decision-register.md) (D22). + ## Checklist — dois PCs na mesma Wi‑Fi 1. **Mesma porta no login** (ex.: `5000` nos dois). Portas diferentes isolam a sala.