Gabriel Felipe Souza SantosandCursor
de65f3063f
Í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>
2.5 KiB
2.5 KiB
Fundamentação — redes e código
Mapa entre conceitos de Redes de Computadores e o Pitiupi. Aprofundamento: references/README.md.
Camada de aplicação P2P
| Conceito | No Pitiupi |
|---|---|
| Aplicação distribuída sem servidor dedicado | Cada peer executa o mesmo núcleo + plugins |
| Identidade do participante | Nome no login + HeartbeatMessage (instância) |
| Broadcast lógico | UDP multicast no grupo 224.0.0.3 |
| Comunicação 1:1 | UDP unicast ou TCP com conexão persistente |
UDP
- Sem conexão; mensagens delimitadas por datagrama.
- Multicast economiza envios para todos os peers do grupo.
- Limitações: perda, ordem, MTU — relevante para plugins com imagens (screenCast).
Doc: 05_udp_multicast.md.
TCP
- Conexão orientada a fluxo; o núcleo adiciona framing (tamanho + payload).
- Uma conexão por endereço de peer reutilizada para várias mensagens.
- Fechamento quando peer some do heartbeat.
Doc: 06_tcp_conexoes.md.
Presença
Heartbeats periódicos em UDP; timeout ~15 s. Analogia com “keepalive” de presença, não com camada de transporte confiável.
Doc: 08_heartbeat_e_presenca.md.
Serialização
Objetos Java Serializable em byte[] — acoplamento de versão de classes entre peers (mesmo plugin instalado).
Doc: 07_mensagens_e_serializacao.md.
Extensibilidade
SPI e classloader por JAR — padrão de plug-in em aplicações Java.
Doc: 09_sistema_de_plugins.md.
Quando o Pitiupi usa cada transporte
| Situação | Transporte típico | Motivo |
|---|---|---|
| Lista de usuários / heartbeat | UDP multicast | Todos os peers sem conexão prévia |
| Sala geral (chat, ping broadcast) | UDP multicast ou cópias unicast/TCP conforme combo | Didático: aluno vê diferença na UI |
| Mensagem para um IP | UDP unicast ou TCP | Destino explícito |
| Fluxo contínuo (tela, TCP privado chat) | TCP | Fluxo e framing no núcleo |
UDP não é “sempre mais rápido” nem TCP “resolve tudo”: perda e ordem ainda importam na aplicação; TCP adiciona handshake e estado por peer.