Refatorando com Padrões de Projeto

Repositório de estudo e exercícios do livro "Refatorando com Padrões de Projeto — Um guia em Java" (Marcos Brizeno).

Objetivo resumido

• Transformar conceitos do livro em exemplos executáveis, resumos e exercícios práticos.

Estrutura principal

• docs/ — resumos, agendas e material (ex.: docs/encontros.md).
• docs/spec.md — especificação do projeto, convenções e critérios para novos encontros.
• docs/analise-livro.md — análise completa do livro e trilha recomendada de encontros.
• examples/ — exemplos práticos organizados por encontro ou padrão (ex.: examples/encontro-01/).
• scripts/ — utilitários e scripts de setup (opcional).
• tests/ — testes automatizados associados aos exemplos.

Encontros

O estudo é dividido em 4 encontros:

• Encontro 1 — Capítulos 1, 2 e 3: fundamentos, refatoração e orientação a objetos.

• Encontro 2 — Capítulos 4, 5 e 6: Factory, Strategy e Template Method.

• Encontro 3 — Capítulos 7, 8 e 9: Adapter, State e Builder.

• Encontro 4 — Capítulos 10, 11, 12 e 13: Decorator, Mediator, uso consciente de padrões e conclusão.

• Agenda, objetivos e atividades: docs/encontros.md

• Análise completa do livro: docs/analise-livro.md

• Material prático: examples/encontro-01/, examples/encontro-02/, examples/encontro-03/ e examples/encontro-04/

Organização dos exemplos

Cada encontro possui pastas por capítulo. Dentro de cada capítulo existem duas versões:

• sem-refatoracao/ — código inicial do exemplo.
• com-refatoracao/ — código após refatoração e/ou aplicação do padrão.

Exemplo:

examples/encontro-02/capitulo-04-factory/
├── sem-refatoracao/
└── com-refatoracao/

Como executar os exemplos

Entre em qualquer pasta sem-refatoracao/ ou com-refatoracao/ que tenha Main.kt e execute:

kotlinc Main.kt -d out && kotlin -cp out MainKt

Como executar os testes

Cada exemplo possui um MainTest.kt. Para rodar tudo:

bash scripts/test-exemplos.sh

Ou, dentro de uma pasta de exemplo:

kotlinc Main.kt MainTest.kt -d out && kotlin -cp out MainTestKt

Boas práticas e convenções

• JDK 11+ recomendado.
• Exemplos executáveis devem usar Kotlin simples quando possível, para rodar sem dependências externas.
• Cada exemplo deve ter um README.md local com objetivo, contexto, comandos e critérios de comparação.
• O código em com-refatoracao/ deve preservar o comportamento observável da versão sem-refatoracao/.

Como contribuir

1. Abra uma issue para discutir mudanças maiores ou novos encontros.
2. Crie um branch encontro-XX/nome ou feature/<descrição>.
3. Submeta PR com descrição clara, incluindo como testar as mudanças.
4. Inclua testes quando alterar comportamento do código.

Próximos passos recomendados

• Implementar os exemplos do Encontro 3: Adapter, State e Builder.
• Evoluir os testes simples para JUnit, se o grupo quiser uma suíte formal.

Contato / Maintainer

• Abra issues para dúvidas, correções ou sugestões.

Licença

Veja o arquivo LICENSE no repositório.