Skip to content

Configuração inicial — passo a passo

O que é este documento — o roteiro completo para colocar uma escola no ar no ionCLASS, do zero. Cada etapa tem uma página própria com os campos e telas em detalhe. Faça na ordem: cada passo depende do anterior.

A hierarquia que você vai montar

O ionCLASS organiza os dados em uma hierarquia estrita, com isolamento total entre escolas:

Grupo Escolar (rede)
└── Escola (site)
    ├── Pontos de retirada (portões)        ← toda escola tem ≥ 1
    ├── Motivos de saída antecipada
    ├── Turmas ──────────────┐
    │   └── Janela de retirada por dia
    └── Alunos ──────────────┘  (aluno pertence a 1+ turmas)
        └── Responsáveis (N:N)

Uma escola avulsa é apenas um grupo de uma escola só — você ainda cria o grupo primeiro.

Os 5 passos

#PassoO que você criaPágina
1Grupo e EscolaA rede e a primeira escola, com timezone, geofencing, modo de retirada e os portõesAbrir →
2Turmas e horáriosAs turmas (com turno) e a janela de retirada de cada dia da semanaAbrir →
3Alunos e responsáveisOs alunos (matrícula + foto) e os responsáveis vinculados — manual, CSV ou roster do controle de acessoAbrir →
4Usuários e operadoresAs contas da equipe: administradores e operadores de portariaAbrir →
5Primeiro acesso do operadorA work config do operador no Monitor (turmas + portões que ele cobre)Abrir →

Depois desses passos, conecte o hardware em Integrar o controle de acesso.

Checklist de configuração

Use como lista de verificação ao terminar:

  • [ ] Grupo Escolar criado e ativo
  • [ ] Escola criada, com timezone, coordenadas + raio de geofencing e modo de retirada definidos, e ativada
  • [ ] Pelo menos um ponto de retirada (portão) cadastrado na escola
  • [ ] Motivos de saída antecipada cadastrados (opcional, mas recomendado)
  • [ ] Turmas criadas, cada uma com turno e janela de retirada
  • [ ] Alunos cadastrados com matrícula e foto (obrigatórias) e vinculados a turma(s)
  • [ ] Responsáveis pré-cadastrados e vinculados aos alunos
  • [ ] Usuários da equipe criados (administradores)
  • [ ] Operador(es) criados e escopados à escola
  • [ ] Operador fez o primeiro acesso e salvou a work config
  • [ ] (Opcional) Integração de controle de acesso configurada e testada
  • [ ] (Opcional) Token do Painel Público gerado

Regras que valem para tudo

  • Matrícula e foto do aluno são obrigatórias. A matrícula é a chave de negócio — é ela que casa o aluno com o hardware de controle de acesso.
  • Cada escola é um silo. Um operador ou administrador de escola só enxerga a escola dele.
  • Operador não é gestor. Ele opera a portaria, mas não cadastra escolas, turmas ou usuários.

O que vem depois da configuração

  • Integrações — conectar a controladora (opcional; sem ela, a retirada funciona no modo manual/operador).
  • Superfícies — entender cada tela do produto.
  • Operação — rodar em produção com tempo real e tarefas agendadas.

Documentação do ionCLASS