Manual do Usuário

1Visão geral

O Ganha Tempo (ganhatempo.semecol.com.br) é o agendamento de atendimentos da Prefeitura Municipal de Colíder. Ele substitui as telas do aplicativo antigo (/prefcol, /ganha_tempo, controle, administração e guichê) e trabalha nas MESMAS tabelas: o aplicativo antigo continua funcionando ao mesmo tempo.

2Acesso e login

A gestão fica em ganhatempo.semecol.com.br/gestao/ (ou no link "Acesso do atendimento" no rodapé da página pública). Entre com e-mail e senha: vale qualquer e-mail (não só @edu). A página exige permissão no módulo prfgte.

Os níveis 1 a 3 valem nos locais marcados no seu usuário (todos os serviços do local) e nos serviços em que você está como atendente.

3Conhecendo a tela

À esquerda fica o menu (minimize com Minimizar; ele lembra o estado). Embaixo aparecem o seu e-mail, o nível e o botão de tema claro/escuro (sol/lua; o padrão segue o sistema). No topo de cada aba fica o cabeçalho com os filtros e botões da aba. No celular, as abas principais ficam na barra do topo e as demais no menu ⋮.

Os seletores de Serviço das abas lembram o último escolhido.

4Atendimento

Mostra os agendamentos do serviço. Por padrão: só o dia de hoje e só os agendados (a atender). Em Filtros escolha outro dia, "do dia em diante", "todas as datas" e a situação. A busca procura nome, CPF (com ou sem pontos), protocolo, telefone e e-mail. A lista se atualiza sozinha a cada 30 segundos.

1. Seu guichê: clique em Guichê e informe o número (fica gravado no seu cadastro, o mesmo do app antigo).
2. Chamar: o nome e o guichê aparecem no painel da TV e a voz chama a pessoa. Pode chamar de novo quantas vezes precisar.
3. Atendido ou Ausente: confirma e (opcional) escreve uma observação. Não dá para desfazer.
4. Cancelar (nível 3 ou 4): escreva o motivo; marque "Devolver o horário e avisar a pessoa" para o horário voltar para a agenda e a pessoa receber o aviso.
5. Reagendar: escolha a nova data; aparecem os horários livres daquele dia. Clique num horário livre, ou digite qualquer horário: se ele não estiver livre, vira encaixe (marcado em laranja) e, quando a agenda daquele dia for aberta depois, esse horário é tirado dela sozinho. A pessoa é avisada (notificação ou e-mail).
6. Avisar (sino): manda uma mensagem à pessoa — no aparelho em que ela ativou os avisos e, se não der, no e-mail. Mostra também os avisos anteriores e se foram entregues.
7. Histórico assinado (selo): todos os passos do agendamento com a assinatura digital e o link de verificação.

Os selos do cartão: Encaixe, Reagendado, CIN chegou/entregue e o sino azul com o número de aparelhos com aviso ativo. Os campos extras do serviço aparecem embaixo do nome. Excel exporta a lista (até 500).

5Agenda (dias e horários)

Escolha o serviço e o mês. Cada dia mostra quantos horários estão livres (verde), agendados (azul) e atendidos. Dia hachurado = agenda inativa.

1. Clique nos dias que quer abrir (eles ficam marcados).
2. Em Abrir agenda, escolha o modelo de horários e clique em Aplicar.
3. Dia que já tinha agenda é substituído pelo modelo, sem devolver horários já agendados (o app antigo devolvia).

Clicando num dia com agenda, o quadro Dia mostra os horários livres, quem está agendado e o botão Inativar agenda / Ativar agenda (o dia some/volta para quem agenda; os agendamentos já feitos continuam).

6Documentos recebidos (CIN)

Quando as carteiras de identidade (CIN) chegam, registre cada uma lendo o QR do documento:

1. Clique em Ler QR. No celular, a câmera de trás abre sozinha: aproxime o QR até ficar nítido no quadro. No computador, use o leitor de código (bip): o cursor já fica no campo e a leitura é conferida sozinha. Também dá para tirar uma Foto do QR ou colar o texto.
2. O sistema lê o CPF, a data de nascimento e a validade do documento e procura os agendamentos daquele CPF.
3. Escolha onde registrar: no agendamento (o mais recente vem marcado) ou Sem agendamento (informe o serviço e, se quiser, nome, e-mail e telefone para avisar).
4. Deixe marcado Avisar a pessoa para mandar a notificação (ou o e-mail) e clique em Registrar a chegada. O leitor volta para o próximo documento.

A lista mostra os documentos do serviço (só os não entregues, ou todos). Botões: Entregue, Avisar (lembrete) e, nível 3/4, Desfazer entrega. Ler o mesmo CPF de novo não duplica.

7Restrições por CPF

Enquanto a restrição estiver ativa e dentro da data, o CPF não consegue agendar naquele serviço (a página mostra a data final e o motivo). Clique em Nova restrição, informe CPF, data de término e motivo. Para tirar antes da data, edite e mude para Inativa. Restrição vencida não bloqueia mais.

8Modelos de horário

O modelo é a lista de horários de um dia. Em Novo modelo: nome, entrada e saída de manhã e de tarde, minutos por atendimento e número de atendentes; clique em Gerar horários (como o app antigo) e, se quiser, clique num horário para tirar (ex.: intervalo). Os modelos são os mesmos do app antigo.

9Serviços, locais e painel do guichê

Serviços

• Aparece na página pública: desmarque para esconder o serviço de quem agenda.
• Orientações: documentos necessários e avisos que a pessoa lê (e confirma "Li e estou de acordo") antes de agendar. Linha que começa com "* " vira item de lista; endereços https viram link.
• Campos extras do passo "3. Dados": além de nome, CPF, telefone e e-mail, crie campos com rótulo, tipo (texto, texto longo, número, data, e-mail, telefone, CPF, lista de opções, sim/não), obrigatório, máscara (CEP, NIS, placa, cartão SUS ou personalizada: # = número, A = letra), mínimo/máximo e texto de ajuda. A chave identifica o campo nos dados gravados: não mude depois de haver agendamentos.
• Quem atende (nível 4): as pessoas que atendem no serviço mesmo sem ter o local inteiro na permissão.

Locais (nível 4)

Nome e endereço. Cada local novo já ganha o seu painel do guichê.

Painel do guichê

Em cada local, Painel do guichê mostra o endereço da TV (copie e abra no navegador da TV, em tela cheia) e o carrossel: imagens, vídeos (.mp4) ou YouTube, com o tempo de cada imagem (padrão 5 s). "Gerar um endereço novo" invalida o antigo (use se o endereço vazar).

Configurações gerais (nível 4)

Antecedência para agendar no mesmo dia (minutos), antecedência para cancelar pela internet (horas), aviso de "sem vagas", chave pública das notificações (VAPID), endereço do n8n e endereço público.

10Painel do guichê (TV)

Mostra o guichê e o nome de quem foi chamado (bem grande, piscando), as últimas chamadas do dia, o relógio, um QR para agendar e o carrossel do local.

• A voz fala "Nome. Guichê N." duas vezes, depois do som de chamada. É a voz neural em português (a mesma do painel de atribuição): o modelo (cerca de 63 MB) começa a baixar sozinho ao abrir o painel e fica guardado no navegador; enquanto baixa, fala com a voz do navegador.
• Os navegadores só deixam tocar som depois de um clique: ao abrir, clique uma vez na tela ("ativar o som"). Na TV com o Chrome aberto com --autoplay-policy=no-user-gesture-required, o som já sai sem clique.

11Página pública: agendar, consultar e cancelar

1. 1. Serviço: local, serviço, orientações ("Li e estou de acordo") e CPF. O sistema já avisa se o CPF tem restrição ou já tem agendamento em aberto no serviço.
2. 2. Horário: os dias com vaga e, no dia, os horários livres (no mesmo dia, só com 4 horas de antecedência).
3. 3. Dados: nome completo, telefone, e-mail (recomendado) e os campos extras do serviço.
4. 4. Confirmar: ao confirmar, o navegador pergunta se a pessoa quer receber avisos neste aparelho. Sem permissão, os avisos vão para o e-mail.

O comprovante mostra o protocolo, um QR que abre o próprio comprovante, a forma de aviso e o histórico com assinatura digital. Em Meus agendamentos, pelo CPF: ver o comprovante, ativar os avisos no aparelho e cancelar (com um código de 6 números enviado ao e-mail do agendamento; até 24 h antes).

12Assinatura digital e verificação

Cada passo do agendamento gera um documento assinado com a chave institucional do SIGEEDU (SIGEEDU Sign): agendamento feito, atendido, ausente, cancelado, reagendado, CIN recebida e entregue. Quando o passo é feito por um atendente, ele também assina (nome, função, portaria e lotação do cadastro). Os documentos de um agendamento formam uma corrente: cada um aponta o anterior, então apagar ou trocar um do meio é percebido.

Qualquer pessoa confere em assinatura.semecol.com.br/verificar.html com o código (ex.: 7K3D-QF9A-2MXC). O CPF aparece mascarado; e-mail, telefone e o texto da observação não entram no documento.

Vale também para o que for feito pelo aplicativo antigo (a assinatura é feita pelo banco).

13Usuários (nível 4)

1. Novo usuário → digite o e-mail (qualquer domínio) → Conferir.
2. Se a pessoa já tem conta no SIGEEDU, só complete os dados e a permissão. Se não tem, defina a senha inicial (8+ caracteres, maiúscula, minúscula, número e especial).
3. Dados: nome, CPF, telefone, matrícula (servidor do município), função, portaria, lotação, foto (endereço https), guichê, nível, locais e serviços em que atende.

O nível também é gravado para o aplicativo antigo continuar igual. "Só no app antigo" na lista = a pessoa tem permissão só pelo app antigo (salve para passar a valer aqui).

14Relatórios

Relatórios abre, em outra aba, o relatório do SIGEEDU com a sessão atual (filtros, colunas e exportação).

15Atividade e log

Online agora (todos): quem está com a gestão aberta, em qual aba e fazendo o quê. Registro de atividades (níveis 3 e 4): quem fez o quê e quando — agendamentos (inclusive pelo app antigo e pela página pública), atendimentos, reagendamentos, chamadas no guichê, agenda, serviços, locais, restrições, CIN, usuários e painel. Filtros por período, pessoa, ação e texto; "acompanhar ao vivo"; Excel (até 5.000 linhas).

16Mensagens do sistema

17Perguntas frequentes

O aplicativo antigo continua funcionando?

Sim. Os dois usam as mesmas tabelas.

Por que o horário "sumiu" da agenda depois que reagendei para fora da agenda?

É o encaixe: quando a agenda daquele dia é aberta, o horário ocupado pelo encaixe é tirado sozinho.

A pessoa não recebeu o aviso no celular.

Ela precisa ter permitido os avisos naquele aparelho (e, no iPhone, abrir pela tela de início). Sem isso, o aviso vai para o e-mail.

A data "dvd" da identidade é a emissão?

Não: é a validade do documento (fica gravada como validade).

18Novidades (12/11/2026)

Página de agendamento

• Acesso administrativo no topo leva à gestão.
• No celular, os passos (1 Serviço · 2 Horário · 3 Dados · 4 Confirmar) e os botões Voltar/Continuar ficam sempre à vista ao rolar; o caminho entre os passos se preenche.
• Botão Ajuda (canto de baixo): abre o passo a passo animado de como agendar (ajuda.html).
• Os dias aparecem com o nome completo (Segunda, Terça...) e os horários separados em manhã e tarde.

Serviços e locais

• Quadro "Antes de agendar" por serviço: título, frase para marcar e se a pessoa precisa marcar. As orientações têm botões de negrito, itálico, título, lista, lista numerada, destaque e linha, e a prévia mostra como fica na página.
• Painéis do guichê: cada painel chama os serviços marcados nele (um painel para vários serviços, ou um para cada). Cada painel mostra o seu endereço da TV, com o botão de copiar.
• Imagens e vídeos dos painéis (nível 3 e 4): carrossel, imagem do mês, fundo e cor, iguais em todos os painéis. Começam com as do quiosque (kim_locais 1); os arquivos enviados ficam no Storage (bucket prf, pasta kim-imagens). "Voltar ao padrão" volta às do quiosque.
• Mensagens automáticas (nível 4): o texto de cada mensagem e a ordem dos canais.

Mensagens à pessoa

Tudo passa pela fila do n8n (no máximo 4 WhatsApp por minuto, para o número não ser bloqueado). O histórico de cada aviso fica no agendamento.

Agenda

• Embaixo da legenda do mês: vagas cadastradas, ocupação, atendidos, agendados, ausentes e livres.
• Excluir a agenda dos dias escolhidos (nível 3 e 4): o dia que tem pessoa agendada não é excluído; ela aparece na lista com o botão Reagendar.
• No painel do dia, clique nos horários livres para marcar e use Tirar os horários marcados.

Documentos recebidos (CIN) em lote

Abra o leitor e vá passando as identidades (câmera ou leitor de código): cada QR novo dá um bip e é gravado na hora; o mesmo QR não é lido de novo (bip grave). A câmera e o cursor continuam esperando o próximo. O aviso vai na hora (opção "Avisar a pessoa logo ao ler") ou depois, no botão Avisar os lidos.

Usuários

O nível 3 também cadastra e edita pessoas com nível 1, 2, 3 ou 5, só nos locais/serviços em que ele configura; o nível 4 faz tudo. Nome, CPF (conferido) e telefone são obrigatórios. A foto é escolhida do computador/celular e guardada no Storage (bucket prf, pasta fotos_prf). As listas de locais e serviços têm busca.

Dashboard

Números e gráficos dos atendimentos no período: por dia (clique na legenda para esconder uma situação; passe o mouse para ver o detalhe), situação, serviço, horários mais procurados, dias da semana, mensagens e documentos.

19Novidades (13/11/2026)

Ajuda em cada tela

O botão Ajuda (canto de baixo) abre o passo a passo animado da tela aberta: Atendimento, Agenda, Documentos recebidos, Restrições por CPF, Modelos de horário, Serviços e locais e Usuários. Também abre em outra aba (gestao/ajuda.html).

Atendimento

• Os botões de cada pessoa têm a mesma altura.
• Em lote: marque as pessoas (ou Selecionar todos) e use a barra: Atendido, Ausente, Reagendar ou Cancelar para todas de uma vez. No reagendar em lote, cada pessoa vai para o próximo horário livre do novo dia, a partir da hora escolhida.

Documentos recebidos

Marque vários e use Marcar entregue ou Avisar. O nível 4 também pode Excluir um registro lançado errado (some da lista e fica no log de atividade).

Dashboard

Período Todo o período (períodos longos aparecem por mês) e o gráfico Por atendente (atendidos, ausentes e cancelados por quem marcou).

Serviços e locais

• Mensagens automáticas: os níveis 3 e 4 editam títulos e textos; a ordem de envio continua só do nível 4. O aviso no aparelho (para quem ativou) vai sempre junto.
• Configurações gerais: o nível 3 muda as antecedências (agendar e cancelar) e as horas do lembrete. Novas: SMS por minuto e e-mails por minuto (nível 4).
• No serviço: Wi-Fi público (rede e senha) para aparecer no painel da TV, com QR para conectar.

Modelos de horário e usuários

• Modelo inativo some da Agenda (os dias já abertos continuam). O × em cada horário gerado tira o horário do modelo.
• Usuário inativado fica sem acesso ao Ganha Tempo (locais e serviços guardados); reativar volta ao nível de antes. A conta e os outros sistemas não mudam.

Página de agendamento e painel

• Modo escuro: o quadro "Antes de agendar" e o dia/horário escolhidos ficam bem visíveis (verde com ✓).
• Comprovante impresso no padrão institucional (brasão, quadros, assinatura digital com QR). O e-mail do comprovante traz os dados em um quadro.
• Painel da TV: imagens com cantos arredondados, troca suave e bolinhas que mostram qual imagem está passando; imagem do mês sem fundo; status da voz embaixo do logo, à direita.

20Glossário