[PAV-115] - front-melhorias-de-filtros

[Benevanio]

O que foi feito?

Implementado sistema robusto de busca e filtro de vagas com suporte a índices invertidos no Valkey, detecção e auto-reparo de documentos órfãos, seed de catálogo com vagas calibradas para match de perfil, e filtros granulares por localização (país, continente, estado, cidade), contrato, empresa e senioridade. A busca utiliza índice global (scraper:jobs:index) como fonte primária, hidratando documentos em janelas de até 10 fatias para evitar varredura completa em índices grandes. IDs sem documento correspondente no Valkey são detectados, removidos do índice automaticamente (auto-reparo espelhando scraper-go), e contabilizados no total retornado. Filtros estruturados (país, tecnologia, família, senioridade) usam índices invertidos (scraper:jobs:*) quando disponíveis; filtros post-only como empresa caem no caminho fallback de busca full-scan seguida de pós-filtro em memória. Perfis técnicos do usuário agora são hidratados no seed com tecnologias e nível, permitindo priorização de vagas compatíveis: cacheSearchKeywords() retorna IDs de vagas que casam com o perfil do candidato, reordenando resultados de maior para menor match. Infer de localização foi refatorado em tabela declarativa (LOCATION_RULES, BRAZILIAN_STATES, KNOWN_CITIES), espelhando estrutura do scraper Go para consistência bit-a-bit. Novo método inferJobContract() classifica vagas como CLT, PJ ou cooperado a partir de título, descrição e localização. Interface SearchJobFilters expandida com novos campos: seniority, state, city, contract, family, technology, company. Frontend removeu recalcular match quando backend já forneceu matchScore, e eliminou re-filtro client-side por modelo (quebrava paginação). Seed de desenvolvimento cria 12 vagas em catálogo calibradas de 99% a 45% match com perfil técnico do dev (React, TypeScript, Node.js, PostgreSQL, Docker, AWS), e atualiza perfil técnico se usuário existir. Testes unitários cobrem: hidratação de páginas com órfãos, auto-reparo, limite de esforço (max 10 janelas), priorização por perfil, pós-filtro por empresa e contrato, e matching de regras de localização. Nova função buildFilterParams() remove filtros vazios antes de enviar, evitando cache poisoning. Sem mudança no contrato HTTP; apenas refactor de busca, hidratação e seed.

Documentos alterados

• .cspell/custom-dictionary-workspace.txt [change]
• LOCAL_DEVELOPMENT.md [change]
• backend/src/lib/cache.ts [change]
• backend/src/modules/jobs/filters/jobSearch.filter.ts [change]
• backend/src/modules/jobs/parsers/jobSearchQuery.parser.ts [change]
• backend/src/modules/jobs/services/searchJobs.service.ts [change]
• backend/src/modules/jobs/types/jobSearch.types.ts [change]
• backend/src/scripts/seed.ts [change]
• backend/src/scripts/seedCatalogJobs.ts [add]
• backend/tests/unit/app.test.ts [change]
• backend/tests/unit/libs/cache.test.ts [change]
• backend/tests/unit/modules/jobs/jobSearch.filter.test.ts [add]
• backend/tests/unit/modules/jobs/searchJobs.service.test.ts [add]
• backend/tests/unit/scripts/seedCatalogJobs.test.ts [add]
• docker-compose.migrate.yml [change]
• frontend/src/domains/jobs/application/useJobsData.ts [change]
• frontend/src/domains/new_dashboard/NewDashboardPage.tsx [change]
• frontend/src/domains/new_dashboard/hooks/useDashboardJobs.ts [change]
• frontend/src/domains/new_dashboard/infrastructure/dashboardJobsApi.ts [change]

Checklist

• Testado?
• Documentado?
• Build passando?