Cursos e turmas de IAT

Rascunho — ainda não verificado em hml

Escrito a partir do código, sem percorrer as telas em hml. Nomes de campo e ordem de passos podem divergir do que a interface mostra. Ao validar, corrija o que estiver diferente e remova este aviso.

Objetivo

Criar uma turma, acompanhar a presença e entregar o certificado ao aluno.

Antes de começar

O módulo fica em /<slug>/iat, com um painel em /<slug>/iat-dashboard.

Entenda a hierarquia antes de clicar em qualquer coisa — quase todo erro aqui vem de confundir os dois níveis:

• Curso é o molde: nome, entidade formadora, e o template do certificado. Cadastra-se uma vez.
• Turma é uma oferta daquele curso: período, local, vagas, alunos. Repete-se quantas vezes você quiser.

Passos

1. Cadastrar o curso (uma vez só)

Informe o nome (ex.: Curso de Tiro Defensivo) e a entidade formadora (ex.: Academia Nacional de Polícia).

Escolha o Template do Certificado. Sem seleção, o curso usa o modelo padrão do clube. Vale conferir agora: template errado só aparece na hora de emitir, com o aluno esperando.

2. Abrir a turma

Escolha o curso e preencha identificação (ex.: 01/2026), nome (ex.: Turma Básico Janeiro), local (ex.: Stand de Tiro Central) e vagas — deixe em branco para ilimitado.

3. Matricular alunos

Matricule por CPF. O aluno precisa estar cadastrado como cliente do clube — se o CPF não for encontrado, cadastre a pessoa primeiro, conforme Cliente novo e acesso ao portal.

4. Presença

O aluno faz o próprio check-in pelo portal, em /<slug>/portal/cursos, e o sistema captura a localização no momento — funciona igual no navegador e no aplicativo Android.

Do lado do operador, a turma mostra a presença de cada aluno como presentes/total e o percentual. A turma pode exigir um percentual mínimo de presença: abaixo dele o aluno não fica elegível ao certificado.

Se o check-in do aluno falhar — sem sinal, GPS negado, celular sem bateria — a presença é corrigida pelo operador na própria turma. Não deixe para o dia da emissão.

5. Emitir o certificado

Com a presença fechada, emita o certificado. A confirmação é Certificado emitido!.

Se algo impedir a emissão, o sistema avisa explicitamente que o status foi atualizado mas o certificado não saiu — leia esse aviso quando aparecer, porque é a diferença entre “concluído” e “concluído com certificado”.

Certificado emitido por engano pode ser revogado.

6. Confirmar do lado do aluno

O aluno vê o certificado dele em /<slug>/portal/certificado.

Como saber que deu certo

• A turma mostra a presença de cada aluno e quem está elegível.
• A emissão confirma com Certificado emitido!, sem aviso de falha.
• O aluno abre /<slug>/portal/certificado e o documento está lá — vale conferir o nome e a data no documento gerado.

Se der errado

O aluno não consegue fazer check-in. Peça para ele autorizar a localização no navegador ou no aplicativo. Persistindo, registre a presença manualmente pela turma — não trave a turma por causa disso.

O aluno não fica elegível ao certificado. Compare a presença dele com o percentual mínimo da turma. Se houver falha de check-in não corrigida, corrija antes de emitir.

“Status atualizado, mas o certificado NÃO foi emitido”. A conclusão foi gravada e a emissão falhou. O texto do aviso traz o motivo. Resolva e emita de novo — não repita a conclusão.

O certificado saiu com o modelo errado. É o Template do Certificado do curso, não da turma. Corrija no curso, revogue o certificado e emita de novo.