Pessoas

A seção Pessoas reúne o cadastro dos três tipos de pessoas que usam o Skolar: gestores, professores e responsáveis. Gestores são a equipe administrativa da escola; professores publicam para as turmas; responsáveis acompanham os filhos.

As três subseções compartilham a mesma estrutura de tela — lista paginada com busca, botão "Novo" no canto superior direito e um formulário único de criação e edição. Elas diferem nos campos específicos, nas permissões atribuíveis e nos vínculos que cada tipo de pessoa pode ter.

Cadastrar e gerenciar pessoas é exclusivo do dashboard. Professores e responsáveis usam o Skolar pelo aplicativo — eles não acessam o painel web.

---

Campos comuns

Independente do tipo de usuário, o formulário de cadastro coleta os seguintes dados:

• Nome completo — obrigatório em todos os tipos.
• Email — obrigatório para gestores; opcional para professores e responsáveis.
• CPF — campo com máscara de formatação automática no formato 000.000.000-00; opcional em todos os tipos.
• Telefone — obrigatório em todos os tipos. Recebe máscara de celular brasileiro e também serve como destino do envio de credenciais por SMS.
• Nome de exibição — obrigatório para gestores e professores. É o nome que aparece em comunicados, no atendimento e nas publicações — por exemplo "Direção", "Coordenação Pedagógica" ou "Secretaria".
• Login — gerado automaticamente na criação e exibido em modo somente leitura na edição. Segue o padrão AAA-99999, com as 3 letras do código da escola seguidas de 5 dígitos, como em STL-00001. Não pode ser alterado depois de criado.
• Foto de perfil — upload opcional de imagem em PNG ou JPG, no máximo 2 MB. Aceita remoção da imagem existente.
• Usuário ativo — controla se a pessoa consegue fazer login. Usuários inativos não acessam o Skolar. O campo fica desabilitado quando o gestor está editando a própria conta ou o gestor proprietário da escola.
• Senha — obrigatória na criação, com mínimo de 6 caracteres. Na edição é opcional: deixar em branco mantém a senha atual. Ao lado do campo há um botão para gerar uma senha aleatória e outro para copiar.

---

Gerar e enviar senha por SMS

O formulário de qualquer tipo de usuário inclui a opção "Gerar senha e enviar por SMS", controlada por um toggle.

Quando essa opção está ativada:

1. O campo de senha manual some — não é preciso digitar nada.
2. Ao salvar, o sistema gera uma senha segura e dispara o SMS para o telefone cadastrado.
3. A mensagem contém o login e a senha gerados, permitindo que a pessoa acesse o aplicativo na hora.

Esse fluxo ajuda no cadastro inicial de responsáveis em lote, quando é mais prático que cada responsável receba as próprias credenciais sem o gestor precisar fazer isso à mão.

O número de telefone informado no campo "Telefone" é o destino do SMS. Por isso, o telefone deve estar correto antes de acionar essa opção.

---

Gestores

Gestores são as pessoas com papel administrativo na escola. São o único perfil que acessa o dashboard, onde fazem tudo pelo navegador: publicam no feed, atendem conversas, acompanham relatórios e administram a escola — cadastros, configurações, permissões e assinatura.

Campos específicos de gestor:

• Nome de exibição — obrigatório. Aparece em todas as comunicações públicas do gestor com responsáveis.
• Permissões — cada gestor tem um conjunto configurável de permissões que determina quais seções e ações ele pode usar no painel.

Gerenciador de permissões:

As permissões ficam na seção "Configuração" do formulário. Clique no card "Permissões" para abrir o gerenciador, que organiza as permissões em três grupos:

Cada permissão pode ser marcada ou desmarcada individualmente. Também dá para marcar ou desmarcar um grupo inteiro de uma vez, clicando no cabeçalho do grupo.

Regra de delegação: um gestor só concede permissões que ele mesmo possui. Se ele não tiver a permissão "Finanças", por exemplo, essa opção aparece bloqueada e acinzentada ao editar outro gestor — mesmo que o gestor alvo já a tenha. Permissões que o editor não possui ficam visíveis apenas para leitura e não podem ser removidas por ele.

Proteções contra arquivamento e edição de permissões:

• O gestor proprietário da conta, o primeiro gestor criado no cadastro da escola, não pode ser arquivado por nenhum outro gestor. O botão "Arquivar" some na tela de edição desse usuário.
• Um gestor não pode arquivar a própria conta. O botão "Arquivar" também some na edição do próprio perfil.
• Pelas mesmas razões, o campo "Usuário ativo" e o gerenciador de permissões ficam desabilitados ao editar a própria conta ou ao editar o gestor proprietário.

---

Professores

Professores usam o aplicativo para registrar diários, tarefas e outras publicações direcionadas às turmas a que estão vinculados.

Campos específicos de professor:

• Nome de exibição — obrigatório. Aparece nas publicações feitas pelo professor no aplicativo.
• Permissões — o professor tem só as permissões de publicação: Diários, Tarefas, Comunicados, Mídias, Eventos e Enquetes. Professores não recebem permissões administrativas, como Usuários, Configurações, Finanças, Turmas, Alunos ou Relatórios.
• Vínculo com turmas — as turmas em que o professor pode publicar. A seleção é feita em um campo de múltipla escolha, com busca pelo nome da turma.

Os vínculos com turmas controlam para quais turmas o professor consegue publicar no aplicativo. Um professor sem nenhuma turma vinculada não consegue selecionar destinatários nas publicações.

---

Responsáveis

Responsáveis são os pais ou guardiões que recebem comunicados, acompanham o diário do aluno e interagem com a escola pelo aplicativo.

Campos específicos de responsável:

• Vínculo com alunos — seleção múltipla dos alunos sob a guarda dessa pessoa. A busca funciona pelo nome do aluno e também pelo identificador, seja CPF ou matrícula. No aplicativo, o responsável só vê os alunos vinculados ao seu perfil.
• Responsável financeiro — marca essa pessoa como contato administrativo principal no cadastro do aluno. É ativado por um toggle no formulário.

Criação rápida de aluno:

Ao preencher o vínculo com alunos, o gestor pode criar um novo aluno sem sair da tela do responsável. O botão "Adicionar aluno" abre um formulário rápido com os campos essenciais:

• Nome do aluno, obrigatório
• Identificador, opcional, que pode ser CPF ou matrícula
• Data de nascimento, opcional

Ao confirmar, o aluno é criado na escola e vinculado automaticamente ao responsável que está sendo cadastrado. O aluno recém-criado aparece selecionado no campo de vínculos. Esse fluxo ajuda no início do uso, quando responsáveis e alunos ainda não existem no sistema.

---

Histórico de notificações push por usuário

A tela de edição de qualquer pessoa — gestor, professor ou responsável — exibe, na seção "Histórico de comunicação", o botão "Ver notificações".

Ao clicar, abre um dialog com a lista paginada de notificações push enviadas para aquela pessoa. A tabela exibe:

• Data — data e hora do envio.
• Título — título da notificação. Ao passar o cursor, o corpo completo aparece em tooltip.
• Tipo — categoria do conteúdo que gerou a notificação: Publicação, Mensagem, Comunicado, Tarefa, Evento, Enquete, Mídia ou Diário.
• Status — badge colorido com o estado de entrega.

Os possíveis status de entrega de uma notificação push são:

A lista é paginada em grupos de 20 registros. O botão "Atualizar" recarrega os dados sem fechar o dialog.

---

Histórico de SMS por usuário

O botão "Ver SMS enviados" abre um segundo dialog com o histórico de mensagens SMS enviadas para aquela pessoa. A tabela exibe:

• Data — data e hora do envio.
• Telefone — número de destino.
• Mensagem — texto da mensagem, truncado em duas linhas; o texto completo aparece em tooltip ao passar o cursor.
• Status — badge colorido.
• Detalhes — informação complementar, como a data e hora da entrega confirmada ou a descrição do erro.

Os status de entrega de SMS são:

Quando o status é "Entregue", a coluna Detalhes exibe a data e hora exata em que a entrega foi confirmada. Para os outros estados, exibe a descrição do erro quando disponível.

A lista também é paginada em grupos de 20 registros.

---

Arquivar e Desarquivar usuário

Arquivar uma pessoa desativa o acesso dela ao aplicativo e ao painel. O registro não é excluído — todos os dados, vínculos e histórico permanecem intactos.

O botão "Arquivar" aparece no canto superior direito da tela de edição, ao lado do nome da pessoa. Ao clicar, um dialog de confirmação informa que o acesso ao aplicativo será desabilitado e pede confirmação antes de prosseguir.

Restrições ao arquivamento:

• O gestor proprietário da escola não pode ser arquivado por nenhum gestor.
• Um gestor não pode arquivar a própria conta.
• Professores e responsáveis podem ser arquivados por qualquer gestor com a permissão "Usuários".

Após o arquivamento, a pessoa desaparece das listas ativas de Gestores, Professores ou Responsáveis e passa a aparecer em Sistema > Arquivados > Usuários.

Desarquivar reabilita o acesso. O processo pode começar em dois lugares:

1. Na própria tela de edição do usuário arquivado. O botão "Arquivar" muda para "Desarquivar" quando o registro já está arquivado.
2. Em Sistema > Arquivados > Usuários. Ao abrir o detalhe de um usuário arquivado, a tela exibe os dados em modo somente leitura e apresenta o botão "Desarquivar usuário".

Após o desarquivamento, a pessoa volta para a lista ativa correspondente, em Gestores, Professores ou Responsáveis, com todos os vínculos e permissões anteriores preservados.

Para responsáveis arquivados, a tela de arquivados ainda mostra os alunos vinculados com links clicáveis para os perfis deles — útil para revisar antes de decidir se vai desarquivar.

---