Pular para o conteúdo
FaCoelo
Entrar

Curso Implantar a escola · aula 2 de 9

Instituições

Cadastre e edite a instituição, com CNPJ, endereço, cores, plano e locais, e decida o que as unidades recebem dela como obrigatório.

11 min de leitura Estrutura › InstituiçõesAtualizada em

Abas da lista: Todos | Ativos | Inativos | Arquivadas | Rascunhos (a antiga "Em implantação" faz parte de Rascunhos; logo, capa, CNPJ/CPF e representantes não ficam no rascunho), cada uma com o total. Sair de um Criar sem concluir oferece Salvar rascunho; o rascunho volta pela aba Rascunhos. Veja Abas das listas e Sair sem salvar e rascunho.

O que é

E aí, vamos começar pelo topo da estrutura? A instituição é a "mãe", a entidade principal inteira: nome, documento (CNPJ), endereço, cores, plano e quem responde por ela. Tudo o que vem depois (unidades, trilhas, turmas, atividades e avaliações) mora dentro de uma instituição.

E aí, como as peças se encaixam? A cadeia é instituição → unidades → trilhas (ou "Sem trilha") → turmas → atividades, e a avaliação vale para uma turma ou para uma atividade. O desenho e a ordem de montagem estão em projeto do zero.

Para que serve

  • Cadastrar uma instituição nova no Coelo, em etapas guiadas.
  • Ajustar os dados depois ("Editar instituição").
  • Organizar o catálogo de locais (salas, quadras, locais externos).
  • Ativar, arquivar, restaurar ou migrar pelo menu ⋯.
  • Decidir o que as unidades recebem da instituição, como o "Design obrigatório nas unidades".

Para quem (perfis e plano)

  • Ver a lista: equipe Coelo (plataforma, com platform.read). No painel da instituição, só quem tem o acesso ao painel na instituição inteira (a sessão traz institutions.detail.read); professora de turma e direção só de unidade não veem o item nem abrem a rota (desde 17/10; veja a atualização abaixo).
  • Criar: precisa de institution.activate (o botão "Criar instituição" só aparece com ela).
  • Editar: precisa de institution.update e institutions.detail.read. Suporte e Conteúdo, sem a leitura de detalhe, ficam só com a lista.
  • Ciclo de vida (⋯): precisa de institution.status.change.
  • Convite do administrador: precisa de platform.invites.manage ("Só o Owner da plataforma gera este convite.").
  • Locais: precisa de locations.read.
  • Plano: a tela não depende de plano. O servidor bloqueia os recursos que o plano não libera.

Como chegar (menu)

Menu Estrutura › Instituições. A ordem do grupo é: Instituições, Unidades, Trilhas, Turmas, Atividades, Avaliações.

Passo a passo

Criar

  1. Na lista, clique em "Criar instituição".
  2. Siga as etapas, sempre com "Continuar" (e "Anterior" para voltar):
    1. "Identidade": "Foto de perfil", "Foto de capa", "Nome de exibição" e o @. Toda instituição nasce com um @; em branco, o Coelo gera o @ ao salvar. Ao escolher a foto de perfil, o Coelo lê as cores da foto e preenche sozinho "Cores da marca" (principal e secundária) e "Cores de texto". Você pode trocar qualquer cor à mão; depois disso, uma foto nova não muda mais as cores.
    2. "Perfil da instituição": "Nome público", "Nome fantasia", "Razão social", "Tipo de instituição", "Tipo de documento" (agora é uma lista: escolha "CNPJ"), "CNPJ/documento", "Domínio principal", "Fuso horário", "Descrição" e "Links personalizados". Logo abaixo dos links vêm "Proposta pedagógica" e "Etapas e segmentos". Cada um tem o botão de emoji (carinha) ao lado, que põe o emoji onde o cursor está.
    3. "Terá perfil?": a chave "A instituição terá perfil" já vem ligada. Se a instituição tiver só uma unidade, ela terá só o perfil da unidade. Nesse caso, desligue a chave: as famílias veem o perfil da unidade, e o perfil da instituição não aparece no Principal. O @ continua existindo mesmo com a chave desligada.
    4. "Localização e contato": digite o "CEP" e aperte Enter (o endereço se preenche sozinho), confira número e complemento, depois "E-mail institucional", "Telefone"/"Celular", "Site institucional" e "Mostrar local no perfil". O mapa mostra um pino no endereço exato (rua e número). Use os botões + e − no canto do mapa (ou a rodinha do mouse e o toque duplo) para aproximar e afastar. O mapa é gratuito (OpenStreetMap), sem Google.
    5. "Mapa e locais": botão "Abrir mapa e locais" para o catálogo.
    6. "Representantes legais": "Adicionar representante legal".
    7. "Administradores": "Adicionar administrador"; depois "Enviar convite por e-mail" ou "Gerar link de convite".
    8. "Plano": plano e "Status da assinatura" (ex.: "Iniciar período de teste" e "Término do período de teste").
    9. "Revisão": confira e clique em "Criar instituição".

Cores na Comunicação: ao criar um aviso (banner ou popup) da instituição em Comunicação, ele já nasce com as cores do Designer da instituição: fundo na cor principal, texto na cor de superfície e botão na cor terciária. Dá para trocar no próprio aviso.

Editar

  1. Na lista, abra o ⋯ da instituição e escolha "Editar".
  2. A tela vira "Editar instituição", com as mesmas etapas; salve com "Salvar alterações".
  3. Na etapa "Identidade" aparece o painel "Regras para as unidades":
    • "Design obrigatório nas unidades": ligado = "As unidades usam as fotos e cores da instituição e não podem trocar."; desligado = "Cada unidade pode personalizar fotos e cores."
    • "Atividades da instituição": cada uma pode ser "Sugerida" ou "Obrigatória".
    • "Perfis padrão para as unidades": "As unidades copiam estes perfis e ajustam do jeito delas."
    • Os perfis padrão já seguem os modelos aprovados (006000), e a Direção só de unidade cria pessoas com o perfil conferido pela própria unidade (005900).
    • Essas regras salvam na hora, sem esperar o "Salvar alterações".
  4. Ao sair com mudanças, a pergunta "Alterações não salvas" oferece "Salvar e sair", "Sair sem salvar" ou "Cancelar".

Locais

  1. Em "Mapa e locais", clique em "Abrir mapa e locais".
  2. Use o cartão "Criar local" ("Escolha o tipo de local.") e escolha "Local interno" ("Salas, quadras e o que mais existir aqui dentro.") ou "Local externo" ("Fora das dependências, com endereço próprio.").
  3. Preencha "Nome do local" (e o endereço, se externo) e clique em "Criar local" (em um local já existente, o botão é "Salvar local").
  4. No fim do catálogo aparecem os cartões das unidades; cada um abre os locais daquela unidade.

Ciclo de vida (⋯)

No ⋯ aparecem só as ações que o estado permite: "Editar", "Ativar" (para instituição inativa ou em rascunho), "Migrar", "Arquivar" e, para instituição arquivada, "Restaurar" (e "Excluir", só para a equipe da plataforma Coelo, que também exclui rascunho). Não existe "Inativar" avulso: o caminho é Arquivar. Arquivar pede um motivo e preserva histórico, vínculos e mídia. Veja Arquivar e excluir.

Deu errado?

Mensagem O que fazer
"Não foi possível salvar: o CNPJ é obrigatório. Preencha o CNPJ da instituição." Preencha o CNPJ.
"Informe um CNPJ válido." Confira os 14 números.
"Informe pelo menos um telefone ou celular institucional." Preencha um dos dois.
"Informe um CEP com exatamente 8 dígitos." Digite só os 8 números.
"Informe uma URL completa iniciada por http:// ou https://." Corrija o link do site.
"Este @ já está em uso." Escolha outro @.
"Adicione pelo menos um representante legal para concluir o cadastro." / "Adicione pelo menos um administrador para concluir o cadastro." Volte à etapa e cadastre a pessoa.
"A instituição foi alterada por outra pessoa. A lista foi recarregada." Abra de novo e refaça a mudança.
"Alguém alterou estas regras agora. Mostramos a versão atual." Confira as regras e repita.
"Esta atividade ainda está em turmas desta unidade. Encerre as turmas antes de deixar de usar." Encerre as turmas antes.
"Você não tem permissão para alterar esta instituição." Peça o perfil certo à equipe Coelo.

Dicas

  • Fuso horário errado muda todos os horários da instituição. Confira antes de criar.
  • O link do convite só aparece uma vez; para outro, reenvie pela tela Convites.
  • Importar e exportar planilhas já funcionam pelo botão Arquivos (veja a atualização de 19/10/2026 abaixo e Importar e exportar planilhas).
  • Cada unidade continua cuidando das próprias pessoas e perfis.

Como saber que deu certo

A tela volta para a lista com a instituição nova (ou com o status novo). Ao reabrir "Editar", os dados salvos estão lá.

Novidades de 17/10/2026 — menu por permissão

E aí, por que o item Instituições sumiu para algumas contas? Antes, o menu Instituições (e o Catálogo) aparecia para quem tinha platform.read, que é só a entrada do painel: toda sessão do painel tem. Desde 17/10 (commit 6c0e41750) cada um segue a própria permissão, a mesma que o servidor já usava:

  • Instituições: plataforma Coelo; no painel da instituição, só com o acesso ao painel na instituição inteira (institutions.detail.read).
  • Catálogo: só a plataforma; o painel da instituição nunca vê.
  • A rota recusa com a mesma regra, então digitar o endereço não adianta. O servidor já negava antes: era só o menu que mostrava a mais.

Junto, o menu lateral só mostra seta, abertura e lista suspensa quando o grupo tem pelo menos um item que você pode ver (commit 3f633a8da); grupo sem filho visível não abre mais vazio.

Novidades de 19/10/2026 — Migrar, Arquivar com impacto e Arquivos

E aí, o que mudou na lista de Instituições em 19/10? Conferido no código em packages/coelo_feature_institutions/lib. as partes que dependem de migrations ainda não aplicadas na produção (Migrar, o perfil Administrador automático e o ponto do mapa ajustado à mão) só aparecem no app oficial depois da publicação.

  • Migrar (⋯ › Migrar): só aparece para a equipe da plataforma com a permissão institution.migrate, e não aparece em instituição arquivada. A janela "Migrar ?" explica: "Unidades, turmas, atividades e locais vão para outra instituição ativa. Equipe, crianças e famílias ficam aqui."
    1. Escolha o Destino ("Escolha a instituição"). Sem outra instituição ativa, a janela avisa "Não há outra instituição ativa para receber as unidades."
    2. A prévia mostra quantas unidades, turmas, atividades e locais vão, que "Equipe, crianças e famílias continuam em . Nada é apagado.", quantas matrículas são encerradas com o motivo "Turma migrada" e quantas pessoas da equipe perdem o acesso (quem tem conta recebe um convite pendente no destino; o vínculo só nasce quando a pessoa aceita).
    3. Se houver conflito, aparece "Não dá para migrar." com o motivo (por exemplo, nome de atividade ou endereço de unidade que já existe no destino). O botão Migrar fica desligado até a prévia estar liberada.
    4. Ao concluir, aparece "N unidades migradas." (e quantos convites foram enviados).
  • Arquivar mostra o impacto: antes do motivo, a janela diz quantas unidades, turmas, atividades, pessoas da equipe e crianças matriculadas serão afetadas e lembra: "Nada é apagado: histórico, vínculos e mídia ficam guardados e voltam ao Restaurar." Se a contagem não carregar, a janela segue com o texto padrão e o servidor decide.
  • Arquivos (Importar, Exportar CSV, Exportar XLSX): o botão funciona. A exportação segue o que a tela mostra: a busca e a aba de situação.
  • Representante legal e administrador: o cadastro rápido do representante aceita Adicionar foto e o @ (em branco, o Coelo gera o @). O representante legal com conta, e o administrador com conta, recebem o perfil Administrador da instituição: enxerga tudo da instituição e nada da plataforma (decisão D2).
  • Ponto do mapa ajustado à mão: se você arrastar o pino, o Coelo guarda a posição exata que você escolheu (decisão D13).
  • Abrir a lista ficou mais leve: a lista carrega com uma chamada só e os totais de cada aba vêm prontos do servidor.

Novidades de 24/10/2026 — passo "Dias letivos"

O cadastro da instituição ganhou o passo Dias letivos, antes da Revisão: o número de dias de aula do ano atual e dos dois seguintes (Adicionar 2029 vai até 10 anos à frente) e a chave Obrigatório para as unidades, ano a ano. Ano que já passou fica travado; Alterar pergunta antes e recalcula as faltas. Veja Dias letivos.

Quer guardar o progresso e ganhar o certificado? Entre com a sua conta do Coelo.

Veja também