From 588a1ad6322e8ed7308894018898406103637302 Mon Sep 17 00:00:00 2001 From: Tiago Yamamoto Date: Sat, 14 Feb 2026 15:19:32 -0300 Subject: [PATCH] =?UTF-8?q?docs:=20expandir=20checklist=20de=20publica?= =?UTF-8?q?=C3=A7=C3=A3o=20de=20vagas=20no=20padr=C3=A3o=20Careerjet?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/CAREERJET_GAP_ANALYSIS.md | 115 +++++++++++++++++++++++++++++++++ 1 file changed, 115 insertions(+) diff --git a/docs/CAREERJET_GAP_ANALYSIS.md b/docs/CAREERJET_GAP_ANALYSIS.md index c538d73..35f2980 100644 --- a/docs/CAREERJET_GAP_ANALYSIS.md +++ b/docs/CAREERJET_GAP_ANALYSIS.md @@ -89,3 +89,118 @@ Mapear o que já existe no GoHorseJobs e o que ainda falta para alcançar um flu - **Dependência de modelagem de dados** para alertas e follows. - **Qualidade dos dados de salário/empresa** impacta filtros e ordenação. - **Internacionalização**: novas labels e mensagens precisam entrar no i18n. + +--- + +## Checklist evoluído — Publicação de vaga no padrão Careerjet + +> Referência funcional para o portal GoHorseJobs no fluxo de publicação: +> **1) Detalhes da vaga → 2) Pré-visualização → 3) Informações de faturamento → 4) Pagamento**. + +### 1) Detalhes da vaga (escopo obrigatório) + +#### Identificação da vaga +- [ ] **Título da vaga** + - Regra: obrigatório, texto claro e conciso, até **65 caracteres**. + - Validações: bloquear excesso de pontuação, abreviações promocionais e termos de marketing (ex.: “IMPERDÍVEL!!!”). + +- [ ] **Localidade da vaga** + - Regra: obrigatório, **uma única localidade** por anúncio. + - Validações: cidade/município válido, sem múltiplas localidades no mesmo campo. + +- [ ] **País** + - Regra: obrigatório, selecionado de lista de países. + - Dependência: país deve dirigir moeda padrão e preço do anúncio (quando aplicável no billing). + +#### Modelo de contratação +- [ ] **Tipo de contrato** + - Opções-alvo: `Permanent`, `Contract`, `Training`, `Temporary`, `Voluntary`, `Any`. + +- [ ] **Jornada de trabalho** + - Opções-alvo: `Full-time`, `Part-time`, `Any`. + +#### Salário +- [ ] **Modo de pagamento** + - Opções: `Salary range` ou `Fixed salary`. + - Validação: exibir campos condicionalmente conforme o modo. + +- [ ] **Moeda** + - Regra: obrigatório quando salário informado. + - Opções: lista internacional (USD, EUR, BRL etc.). + +- [ ] **Período do salário** + - Opções: por `hora`, `dia`, `semana`, `mês` ou `ano`. + +#### Conteúdo da vaga +- [ ] **Descrição da oferta** + - Regra: obrigatório, editor rico. + - Recomendação UX: suporte a parágrafos e listas para habilidades e qualificações. + +#### Sobre a empresa (opcional, com ocultação) +- [ ] **Nome da empresa** +- [ ] **Site da empresa** +- [ ] **Número de empregados** + - Opções-alvo: `Self-employed`, `1–10`, `11–50`, `51–200`, `201–500`, `501–1000`, `1001–5000`, `5001–10000`, `10000+`. +- [ ] **Ano de fundação** +- [ ] **Descrição da empresa** +- [ ] **Toggle “Ocultar dados da empresa”** + - Regra: quando ativo, ocultar bloco de empresa na visualização pública da vaga. + +#### Recebimento de candidaturas +- [ ] **Canal de candidatura** + - Opções: `E-mail`, `Link externo`, `Telefone`. + - Validação condicional: + - E-mail: validar formato RFC básico. + - Link externo: exigir URL HTTPS válida. + - Telefone: validar DDI + número. + +- [ ] **Requerer envio de currículo** + - Opções: `Obrigatório`, `Opcional`, `Não solicitado`. + +- [ ] **Idioma da descrição da vaga** + - Regra: obrigatório. + - Recomendação: idioma deve ser compatível com o país selecionado. + +#### Extensões locais (GoHorseJobs) +- [ ] **CNPJ da empresa (Brasil)** + - Regra: opcional/obrigatório por política comercial. + - Validação: máscara e dígitos verificadores. +- [ ] **Benefícios** (multiselect) +- [ ] **Área de atuação** (taxonomia do portal) + +--- + +### 2) Pré-visualização +- [ ] Exibir versão final da vaga com todos os metadados selecionados. +- [ ] Indicar claramente campos ocultos (ex.: dados de empresa) antes de prosseguir. +- [ ] Permitir voltar para edição sem perda de dados. + +### 3) Informações de faturamento +- [ ] Capturar dados fiscais (pessoa/empresa, documento, endereço de cobrança). +- [ ] Exibir plano/preço por país e duração (ex.: **US$130/30 dias** para EUA, quando aplicável). +- [ ] Validar consistência entre país da vaga e país de faturamento conforme regra de negócio. + +### 4) Pagamento +- [ ] Seleção de método de pagamento disponível no país. +- [ ] Confirmação final com resumo: vaga + faturamento + valor. +- [ ] Geração de comprovante/registro de transação. +- [ ] Definição de status da vaga pós-pagamento (`pending_review`, `active`, `failed_payment`). + +--- + +## Critérios de aceite (checklist de QA) + +### Validação de formulário +- [ ] Não permite avançar sem campos obrigatórios da etapa atual. +- [ ] Exibe mensagens de erro específicas por campo. +- [ ] Mantém dados preenchidos ao navegar entre etapas. + +### Regras de negócio +- [ ] Salário fixo/range respeita lógica condicional dos campos. +- [ ] Canal de candidatura valida apenas o tipo selecionado. +- [ ] Idioma e país possuem validação mínima de compatibilidade. + +### Publicação +- [ ] Pré-visualização reflete exatamente o payload persistido. +- [ ] Após pagamento aprovado, vaga segue para status esperado. +- [ ] Logs/auditoria registram criação e transição de status.