Curso Implantar a escola · aula 4 de 9
Unidades
Cadastre uma unidade dentro da instituição, veja os detalhes e o plano, edite dados, cores e locais e ative ou arquive pelo menu.
Abas da lista: Todos | Ativos | Inativos | Arquivados | Rascunhos (fotos e plano 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 descer um nível? A unidade fica dentro da instituição (a "mãe"). As unidades podem ser do mesmo tipo ou de tipos diferentes: uma escola regular, outra escola de inglês. Ela tem vida própria: cuida da sua equipe, das suas turmas e dos seus perfis. A instituição só manda no que marcou como obrigatório (design, atividades obrigatórias).
Para que serve
- Cadastrar uma unidade nova dentro de uma instituição.
- Ver os detalhes ("Detalhes da unidade") e o "Plano efetivo".
- Editar dados, cores, locais e o plano.
- Transferir a unidade de instituição.
- Ativar ou arquivar pelo menu ⋯ (e restaurar uma unidade arquivada).
- No app da instituição, o ⋯ traz Solicitar inativação: quem arquiva é a equipe Coelo (como pedir).
Para quem (perfis e plano)
- Ver lista e detalhe:
units.read. - Criar:
units.create(botão "Criar unidade"). - Editar e ciclo de vida (⋯):
units.update. - Mudar o plano da unidade:
units.plan.manage. Sem ela aparece "Sua conta não pode alterar o plano; ele fica como está." - Locais:
locations.read. - Administrador só da instituição não gere pessoas da unidade sem vínculo nela.
- O servidor bloqueia os recursos que o plano não libera.
- Criar pessoa pela Direção só de unidade conferindo o perfil pelas capacidades da própria unidade (005900). Perfis padrão alinhados aos modelos aprovados (006000). Ambas aplicadas.
Como chegar (menu)
Menu Estrutura › Unidades (ordem: Instituições, Unidades, Trilhas, Turmas, Atividades, Avaliações).
Passo a passo
Lista
A lista tem as visões "Agrupado", "Por turmas" e "Por atividades". Clique numa unidade para abrir os detalhes.
Criar
- Clique em "Criar unidade".
- Siga as etapas com "Continuar" ("Anterior" volta):
- "Hierarquia" — "Instituição", "Nome da unidade", "Tipo", "Status operacional".
- "Identidade" — fotos e cores; cada parte pode ser herdada da instituição ou personalizada.
- "Perfil da unidade" e "Liberação do perfil" — o que as famílias veem e quem pode acompanhar.
- "Localização e contato" — "Buscar CEP", endereço e contato.
- "Mapa e locais" — o catálogo de locais da unidade.
- "Representantes legais" e 7. "Administradores" — veja a atualização de 19/10/2026 abaixo.
- "Plano" — deixe ligado "Herdar plano da instituição" ou desligue e escolha um cartão de plano para ter um "Plano específico desta unidade".
- "Revisão" — clique em "Criar unidade".
Detalhe
"Detalhes da unidade" mostra "Dados da unidade", "Endereço", "Contato" e "Plano efetivo", com a "Origem": "Herdado da instituição" ou "Definido na unidade".
Editar
- No ⋯ da unidade, escolha "Editar". A tela vira "Editar unidade".
- Em "Identidade" aparece "Definido pela instituição" ("O que a instituição sugere ou exige nesta unidade."). Com o design obrigatório, a unidade não troca fotos e cores.
- A instituição não muda no formulário: use "Transferir de instituição", escolha a "Instituição de destino" e clique em "Transferir".
- Termine com "Salvar alterações".
Locais
Na etapa "Localização", abra o catálogo de locais. Lá ficam os "Locais internos da unidade"; use o cartão "Criar local" ou "Trazer da instituição" para copiar um local da instituição.
Ativar/arquivar
Use o menu ⋯ da unidade no diretório (ou no alto do Editar). As ações são "Editar", "Ativar", "Arquivar" e, na arquivada, "Restaurar". Não existe "Inativar" avulso. Arquivar pede um motivo e mostra antes o que será afetado; veja Unidades: arquivar, restaurar e excluir.
Deu errado?
| Mensagem | O que fazer |
|---|---|
| "Toda unidade pertence a uma instituição. Crie uma instituição antes de criar a unidade." | Clique em "Ir para instituições" e crie uma. |
| "Identificador já usado nesta instituição." | Troque o identificador (@). |
| "Informe um CEP com 8 números." | Digite só os números. |
| "Transferência bloqueada: resolva as dependências marcadas antes." | Resolva os itens marcados e tente de novo. |
| "Não há outra instituição disponível para receber esta unidade." | Crie ou ative a instituição de destino. |
| "O contexto mudou. Reabra o formulário para continuar." | Feche e abra a tela de novo. |
| "Você não tem permissão para salvar esta unidade." | Peça o perfil com units.update. |
| "Sua conta não pode alterar o plano; ele fica como está." | Peça units.plan.manage, se precisar. |
Dicas
- Na dúvida, deixe "Herdar plano da instituição" ligado: o plano muda junto com a instituição.
- "A instituição ainda não tem plano": defina o plano na instituição primeiro.
- Tipo que não existe? Use "Solicitar tipo de unidade".
Como saber que deu certo
A tela volta à lista com a unidade nova. No detalhe, o "Plano efetivo" mostra o plano e a origem certos.
Novidades de 19/10/2026 — representantes, administradores e Arquivos
E aí, o que mudou em Unidades em 19/10? Conferido em
packages/coelo_feature_units/lib (commit 4f0ef4dda). as partes que usam migrations ainda não publicadas só
aparecem no app oficial depois da publicação.
- Representantes legais: etapa nova no Criar e no Editar, com o texto "Pessoas legalmente responsáveis pela unidade. Com conta, viram administradores desta unidade." Botão "Adicionar representante legal"; a primeira pessoa fica como "Representante legal principal". Sem ninguém: "Nenhum representante legal cadastrado."
- Administradores: etapa "Administradores" ("Quem administra só esta unidade."), botão "Adicionar administrador" e o campo "Nível" (sem Admin Master). A nota explica: "O administrador da unidade só vê e gere esta unidade. Os administradores da instituição continuam valendo aqui." Cada unidade cuida das suas pessoas (regra 0011).
- Só leitura: quem enxerga mas não administra a unidade vê "Sua conta vê estas pessoas, mas só quem administra a unidade (ou a equipe Coelo) pode mudá-las."
- Conflito: se outra pessoa mudou as duas listas enquanto você editava, a unidade é salva e aparece "A unidade foi salva, mas outra pessoa mudou os representantes ou administradores. Reabra a unidade e tente de novo."
- Arquivos: Importar, Exportar CSV e Exportar XLSX pelo botão Arquivos; a exportação segue a busca e a instituição escolhida no filtro.
- Filtros numa linha: em tela larga (1440 px) os filtros da lista cabem numa linha só. No celular, a coluna Ações da tabela fica fixa à direita.
Novidades de 24/10/2026 — passo "Dias letivos"
O cadastro da unidade ganhou o passo Dias letivos, depois do Plano: o número de dias de aula de cada ano e a chave Obrigatório para as turmas, ano a ano. Se a instituição deixou o ano obrigatório, a unidade vê o número travado ("Unidades e turmas não alteram 2027.", por exemplo). Veja Dias letivos.
Novidades de 31/10 e 01/11/2026
- Ao concluir o cadastro a unidade já nasce ativa. "Em implantação" virou uma escolha, para quem ainda vai preparar a unidade antes de abrir.
- @ curto: a unidade mostra só o @ curto (ex.:
@centro). Tocar no @ mostra o completo, que leva junto o @ da instituição; essa parte final é automática, não dá para editar e muda sozinha quando a instituição troca o @. O @ aceita letras, números, ponto, hífen e sublinhado (3 a 50) e se preenche enquanto você digita o nome. A primeira troca é livre; depois, uma a cada 30 dias. - Tipo de unidade (escola, academia, estúdio de dança…) e Vínculo com a instituição são campos separados. Não achou o tipo? Solicitar tipo de unidade abre um chamado no Suporte.
- Foto e capa já nascem liberadas; os administradores vêm do representante quando você marca "também administrador".
- Dias letivos são opcionais: a chave "Usar dias letivos" liga e desliga.
- Ver prévia completa (no topo, à direita do título) mostra o perfil como fica no celular: capa, foto com contorno, nome, @, Bio formatada e Sobre.
- Planilha de Unidades: as colunas seguem a ordem das etapas do cadastro e o modelo de importar é igual ao arquivo exportado. O @ vem em três colunas (@ curto editável, @ da instituição só leitura, @ completo). Tipo, Bio, Proposta, Etapas e Dias letivos gravam pelo arquivo; Representantes e Administradores vêm só para leitura. Exporte de novo antes de importar: arquivos antigos (antes de 01/11) não servem mais.
Novidades de 15/11/2026 — presta atendimento e vínculos com o Criar no alto
Presta atendimento. No Editar unidade, passo Cadastro, há a chave Presta atendimento ("Ligado, a unidade entra em Atendimentos: pedidos das famílias, marcação e profissionais."). Ela aparece só para a unidade já salva e grava na hora ("Pronto: a unidade agora presta atendimento." / "Pronto: a unidade deixou de prestar atendimento."). Só a unidade que presta atendimento entra em Atendimentos; a família só vê o atalho de Atendimento quando a unidade da criança presta atendimento.
Vínculos da unidade. Nos passos de vínculo do Editar unidade:
- Turmas da unidade e Atividades da unidade: o cartão Criar turma / Criar atividade fica no alto, antes da tabela (abre Estrutura › Turmas ou Atividades com a unidade escolhida). Com a unidade inativa: "Ative a unidade para criar turmas: turmas e atividades só se vinculam a unidades ativas."
- Toda linha tem foto de perfil; a atividade sem foto mostra o ícone de atividade.
- Vincular pessoas: o cartão Convidar pessoa ("Envie um convite para
alguém entrar nesta unidade.") fica no alto, para quem pode convidar
(
invites.manage). - Vincular profissionais já tinha o cartão Vincular profissional no alto.
Quer guardar o progresso e ganhar o certificado? Entre com a sua conta do Coelo.
Veja também
- 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
- Cadastro da instituição no Coelo: dados e locaisCadastre 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
- 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