Eduq Brasil Docs

Appearance

Sistema de Municípios ​

Sistema de gerenciamento de divisões geográficas e administrativas da plataforma, representando a organização hierárquica entre empresas, municípios e escolas.

Índice:

Visão Geral ​

O que é um Município? ​

Na plataforma EduqBrasil, um município representa uma divisão administrativa que fica entre a empresa (contratante) e as escolas. É a unidade geográfica principal para gestão educacional.

Hierarquia ​

Empresa → Município → Escolas → Turmas → Alunos

Exemplo prático:

  • Empresa: Secretaria de Educação de um estado
  • Município: Cada cidade do estado
  • Escolas: Todas as escolas da cidade
  • Turmas: Classes de cada escola
  • Alunos: Estudantes de cada turma

Benefícios ​

  • Organização clara: Estrutura hierárquica intuitiva
  • Gestão descentralizada: Cada município tem autonomia
  • Controle de custos: Limites e créditos por município
  • Flexibilidade: Features podem ser habilitadas por município

Como Funciona ​

Estrutura de um Município ​

Identificação:

  • Nome
  • Dados de contato (email, telefone, endereço, CEP)
  • Empresa responsável
  • Tier/Plano (nível de serviço)

Supervisão:

  • Supervisor responsável (gerente do município)
  • Dados de contato do supervisor

Limites e Controles:

  • Limite de quantidade de alunos
  • Data de expiração de limites
  • Carteira de créditos (se aplicável)
  • Tier/Plano adquirido

Funcionalidades:

  • Feature flags (features habilitadas/desabilitadas)
  • Acesso a aplicativos (EduQ, Corrija Aqui)
  • Status (ativo/inativo)

Vida de um Município ​

Criação:

  • Administrador ou gerente de empresa cria
  • Dados do município + supervisor coletados juntos
  • Associação automática empresa ↔ município ↔ supervisor

Gestão:

  • Supervisor gerencia escolas do município
  • Gerentes de empresa supervisionam múltiplos municípios
  • Administradores têm visibilidade global

Desativação:

  • Município pode ser desativado (soft delete)
  • Escolas associadas também são desativadas
  • Dados preservados para auditoria

Hierarquia Organizacional ​

Empresa (Nível Superior) ​

Responsabilidade:

  • Contratação com a plataforma
  • Gestão de múltiplos municípios
  • Definição de políticas gerais

Exemplos:

  • Secretaria de Educação Estadual
  • Rede particular de ensino
  • Holding educacional

Município (Nível Intermediário) ​

Responsabilidade:

  • Gestão de escolas em uma região
  • Supervisão pedagógica local
  • Controle de recursos e limites

Exemplos:

  • Prefeitura municipal
  • Secretaria municipal de educação
  • Diretoria regional

Escola (Nível Local) ​

Responsabilidade:

  • Gestão de turmas e professores
  • Aplicação de planejamento pedagógico
  • Operação diária

Exemplos:

  • Escola municipal
  • Escola estadual
  • Escola particular

Por que essa hierarquia? ​

Clareza administrativa:

  • Cada nível tem responsabilidades claras
  • Gestão descentralizada funciona melhor
  • Escalabilidade para grandes redes

Controle de custos:

  • Limites podem ser definidos por nível
  • Créditos e features controlados por município
  • Planejamento orçamentário preciso

Performance:

  • Consultas otimizadas por localização
  • Filtros automáticos em relatórios
  • Isolamento de dados

Gestão de Municípios ​

Criação de Municípios ​

Quem pode criar:

  • Administradores (sem restrições)
  • Gerentes de empresa (para sua empresa)

Informações necessárias:

Dados do Município:

  • Nome
  • Email
  • Telefone
  • Endereço e CEP
  • Empresa responsável
  • Tier/Plano (Diamante, Platina, Ouro, Prata, Bronze)

Dados do Supervisor:

  • Nome completo
  • Nome de usuário
  • Email

Processo:

  1. Preencher formulário com dados
  2. Sistema valida informações
  3. Município criado
  4. Supervisor criado e associado automaticamente

Visualização de Municípios ​

Quem pode ver:

  • Administradores (todos os municípios)
  • Gerentes de empresa (municípios de sua empresa)
  • Assistentes de empresa (visualização)
  • Supervisores (apenas municípios que supervisionam)

Informações disponíveis:

  • Dados de contato
  • Empresa responsável
  • Plano/Tier
  • Supervisor
  • Escolas associadas
  • Features habilitadas

Edição de Municípios ​

Quem pode editar:

  • Administradores
  • Gerentes de empresa (de sua empresa)
  • Assistentes de empresa (de sua empresa)
  • Supervisores (do próprio município)

O que pode ser editado:

  • Dados de contato
  • Empresa responsável
  • Tier/Plano
  • Status (ativo/inativo)

Desativação de Municípios ​

Quem pode desativar:

  • Mesmas permissões de edição

O que acontece:

  • Soft delete (não é permanente)
  • Escolas associadas também são desativadas
  • Dados preservados para auditoria
  • Pode ser reativado

Controles e Limites ​

Limites de Alunos ​

Limite Global:

  • Quantidade máxima de alunos no município
  • Data de expiração do limite
  • Validado em matrículas

Limites por Ano:

  • Restrições específicas por ano letivo
  • Controle de matrículas por período
  • Expiração automática de limites temporais

Por que assim? Controle de custos e planejamento. Municípios contratam um limite de alunos e precisam respeitar.

Tiers e Planos ​

Níveis Disponíveis:

  • Diamante (mais alto)
  • Platina
  • Ouro
  • Prata
  • Bronze (básico)

Implicações:

  • Diferentes funcionalidades disponíveis
  • Limites diferentes de alunos
  • Suporte variado
  • Features específicas

Sistema de Feature Flags ​

O que são: Features podem ser habilitadas/desabilitadas por município.

Para que serve:

  • Rollout gradual (testar com alguns municípios primeiro)
  • Diferenciação entre planos/contratos
  • Testes A/B entre municípios
  • Controle de custos (features têm custo)

Exemplos de uso:

  • Habilitar feature "nova avaliação" para municípios Diamante
  • Testar feature experimental com 3 municípios
  • Desabilitar feature que está causando problemas

Acesso a Aplicativos ​

EduQ App:

  • Controle de acesso ao aplicativo EduQ
  • Invalidação automática ao desativar
  • Gestão por município

Corrija Aqui:

  • Controle de acesso ao Corrija Aqui
  • Filtragem em consultas de usuários
  • Configuração por município

Permissões e Acessos ​

Hierarquia de Visualização ​

Administrador:

  • Vê todos os municípios
  • Pode criar, editar, deletar qualquer município
  • Acesso global sem restrições

Gerente de Empresa:

  • Vê municípios de sua empresa
  • Pode criar e editar municípios de sua empresa
  • Visibilidade de todas as escolas e turmas associadas

Assistente de Empresa:

  • Vê municípios de sua empresa
  • Pode editar municípios de sua empresa
  • Apenas visualização (sem criar/deletar)

Supervisor de Município:

  • Vê apenas municípios que supervisiona
  • Pode editar dados do próprio município
  • Visibilidade de todas as escolas do município

Gerente de Escola:

  • Não vê municípios diretamente
  • Acesso apenas à própria escola
  • Vinculado indiretamente ao município

Professor:

  • Não vê municípios
  • Acesso apenas às próprias turmas
  • Vinculado indiretamente ao município

Perguntas Frequentes ​

Uso Geral ​

Por que precisamos de municípios? Municípios são a divisão natural da educação pública. Cada cidade tem sua secretaria, orçamento e políticas. O sistema reflete essa realidade.

Posso ter escolas sem município? Não. Na hierarquia do sistema, toda escola deve pertencer a um município, que pertence a uma empresa.

O que acontece se um município for desativado? Escolas associadas também são desativadas. Dados não são perdidos (soft delete), e município pode ser reativado se necessário.

Features e Limites ​

Como habilitar uma feature para um município? Isso é feito pelo administrador através do sistema de feature flags. Não é visível para usuários normais.

Posso aumentar o limite de alunos do meu município? Entre em contato com administrador ou suporte. Limites são baseados no contrato/plano do município.

O que é um tier? Tier é o nível de serviço do município (Diamante, Platina, etc.). Determina quais features estão disponíveis e limites de uso.

Permissões ​

Por que o professor não vê municípios? Professores operam em nível de turma e escola. Municípios são nível de gestão, não de operação diária.

Supervisores veem todos os municípios? Não, apenas os municípios que supervisionam. Cada supervisor é vinculado a um município específico.

Última atualização: 2026-08-03