Skip to content

PAV-122: Adicionar classificação para Produto e Design de Produto - #262

Merged
hltav merged 2 commits into
masterfrom
develop
Oct 7, 2026
Merged

hltav merged 2 commits into
masterfrom
develop

Conversation

@hltav

@hltav hltav commented Oct 7, 2026

Copy link
Copy Markdown
Collaborator

Linear

Close PAV-122

https://linear.app/candidateappbr/issue/PAV-122/go-adicionar-classificacao-para-produto-e-design-de-produto

Objetivo

Adicionar ao Jobs Processor suporte às famílias profissionais product e
product_design, permitindo classificar vagas de Produto e Design de Produto
sem introduzir falsos positivos em famílias técnicas já existentes.

A classificação prioriza evidências presentes no título da vaga. Descrição,
competências e ferramentas permanecem apenas como evidências complementares.

Resumo das alterações

  • Adiciona as famílias product e product_design ao classificador Go.
  • Define precedência de product_design sobre product quando aplicável.
  • Exige evidência profissional no título para habilitar as novas famílias.
  • Adiciona normalização e correspondência por palavras completas para evitar
    colisões como product x production.
  • Adiciona regras negativas para produção, marketing, vendas, suporte,
    engenharia e áreas de design não relacionadas a produto digital.
  • Preserva as classificações técnicas existentes quando product aparece
    apenas como contexto da vaga.
  • Adiciona cargos de Produto e Product Design em português e inglês às
    keywords de coleta.
  • Evita geração artificial de combinações como Jira Product Manager,
    Figma Product Owner e SQL UX Designer.
  • Mantém o limite e a ordem determinística da geração de keywords.
  • Impede a criação prematura dos novos índices
    scraper:jobs:family:product e
    scraper:jobs:family:product_design.
  • Atualiza a documentação do Jobs Processor.
  • Adiciona documentação para o fluxo padronizado de abertura de PRs do
    Candidate.

Arquivos / módulos afetados

  • scraper-go/internal/classifier/
  • scraper-go/internal/keywords/
  • scraper-go/internal/pipeline/
  • SCRAPER.md
  • ABRIR-PRS-CANDIDATE.md
  • GUIA-LINEAR-GITHUB.md

Como testar

cd scraper-go
go test ./...
go test -race ./...
go vet ./...

Também foram executados testes relacionados de cache, busca e filtros do backend.

Validação

  • Testes focados de classifier, keywords e pipeline
  • go test ./...
  • go test -race ./...
  • go vet ./...
  • Testes relacionados do backend
  • git diff --check
  • Documentação atualizada
  • Nenhum segredo ou credencial incluído

Resultados

  • go test ./... — PASS
  • go test -race ./... — PASS
  • go vet ./... — PASS
  • Backend relacionado — PASS, 64 testes
  • git diff --check — PASS

Não foi encontrado lint Go oficial configurado no projeto.

Impacto de banco / migrations

Sem alterações de schema ou migrations.

Impacto de configuração

Sem novas variáveis de ambiente.

O limite existente de geração de keywords foi preservado.

Impacto de contratos / API

Nenhum campo ou schema público foi alterado.

O campo skills não foi adicionado e os contratos atuais de classificação
foram preservados.

Impacto de segurança / privacidade

Sem impacto relevante identificado.

A alteração não modifica autenticação, autorização, secrets ou tratamento de
dados pessoais.

Impacto de documentação

  • Atualiza SCRAPER.md.
  • Adiciona ABRIR-PRS-CANDIDATE.md.
  • Atualiza GUIA-LINEAR-GITHUB.md.

Riscos

  • Títulos profissionais ambíguos podem exigir calibração futura.
  • Ainda não houve coleta externa controlada para avaliar precisão sobre vagas reais.
  • Os checks Go ainda não fazem parte do workflow atual de CI.

Rollback

Reverter este PR restaura a taxonomia e geração de keywords anteriores.

Não há migration ou alteração de dados persistidos que exija procedimento
adicional de rollback.

Fora do escopo

  • Filtros de Produto no backend ou frontend.
  • Novos índices por família no Valkey.
  • Novas cache keys.
  • Alteração do match score.
  • Campo skills.
  • Renomeação de scraper-go para jobs-processor.
  • Alterações de autenticação ou autorização.

hltav and others added 2 commits October 6, 2026 20:41
## Linear

Close PAV-122


https://linear.app/candidateappbr/issue/PAV-122/go-adicionar-classificacao-para-produto-e-design-de-produto

## Objetivo

Adicionar ao Jobs Processor suporte às famílias profissionais `product`
e
`product_design`, permitindo classificar vagas de Produto e Design de
Produto
sem introduzir falsos positivos em famílias técnicas já existentes.

A classificação prioriza evidências presentes no título da vaga.
Descrição,
competências e ferramentas permanecem apenas como evidências
complementares.

## Resumo das alterações

- Adiciona as famílias `product` e `product_design` ao classificador Go.
- Define precedência de `product_design` sobre `product` quando
aplicável.
- Exige evidência profissional no título para habilitar as novas
famílias.
- Adiciona normalização e correspondência por palavras completas para
evitar
  colisões como `product` x `production`.
- Adiciona regras negativas para produção, marketing, vendas, suporte,
  engenharia e áreas de design não relacionadas a produto digital.
- Preserva as classificações técnicas existentes quando `product`
aparece
  apenas como contexto da vaga.
- Adiciona cargos de Produto e Product Design em português e inglês às
  keywords de coleta.
- Evita geração artificial de combinações como `Jira Product Manager`,
  `Figma Product Owner` e `SQL UX Designer`.
- Mantém o limite e a ordem determinística da geração de keywords.
- Impede a criação prematura dos novos índices
  `scraper:jobs:family:product` e
  `scraper:jobs:family:product_design`.
- Atualiza a documentação do Jobs Processor.
- Adiciona documentação para o fluxo padronizado de abertura de PRs do
  Candidate.

## Arquivos / módulos afetados

- `scraper-go/internal/classifier/`
- `scraper-go/internal/keywords/`
- `scraper-go/internal/pipeline/`
- `SCRAPER.md`
- `ABRIR-PRS-CANDIDATE.md`
- `GUIA-LINEAR-GITHUB.md`

## Como testar

    cd scraper-go
    go test ./...
    go test -race ./...
    go vet ./...

Também foram executados testes relacionados de cache, busca e filtros do
backend.

## Validação

- [x] Testes focados de classifier, keywords e pipeline
- [x] `go test ./...`
- [x] `go test -race ./...`
- [x] `go vet ./...`
- [x] Testes relacionados do backend
- [x] `git diff --check`
- [x] Documentação atualizada
- [x] Nenhum segredo ou credencial incluído

### Resultados

- `go test ./...` — PASS
- `go test -race ./...` — PASS
- `go vet ./...` — PASS
- Backend relacionado — PASS, 64 testes
- `git diff --check` — PASS

Não foi encontrado lint Go oficial configurado no projeto.

## Impacto de banco / migrations

Sem alterações de schema ou migrations.

## Impacto de configuração

Sem novas variáveis de ambiente.

O limite existente de geração de keywords foi preservado.

## Impacto de contratos / API

Nenhum campo ou schema público foi alterado.

O campo `skills` não foi adicionado e os contratos atuais de
classificação
foram preservados.

## Impacto de segurança / privacidade

Sem impacto relevante identificado.

A alteração não modifica autenticação, autorização, secrets ou
tratamento de
dados pessoais.

## Impacto de documentação

- Atualiza `SCRAPER.md`.
- Adiciona `ABRIR-PRS-CANDIDATE.md`.
- Atualiza `GUIA-LINEAR-GITHUB.md`.

## Riscos

- Títulos profissionais ambíguos podem exigir calibração futura.
- Ainda não houve coleta externa controlada para avaliar precisão sobre
vagas reais.
- Os checks Go ainda não fazem parte do workflow atual de CI.

## Rollback

Reverter este PR restaura a taxonomia e geração de keywords anteriores.

Não há migration ou alteração de dados persistidos que exija
procedimento
adicional de rollback.

## Fora do escopo

- Filtros de Produto no backend ou frontend.
- Novos índices por família no Valkey.
- Novas cache keys.
- Alteração do match score.
- Campo `skills`.
- Renomeação de `scraper-go` para `jobs-processor`.
- Alterações de autenticação ou autorização.
@Benevanio Benevanio added the enhancement New feature or request label Oct 7, 2026
@hltav
hltav merged commit df50b0e into master Oct 7, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants