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.
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 trazinstitutions.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.updateeinstitutions.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
- Na lista, clique em "Criar instituição".
- Siga as etapas, sempre com "Continuar" (e "Anterior" para voltar):
- "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.
- "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á.
- "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.
- "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.
- "Mapa e locais": botão "Abrir mapa e locais" para o catálogo.
- "Representantes legais": "Adicionar representante legal".
- "Administradores": "Adicionar administrador"; depois "Enviar convite por e-mail" ou "Gerar link de convite".
- "Plano": plano e "Status da assinatura" (ex.: "Iniciar período de teste" e "Término do período de teste").
- "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
- Na lista, abra o ⋯ da instituição e escolha "Editar".
- A tela vira "Editar instituição", com as mesmas etapas; salve com "Salvar alterações".
- 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".
- Ao sair com mudanças, a pergunta "Alterações não salvas" oferece "Salvar e sair", "Sair sem salvar" ou "Cancelar".
Locais
- Em "Mapa e locais", clique em "Abrir mapa e locais".
- 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.").
- 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").
- 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." - 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."
- 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). - 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.
- 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
- Como pedir uma nova instituição ao CoeloPeça à equipe Coelo uma nova instituição, como outro CNPJ do grupo, ou a inativação da sua, e acompanhe a resposta pelo sino.3 min
- Unidades no Coelo: criar, editar e arquivarCadastre uma unidade dentro da instituição, veja os detalhes e o plano, edite dados, cores e locais e ative ou arquive pelo menu.9 min
- Arquivar, restaurar ou excluir uma unidadeUse o menu da unidade para arquivar quando ela parar, restaurar se voltar a funcionar e entenda quando a exclusão é possível.2 min
- Como pedir uma nova unidade ao CoeloPeça à equipe Coelo para abrir mais uma unidade na instituição ou inativar uma que vai fechar, e acompanhe a resposta pelo sino.3 min