chore: configura husky e padroniza contribuição

Author: Benevanio

.husky/pre-commit

@@ -0,0 +1 @@
+npm test

commitlint.config.js

@@ -0,0 +1 @@
+export default { extends: ['@commitlint/config-conventional'], };

contribuition.md

@@ -0,0 +1,175 @@
+# Guia de Contribuicao
+
+Este documento define o processo oficial de contribuicao no monorepo para manter qualidade, previsibilidade e historico limpo.
+
+## 1. Fluxo obrigatorio
+
+1. Criar/selecionar um card no board oficial.
+2. Atualizar a branch principal local.
+3. Criar branch de feature a partir da master.
+4. Implementar mudancas com testes.
+5. Commitar em blocos pequenos e coerentes.
+6. Abrir PR para develop.
+7. Ajustar feedback de review.
+8. Fazer merge somente apos aprovacao.
+
+## 2. Padrao de branch
+
+Formato recomendado:
+
+- feature/<id-card>-<descricao-curta>
+- fix/<id-card>-<descricao-curta>
+- chore/<id-card>-<descricao-curta>
+
+Exemplo:
+
+- feature/123-corrigir-contrato-keywords
+
+Comandos base:
+
+```bash
+git checkout master
+git pull origin master
+git checkout -b feature/123-corrigir-contrato-keywords
+```
+
+## 3. Responsabilidades por papel
+
+### Desenvolvedor(a)
+
+- Implementar somente o escopo do card.
+- Garantir build e testes locais antes do commit.
+- Atualizar documentacao quando contrato/API mudar.
+- Descrever claramente impacto tecnico no PR.
+
+### Revisor(a)
+
+- Validar regressao funcional e tecnica.
+- Verificar padrao de codigo e clareza do diff.
+- Bloquear merge se houver risco de quebra nos fluxos criticos.
+
+### QA
+
+- Executar roteiro QA no estado da branch.
+- Reportar bug com passos, evidencia e severidade.
+- Aprovar somente apos criterios de aceite serem atendidos.
+
+## 4. Convencao de commit
+
+Usar Conventional Commits:
+
+- feat: nova funcionalidade
+- fix: correcao de bug
+- chore: manutencao
+- refactor: refatoracao sem mudar comportamento
+- test: testes
+- docs: documentacao
+
+Formato:
+
+```text
+tipo(escopo): descricao curta no imperativo
+```
+
+Exemplos:
+
+- feat(frontend): adicionar estado vazio para tabela
+- fix(backend): corrigir metodo da rota jobs search
+- docs(repo): atualizar guia de testes
+
+## 5. Checklist antes do commit
+
+Executar na raiz:
+
+```bash
+npm run lint --workspace=frontend
+npm run test --workspace=backend
+npm run build --workspace=frontend
+```
+
+Se alterou backend com banco:
+
+```bash
+npm run db:generate
+npm run db:migrate
+```
+
+## 6. Husky (hooks locais obrigatorios)
+
+O projeto esta preparado para usar Husky com os hooks:
+
+- pre-commit: lint frontend + teste backend
+- pre-push: build frontend
+
+Arquivos de hook:
+
+- .husky/pre-commit
+- .husky/pre-push
+
+### Instalacao inicial
+
+Depois de clonar o repositorio:
+
+```bash
+npm install
+```
+
+O script prepare configura o Husky automaticamente.
+
+### Rodar hooks manualmente (debug)
+
+```bash
+npm run hook:pre-commit
+npm run hook:pre-push
+```
+
+## 7. Regras de Pull Request
+
+Toda PR deve conter:
+
+1. Link do card/issue.
+2. Resumo objetivo das alteracoes.
+3. Evidencias de teste (logs, prints ou comandos executados).
+4. Riscos conhecidos e plano de rollback, quando aplicavel.
+
+Checklist minimo da PR:
+
+- [ ] Escopo limitado ao card
+- [ ] Sem arquivos temporarios/gerados desnecessarios
+- [ ] Sem segredo/token em codigo
+- [ ] Testes locais executados
+- [ ] Documentacao atualizada (quando necessario)
+
+## 8. Regras de merge
+
+- Nao fazer commit direto em master ou develop.
+- Nao fazer merge sem review.
+- Nao usar squash sem preservar contexto da PR (descricao clara).
+- Corrigir conflitos localmente e rerodar checklist antes do merge.
+
+## 9. Politica de qualidade minima
+
+- Cobertura minima de 80% (linhas, statements, functions, branches) conforme TESTING.md.
+- Qualquer mudanca em contrato de API deve vir com ajuste de frontend e testes relacionados.
+- Bugs bloqueantes ou criticos impedem merge.
+
+## 10. Template rapido de mensagem de PR
+
+```markdown
+## Card
+- [link do card]
+
+## O que foi feito
+- item 1
+- item 2
+
+## Validacao
+- comando 1
+- comando 2
+
+## Riscos
+- risco 1
+
+## Evidencias
+- print/log/link
+```