Consolida documentação e plugins de referência ao núcleo atual.

Alinha mpChat e screenCast a ConnectionManager/GuiManager, adiciona docs em docs/ e README de plugins; remove artefatos de build do índice.

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

docs/references/README.md

@@ -0,0 +1,18 @@
+# Referências — Pitiupi
+
+Bibliografia e notas curtas para apoiar a disciplina de Redes de Computadores.
+
+| Recurso | Descrição |
+| --- | --- |
+| [bibliografia.bib](bibliografia.bib) | Entradas BibTeX (livro-texto, RFCs, documentação Java) |
+| [notas/](notas/) | Resumos em PT-BR ligados ao código |
+| [pdfs/](pdfs/) | PDFs locais (não versionados se grandes; ver `.gitkeep`) |
+
+## Notas disponíveis
+
+- [udp_vs_tcp.md](notas/udp_vs_tcp.md)
+- [multicast_lan.md](notas/multicast_lan.md)
+- [java_serializacao.md](notas/java_serializacao.md)
+- [java_spi_plugins.md](notas/java_spi_plugins.md)
+
+Voltar ao índice: [docs/README.md](../README.md).

docs/references/bibliografia.bib

@@ -0,0 +1,24 @@
+@book{tanenbaum2011,
+  title     = {Computer Networks},
+  author    = {Tanenbaum, Andrew S. and Wetherall, David J.},
+  edition   = {5},
+  year      = {2011},
+  publisher = {Prentice Hall},
+  note      = {UDP, TCP, multicast — conceitos gerais}
+}
+
+@misc{rfc1112,
+  title        = {Host Extensions for IP Multicasting},
+  author       = {Deering, S.},
+  howpublished = {RFC 1112},
+  year         = {1989},
+  url          = {https://www.rfc-editor.org/rfc/rfc1112}
+}
+
+@book{oracle_networking,
+  title     = {Java Platform, Standard Edition Documentation: Networking},
+  author    = {{Oracle}},
+  year      = {2024},
+  url       = {https://docs.oracle.com/en/java/javase/},
+  note      = {MulticastSocket, Socket, serialization}
+}

docs/references/notas/java_serializacao.md

@@ -0,0 +1,11 @@
+# Serialização Java (nota)
+
+O Pitiupi serializa objetos `Message` (Java `Serializable`) para `byte[]` antes do envio.
+
+Implicações:
+
+- Mesma versão de classe nos peers (mesmo JAR de plugin).
+- `serialVersionUID` explícito evita incompatibilidade silenciosa.
+- Desserialização no núcleo usa `PluginObjectInputStream` com classloader do plugin.
+
+Doc: [07_mensagens_e_serializacao.md](../../documentation/07_mensagens_e_serializacao.md).

docs/references/notas/java_spi_plugins.md

@@ -0,0 +1,9 @@
+# Java SPI — plugins (nota)
+
+O núcleo usa `ServiceLoader` para localizar implementações de `pitiupi.models.Plugin` declaradas em:
+
+`META-INF/services/pitiupi.models.Plugin`
+
+Uma linha por classe concreta (FQCN). O JAR deve estar em `pitiupi/plugins/`.
+
+Doc: [09_sistema_de_plugins.md](../../documentation/09_sistema_de_plugins.md).

docs/references/notas/multicast_lan.md

@@ -0,0 +1,12 @@
+# Multicast em LAN (nota)
+
+IP multicast envia um datagrama que roteadores/switches encaminham aos assinantes do grupo (ex.: `224.0.0.3`).
+
+Na sala de aula:
+
+- Todos os peers devem estar na mesma sub-rede e permitir IGMP/multicast.
+- Wi‑Fi com “client isolation” impede descoberta.
+
+Operação no código: [appendix_portas_e_multicast.md](../../documentation/appendix_portas_e_multicast.md).
+
+RFC introdutória: ver entrada `rfc1112` em [bibliografia.bib](../bibliografia.bib).

docs/references/notas/udp_vs_tcp.md

@@ -0,0 +1,10 @@
+# UDP vs TCP (nota)
+
+| | UDP | TCP |
+| --- | --- | --- |
+| Conexão | Não | Sim |
+| Confiabilidade | Melhor esforço | Entrega ordenada na conexão |
+| Delimitação de mensagem | Por datagrama | Fluxo de bytes — Pitiupi usa framing 4+N |
+| Uso no Pitiupi | Heartbeat, multicast, plugins | Canais diretos peer-a-peer |
+
+Ver [05_udp_multicast.md](../../documentation/05_udp_multicast.md) e [06_tcp_conexoes.md](../../documentation/06_tcp_conexoes.md).