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>

README.md

@@ -1,29 +1,50 @@
 # pitiupi
 
-Ferramenta p2p para práticas em rede
+Ferramenta **P2P** para práticas de Redes de Computadores: núcleo em Java com arquitetura de **plugins** (chat, compartilhamento de tela, exemplos multi-protocolo).
 
-Este repositório tem 3 projetos Java que são independentes:
-- A ferramenta pitiupi (P2P)
-- Um plugin de Chat
-- Um plugin de ScreenCast
+**Documentação completa:** [docs/README.md](docs/README.md)
 
-Cada um destes projetos deve ser compilado individualmente. Para isso, use a ferramenta ant no diretório do projeto.
-Ex:
+## Pré-requisitos
+
+| Ferramenta | Uso |
+| --- | --- |
+| **JDK** com `javac` | Compilação (OpenJDK **25** recomendado; núcleo compila com target **17**) |
+| **Apache Ant** 1.10+ | `pitiupi/`, `pitiupi.chat/`, `pitiupi.screenCast/` |
+| **GNU Make** | `pitiupi.mpChat/` |
+
+Exemplo Ubuntu / WSL:
+
+```bash
+sudo apt install openjdk-25-jdk ant make
+javac -version   # deve existir — JRE sozinho não basta
 ```
-cd pitiupi.chat
-ant jar
-``` 
 
-Feito isso, os arquivos jar dos plugins deverão ser copiados ou linkados na pasta plugin da ferramenta.
-No caso de a mesma ser linkada, ao recompilar os plugins não é necessário copiar o mesmo novamente para a pasta de plugins da ferramenta.
-Para criar links simbólicos no Linux, use o comando:
+## Módulos
 
-```
+| Pasta | Descrição | Build |
+| --- | --- | --- |
+| `pitiupi/` | Núcleo (GUI, UDP multicast, TCP, heartbeat) | `ant jar` |
+| `pitiupi.chat/` | Plugin referência — chat | `ant jar` |
+| `pitiupi.screenCast/` | Plugin referência — screen cast | `ant jar` |
+| `pitiupi.mpChat/` | Plugin referência — chat multicast + TCP | `make` |
+
+Compile cada módulo no seu diretório (núcleo primeiro). Instale os JARs dos plugins em `pitiupi/plugins/` — ver [pitiupi/plugins/README.md](pitiupi/plugins/README.md).
+
+Exemplo de symlinks (Linux):
+
+```bash
 cd pitiupi/plugins
-ln -s ../../pitiupi.chat/dist/*.jar .
-ln -s ../../pitiupi.screenCast/dist/*.jar .
-``` 
-Isso deve resolver!
+ln -sf ../../pitiupi.chat/dist/pitiupi.chat.jar pitiupi.chat.jar
+ln -sf ../../pitiupi.screenCast/dist/pitiupi.screenCast.jar pitiupi.screenCast.jar
+ln -sf ../../pitiupi.mpChat/dist/mpChat.jar mpChat.jar
+```
 
-Para criar um novo plugin:
+Execute o núcleo (a partir de `pitiupi/`):
 
+```bash
+cd pitiupi
+java -jar dist/pitiupi.jar
+```
+
+Quickstart: [docs/documentation/00_quickstart.md](docs/documentation/00_quickstart.md).  
+Trabalho prático (plugin próprio): [docs/documentation/10_tutorial_plugin.md](docs/documentation/10_tutorial_plugin.md).