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>
This commit is contained in:
Gabriel Felipe Souza SantosandCursor committed 2026-10-13 21:20:20 -03:00
1 parent d92708a6e9
commit f02acaf131
61 files changed
+1408 -758

No files matched your search

@@ -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).
@@ -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).
+12
View File
@@ -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).
+10
View File
@@ -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).