Core Docs
Produto e Fluxos

Fluxos Principais

Jornadas ponta a ponta que mais importam para operação e manutenção.

Cadastro de cliente e regionais

  1. Comercial cadastra o cliente com dados fiscais, endereço e contatos.
  2. Se o cliente opera em mais de uma localidade, cadastra regionais.
  3. Cada regional pode ter contatos próprios e benefícios próprios.
  4. Vagas podem ser vinculadas ao cliente raiz ou a uma regional.

Pontos de atenção:

  • Na interface, use sempre o termo Regional. ClientUnit é detalhe técnico do backend.
  • Contatos antigos não devem ser removidos sem alerta quando um novo contato é adicionado na edição.
  • Endereço preenchido não deve continuar aparecendo como obrigatório.

Abertura e aprovação de vaga

  1. RH ou usuário autorizado cria a vaga.
  2. O formulário aplica regras por motivo:
    • ampliação de quadro;
    • substituição;
    • cobertura de férias ou afastamento;
    • intervalo.
  3. Vagas que exigem aprovação entram na fila da Diretoria.
  4. Diretoria aprova ou rejeita com motivo.
  5. Uma vaga aprovada fica disponível para candidaturas.

Pontos de atenção:

  • Estado e cidade precisam ser selecionáveis no cadastro e na edição.
  • A UI deve manter espaçamentos consistentes nos campos condicionais.
  • Vaga com candidato vinculado exige cuidado antes de aprovar, rejeitar, fechar ou reabrir.

Candidatos e candidaturas

  1. RH cadastra ou edita o candidato.
  2. O candidato pode entrar no banco de talentos quando está disponível.
  3. Ao ser vinculado a uma vaga, nasce uma candidatura.
  4. A candidatura pode ser aprovada, contratada, rejeitada, removida ou marcada como desistente.
  5. Eventos do backend recalculam o status do candidato.

Pontos de atenção:

  • Data de nascimento deve aceitar apenas datas entre 1920 e o dia atual.
  • Quantidade de filhos deve ser limitada e mensagens de erro precisam ser claras.
  • Candidato restrito não deve continuar marcado como banco de talentos.
  • Reaprovar desistência deve atualizar listas e detalhes relacionados, não só a tela atual.

Usuários, cargos e permissões

  1. Admin cria usuários.
  2. Admin atribui cargos ao usuário.
  3. Cargos carregam permissões.
  4. O backend valida cada endpoint com @RequiresPermission.
  5. O frontend usa roles/permissões apenas para esconder ou exibir partes da interface.

Pontos de atenção:

  • Usuário com múltiplos cargos deve aparecer agrupado pelo cargo de maior prioridade: Admin, Diretoria, RH, User.
  • A tela de níveis de acesso deve focar em cargos. Permissões do sistema não devem ser tratadas como cadastro livre.

Chamados

  1. Usuário abre chamado com título, categoria, prioridade e descrição.
  2. Backend cria o ticket.
  3. Usuário consulta seus chamados em /mine.
  4. Usuário autorizado consulta todos os chamados e altera status.

Pontos de atenção:

  • Separar visualmente quem criou e quem responde ajuda mais que uma explicação de fluxo.
  • A página deve priorizar lista, filtros e status. Texto explicativo em excesso atrapalha.

On this page