Colaboradores

O que essa tela faz

Cadastra e organiza as pessoas que aparecem na página pública de reconhecimento (/colaboradores) — time interno da YMA e parceiros externos. É também aqui que o Marcos gera o link mágico (token único) que cada colaborador usa pra atualizar a própria foto, frase e horário de trabalho em /colaboradores/editar/[token], sem precisar de senha.

Campo a campo

• Nome (obrigatório).
• Cargo (opcional).
• Unidade(s)/praça(s) — seletor multi-unidade: "Global" (sem praça específica), uma ou mais

unidades cadastradas (a de menor ordem vira a "principal", define o fuso horário usado em qualquer agenda dessa pessoa), ou nenhuma loja com um texto livre de "Abrangência".

• Grupo — "Liderança" ou "Equipe"; liderança vê a agenda do Marcos automaticamente, sem

precisar marcar nada a mais.

• Tipo — "Interno (YMA)" ou "Externo (parceiro)" — separa o time da YMA de parceiros (ex.:

quem desenvolveu o sistema).

• Foto de perfil (opcional) — upload de imagem (até 8 MB; aceita HEIC/HEIF, convertido

automaticamente).

• Email, Telefone, WhatsApp (com DDI+DDD, só números), Instagram, Site

(opcionais).

• Data de contratação e Data de desligamento (opcionais) — desligamento preenchido move

a pessoa pra seção "já fizeram parte" na página pública, em vez de excluí-la.

• Frase de reconhecimento (opcional) — texto curto mostrado na página pública (o mesmo campo

que o colaborador também pode editar sozinho pelo link mágico).

• Destaque (checkbox) — só um colaborador em destaque por vez; marcar este tira o destaque de

qualquer outro automaticamente.

• "Pode ver a agenda do Marcos" (checkbox, só aparece pra quem NÃO é liderança) — dá acesso à

agenda pública dele (visitas/viagens marcadas como visíveis) na área pessoal do colaborador.

• Campos visíveis ao público — 9 interruptores (Foto, Cargo, Unidade/filial, Tempo de casa,

Email, Telefone, Instagram, Botão de WhatsApp, Site): controla campo a campo o que aparece pro visitante na página /colaboradores.

• Link de edição — gera (ou revoga) o link mágico /colaboradores/editar/[token] pra essa

pessoa; só disponível depois de salvar o colaborador pela primeira vez.

• Status — Publicado ou Rascunho.

Ações disponíveis

• "Novo colaborador" — abre o formulário em branco.
• Setas para cima/baixo — reordena a lista trocando a posição com o vizinho.
• Editar (lápis) — abre o formulário preenchido.
• Excluir (lixeira) — pede confirmação; some da página pública (soft delete,

deleted_at); o aviso sugere usar "data de desligamento" em vez de excluir, pra manter a pessoa na seção "já fizeram parte".

• "gerar link" — cria o token de autoedição; "copiar" copia a URL completa;

"revogar link" invalida o token atual (um novo é gerado só quando pedido de novo).

Dúvidas frequentes

P: Um colaborador saiu e não quero mais que ele apareça, mas também não quero apagar o histórico. R: Preencha "Data de desligamento" em vez de excluir — ele passa pra seção "já fizeram parte" na página pública.

P: Gerei o link mas o colaborador diz que não funciona mais. R: Se você clicou em "revogar link" depois, o link antigo para de funcionar — gere um novo e mande de novo pra pessoa.

P: Marquei "Pode ver a agenda do Marcos" só que a pessoa é da Liderança. R: Não precisa — quem é Liderança já vê automaticamente; o checkbox só existe pra quem está fora da liderança.

Erros comuns