Files
pitiupi/docs/documentation/13_guia_desenvolvimento.md
T
Gabriel Felipe Souza SantosandCursor 42e70af48b refactor(plugins): SPI workspace-only e remoção de menus legados
Remove GuiManager e pitiupi.models.Menus; atualiza chat/screencast, docs e testes (ConfigLoader, TcpConnectionManager).

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-27 20:39:39 -03:00

1.7 KiB

Guia para desenvolvimento

Esta documentação descreve a ferramenta Pitiupi neste repositório: build, rede, plugins e convenções de código.

Leitura mínima antes de mudar código

  1. 00_quickstart.md — build e execução
  2. 04_inicializacao_e_gui.md — boot e diagrama
  3. 09_sistema_de_plugins.md — contrato de extensão
  4. 14_arquitetura_e_manutencao.md — mapa de pacotes

Por tipo de tarefa

Tarefa Ler primeiro
Novo plugin (aluno) 10_tutorial_plugin.md, 11_plugins_referencia.md
Bug UDP / multicast 05_udp_multicast.md, appendix_portas_e_multicast.md
Bug TCP / conexão 06_tcp_conexoes.md
Presença / lista de usuários 08_heartbeat_e_presenca.md
Desserialização / mensagens 07_mensagens_e_serializacao.md

Gate de build

cd pitiupi && ant jar && ant test
cd plugins/chat && ant jar
cd plugins/screencast && ant jar

Ou na raiz: ./scripts/pitiupi.sh build --all.

Testes manuais em rede: 15_testes_e_gate.md.

Convenções

  • Código e identificadores em inglês (pacotes pitiupi.*).
  • Documentação em português (BR) em docs/.
  • Evitar alterar o núcleo para um único plugin — preferir extensão via Plugin e PluginWorkspace.

Decisões e débitos