Pular para o conteúdo
FaCoelo
Entrar

Curso Turmas e atividades · aula 3 de 10

Editar e ver turma

Corrija nome, horários e etapa da trilha da turma, inclua ou retire alunos e profissionais e consulte os detalhes sem risco de alterar.

5 min de leitura Estrutura › TurmasAtualizada em

O que é

E aí, vamos mexer numa turma que já existe? São duas telas:

  • "Editar turma" ("Atualize os dados da turma selecionada."): o mesmo formulário por etapas da criação.
  • "Detalhes da turma" ("Consulta dos dados autorizados."): só leitura, para quem pode ver mas não editar.

Para que serve

  • Corrigir nome, @, tipo, status, horários, aparência e etapa da trilha.
  • Incluir ou remover alunos, profissionais e convites.
  • Mover alunos para outra turma (ver a página "Mover alunos").
  • Consultar dados da turma sem risco de alterar.

Para quem (perfis e plano)

  • Detalhe: groups.read.
  • Editar: groups.manage. Sem ela, a rota de edição mostra acesso negado.
  • Vincular aluno: people.assign_children; remover aluno: groups.manage.
  • Direção só de unidade edita turmas da sua unidade (group_read_unit_scope e unit_scope_groups, aplicadas).
  • Inativar e arquivar pela Direção (painel da instituição): decidido pelo Owner em 17/10, aguardando aplicação no servidor (veja a atualização de 17/10 abaixo).
  • Limite por plano: o plano não limita quantidade; só liga e desliga recursos.

Como chegar (menu)

Menu Estrutura › Turmas. Toque no cartão da turma: com groups.manage abre "Editar turma"; só com groups.read abre "Detalhes da turma". Ativar, inativar ou arquivar fica no menu "⋯" do cartão.

Passo a passo

Editar:

  1. Na lista, use "Buscar turma por nome" ou os filtros e toque na turma.
  2. Escolha a etapa no topo: "Hierarquia", "Identidade", "Vínculos", "Pessoas da turma", "Profissionais e admins", "Convites", "Sobre".
  3. Em "Identidade", troque o que precisar, inclusive "Etapa (série ou módulo)".
  4. Em "Pessoas da turma", "Buscar por @, CPF, e-mail ou celular" para incluir aluno, ou "Remover" ao lado do nome.
  5. Em "Convites", "Reenviar" ou "Revogar" — isso só é feito ao salvar.
  6. Toque em "Salvar turma" (ou "Cancelar" para sair sem salvar).

Detalhe:

  1. Abra a turma e confira "Dados da turma" ("Nome", "Instituição", "Unidade", "Tipo", "Status") e "Configuração de herança" ("Aparência", "Acessos", "Atividades": herdados ou próprios).
  2. "Voltar" retorna à lista; "Recarregar" busca de novo.

Deu errado?

  • "Turma não encontrada" — ela pode ter sido removida ou não é do seu alcance. Toque em "Voltar às turmas".
  • "Não foi possível carregar" — use "Recarregar".
  • "Contexto alterado" / "O contexto do formulário mudou. Reabra o formulário para continuar." — alguém mudou a turma; reabra.
  • "A turma precisa estar Ativa para receber alunos. Altere o status em Identidade."
  • "Acesso não autorizado" / "Você não tem permissão para consultar este registro." — falta groups.read.
  • "Sem permissão para salvar esta turma…" — falta groups.manage.
  • "Não foi possível salvar a turma. Revise os dados e tente novamente."

Dicas

  • A instituição e a unidade de uma turma já salva não mudam por aqui: aluno que muda de unidade usa "Mover alunos" com motivo.
  • O reenvio/revogação de convite é auditado ao salvar a turma.
  • Turma antiga sem etapa aparece como "Sem trilha".
  • "Salvando alterações…" no topo: espere terminar antes de sair.

Como saber que deu certo

Volta para Turmas com "Alterações da turma salvas com sucesso." Reabra a turma: os dados novos estão lá.

Novidades de 17/10/2026 — Direção inativa e arquiva turma

E aí, a Direção pode tirar uma turma de uso? Na prova real de 16–17/10 a Direção (conta sintética pelo painel da instituição) criava e editava turmas, mas Inativar e Arquivar no ⋯ do cartão voltavam recusa (SAI_PERMISSION_DENIED): o servidor só aceitava a plataforma. O Owner decidiu em 17/10: a Direção inativa e arquiva turma e atividade da própria instituição; "Arquivar" feito pela instituição sempre arquiva e excluir de vez (exclusão física) continua só com a plataforma Coelo (Dona e operação). Unidade segue gerida só pela plataforma.

Situação: a regra está decidida e aguardando aplicação. A migration 20261017070000_school_panel_group_activity_lifecycle_v1 foi commitada (3910b8a62), com pgTAP verde 14/14, mas a aplicação em produção foi barrada pela ferramenta de segurança em 17/10 e aguarda o Owner; no registro ordem-de-aplicacao-producao.txt ela consta como PENDENTE e, até a aplicação, a recusa continua. A tela não muda: os botões já existiam.

Também em 17/10 (commit 4552200af): no Detalhe da turma o cabeçalho ganha o menu ⋯ ("Mais ações da turma") com Editar turma, só para quem tem groups.manage; e o subtítulo da lista de Turmas passa a ser "Gerencie as turmas do seu alcance." (group_detail_page.dart, structure_routes.dart, group_directory_page.dart).

Novidades de 19/10/2026 — busca pelo responsável

E aí, não lembra o nome da criança? Na etapa de pessoas da turma, o campo de busca agora diz "Buscar criança ou responsável": digite o nome de quem cuida e a criança aparece. A tabela ganhou a coluna Responsáveis, com os nomes de quem responde pela criança. Para a equipe da turma o campo continua "Buscar profissional". Conferido em packages/coelo_feature_groups/lib/presentation/group_form_sections.dart. Se a lista de responsáveis ainda não vier do servidor, a coluna mostra "—".

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

O Editar da turma também tem o passo Dias letivos. Ano que já passou fica travado: Alterar pergunta antes e avisa que as faltas daquele ano são recalculadas. Quem não pode editar a turma vê o número só para ler. Veja Dias letivos.

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

Veja também