1) Entenda o repositório e alinhe as expectativas

• Leia README, CONTRIBUTING.md e CODE_OF_CONDUCT.md para entender regras de contribuição e conduta.
• Verifique issues abertas com etiquetas como good-first-issue, help-wanted ou enhancement.
• Localize o flux de trabalho: fluxo de branch, padrões de commit, e requisitos de CI.
• Teste localmente: rode os testes unitários e de integração disponíveis antes de qualquer mudança.

Dica prática: procure por issues que descrevam um problema específico que você consiga isolar em uma PR pequena e bem definida.

2) Prepare o ambiente de desenvolvimento para NestJS

• Instale a versão correta do Node.js (LTS 18.x ou 20.x conforme o projeto).
• Use nvm ou volta a instalações por projeto para manter consistência entre ambientes.
• Instale dependências: npm install ou pnpm i, conforme o gerenciador do repositório.
• Valide o ambiente: execute lint, typecheck e os testes disponíveis localmente.

# Exemplo de setup típico
# Usando NVM
nvm install --lts
nvm use --lts

# Instalação de dependências
npm install
# ou
pnpm install

# Rodando o servidor de desenvolvimento (NestJS)
npm run start:dev
# ou
pnpm start:dev

# Executar lint e testes
npm run lint
npm run test

Observação: alguns repositórios utilizam scripts diferentes (ex.: yarn, npm) ou comandos específicos para monorepos. Siga a documentação do projeto.

3) Fluxo de contribuição e entrega de PR

• Crie uma branch com nomenclatura clara: feat/nome-descricao ou fix/nome-descricao.
• Escreva commits focados e com mensagens claras (preferencialmente Convenção de Commits).
• Antes de abrir PR, rode lint, typecheck e testes locais para manter a qualidade.
• Na PR, descreva o problema, a solução, como reproduzir e quais testes executou. Associe-se a issues (#123).

Boas práticas: mantenha PRs pequenos e com um único objetivo; evite introduzir mudanças não relacionadas no mesmo pull request.

feat(auth): add JWT strategy and guard for protected routes

- implement JWT-based authentication
- update auth module and guards
- add unit tests for new guard

4) Boas práticas para NestJS e open source

• Module boundaries: mantenha serviços pequenos, com responsabilidade única; evite acoplamento indevido entre módulos.
• Testes: cubra serviços com unit tests e controllers com integration tests; valide cenários de erro e edge cases.
• Validação e segurança: utilize DTOs com class-validator para entrada de dados; trate erros de forma previsível.
• Documentação: atualize comentários, JSDoc e README para facilitar a adoção por novos contribuidores.

Dicas rápidas: utilize mocks para dependências externas em testes; escreva exemplos de uso na documentação para reduzir dúvidas dos mantenedores.

// Exemplo de DTO com validação usando class-validator
import { IsEmail, IsNotEmpty, MinLength } from 'class-validator';

export class CreateUserDto {
  @IsNotEmpty()
  name: string;

  @IsEmail()
  email: string;

  @MinLength(8)
  password: string;
}