docs: expandir checklist de publicação de vagas no padrão Careerjet

This commit is contained in:
Tiago Yamamoto 2026-02-14 15:19:32 -03:00
parent 80ac214e5f
commit 588a1ad632

View file

@ -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`, `110`, `1150`, `51200`, `201500`, `5011000`, `10015000`, `500110000`, `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.