Obrigado pelo interesse! Contribuições são bem-vindas.
- Procure nas issues se o assunto já existe. Para mudanças grandes, abra uma issue antes para alinharmos a ideia.
- Configure o ambiente seguindo o README.
- Faça um fork e crie uma branch (
feature/minha-ideiaoufix/meu-bug). - Faça commits pequenos e com mensagens claras, de preferência em Conventional Commits.
- Garanta que
./gradlew build -x testpassa e, se você adicionou testes,./gradlew test. - Abra um Pull Request preenchendo o template.
- Siga a organização em camadas:
controllers→services→repositorys. Regras de negócio ficam nos services. - Erros de domínio viram exceções em
exception/custome são traduzidos por um handler emexception/handler. - Mudanças no banco entram como novas migrations Flyway (
V6__...). Nunca edite uma migration já existente. - Endpoints novos ou alterados devem atualizar o arquivo correspondente em
docs/. - Não inclua segredos,
.env, o JSON do Firebase, senhas nem tokens reais. - Não registre dados pessoais ou tokens em logs.
Ao enviar um pull request, você declara que é autor do que está enviando e concorda que a contribuição seja licenciada sob a PolyForm Noncommercial 1.0.0. Você também autoriza o mantenedor a relicenciar o projeto no futuro, incluindo para uso comercial.