Ativar ou desativar módulos

Todo recurso no GCM é um módulo — Membros, Presença, Doações, Calendário, Fluxos de trabalho, tudo. A página Módulos (barra lateral → Módulos) permite que um admin ligue ou desligue módulos individuais para a organização inteira. Desativar um módulo esconde da barra lateral, bloqueia suas rotas e impede que notificações o referenciem — uma remoção limpa, não um esconder superficial.

Por que desativar um módulo

A maioria das organizações desativa um punhado de módulos para manter a barra lateral relevante:

• Uma igreja sem prédio não precisa de Mapa nem Estrutura organizacional.
• Uma congregação pequena que não roda programas durante a semana pode dispensar Escolas e Ministérios.
• Uma organização que cuida de doações fora da plataforma (por exemplo, por um sistema contábil separado) pode esconder Doações para evitar confusão.
• Uma implantação só para a equipe pode desativar Formulário de visitante e Construtor de site web.

Desativar não é apagar — seus dados ficam onde estão. Reative o módulo quando quiser e ele continua de onde parou.

Abrir a página de Módulos

Clique em Módulos na barra lateral. A página mostra todos os módulos disponíveis no seu plano, agrupados por categoria:

• Core — Painel, Membros, Configurações.
• Engajamento — Presença, Calendário, Grupos, Ministérios, Ações em massa.
• Comunicação — Mensagens, Conversas, Fluxos de trabalho.
• Análise — Relatórios, Demografia, Logs de dados.
• Educação — Escolas.
• Administração — Usuários e papéis, Faturamento, Estrutura organizacional, Campos personalizados, Canais, PWA App, Acessibilidade.

Cada linha mostra o nome do módulo. Um pequeno ícone de cadeado aparece ao lado de um módulo travado em ativo (porque outro módulo ativo depende dele). Admins veem um interruptor à direita; não-admins veem "Ligado" / "Desligado" somente leitura.

Alternar um módulo

Clique no interruptor. A mudança é imediata — sem botão Salvar.

Quando você desliga um módulo:

1. O dispatch atualiza org_modules (uma linha por (org, módulo)).
2. O provider de bootstrap busca de novo sua lista de módulos ativados.
3. A barra lateral tira o link sem recarregar a página.
4. A proteção de rota agora retorna 404 se alguém tentar acessar diretamente o módulo desativado.

Quando você liga um módulo:

1. Mesmo dispatch, direção oposta.
2. O link reaparece na barra lateral.
3. Quaisquer dados já criados (membros, doações, eventos) continuam lá — desativar não foi deletar.

Dependências entre módulos

Alguns módulos dependem de outros. Exemplos:

• Rede de conexões depende de Membros (sem registros de membro, não há nada para conectar).
• Check-in depende de Presença (é uma forma mais rápida de registrar presença).
• Novos membros depende de Membros.
• Demografia depende de Membros.

A página lê essas dependências de module_dependencies e impede desativar um módulo do qual algo mais precisa. O interruptor do módulo travado fica cinza com um pequeno cadeado ao lado do nome. Passe o mouse no cadeado e o tooltip explica qual outro módulo está mantendo ele ligado.

Para desativar um módulo travado, desative primeiro os módulos que dependem dele. O cadeado libera assim que o último dependente sai.

TIP

Se você está tentando enxugar drasticamente a barra lateral, trabalhe de cima para baixo. Desligue primeiro os módulos folha (aqueles dos quais nada mais depende), depois suba a árvore.

Se você tentar desativar um módulo com dependentes ligados, um toast destrutivo te diz exatamente quais módulos estão bloqueando a mudança.

Plano vs módulo

Seu plano (Starter, Growth, Network, Unlimited) define a lista de módulos disponíveis — Growth inclui tudo do Starter mais um pouco, Network adiciona domínios personalizados, Unlimited remove o teto de destinatários em envios em massa. A página Módulos só mostra módulos que seu plano inclui; módulos de planos superiores nem aparecem aqui.

Se você quer um módulo que não está no seu plano, faça upgrade do seu faturamento — os novos módulos aparecem aqui logo após a mudança de plano ser processada.

O cabeçalho do cartão te lembra qual plano você tem: "Seu plano growth inclui esses módulos."

O que desativar esconde

Desativar um módulo esconde:

• O link na barra lateral.
• A rota (links diretos retornam 404 via ModuleGuard).
• Quaisquer grupos da barra lateral que contenham só este módulo.
• Nós do construtor de fluxo de trabalho que referenciam este módulo (cinza com "módulo desativado").
• Templates de notificação que miram neste módulo (eles pausam até ser reativado).

Não esconde:

• Dados históricos — cada doação, registro de presença e membro fica no banco.
• Logs de auditoria que mencionam o módulo desativado.
• Relatórios que antes incluíam dados deste módulo — reative e o relatório continua funcionando.

Módulo Platform Admin

O módulo Platform Admin é especial: só é visível para usuários com is_platform_admin = true no JWT, e a página Módulos o esconde da lista (você não consegue desativar o platform admin pela interface mesmo sendo admin). É por design — admins de plataforma gerenciam o sistema multi-tenant inteiro, incluindo impersonar tenants para suporte.

O que é salvo onde

Duas tabelas sustentam esta página:

• modules — o catálogo da plataforma. Uma linha por ID de módulo com nome, categoria, plano e dependências.
• org_modules — sobrescritas por organização. Uma linha por (organization_id, module_id, is_enabled). Linhas ausentes assumem "ativo se seu plano incluir".

O hook useModules lê os dois no boot do app, calcula o conjunto efetivo de ativados e propaga mudanças para a barra lateral e proteções de rota.

Armadilhas comuns

"Desativei o Calendário e agora os lembretes de evento não enviam." Correto — desativar o Calendário também desativa os lembretes de evento. Eles compartilham a tabela events por baixo, mas o disparo do lembrete é condicionado ao módulo Calendário estar ativo.

"A barra lateral ainda mostra o módulo desativado depois que eu atualizo." Recarregue forçado (Cmd+Shift+R). O frontend cacheia a lista de módulos ativos pela sessão; um refresh completo busca de novo.

"Não consigo desativar Membros." Membros é central — quase tudo depende dele. O ícone de cadeado ao lado do interruptor avisa. Para desativar Membros, você precisaria desativar praticamente tudo antes, e por isso ninguém faz isso.

"Meu papel perdeu acesso a um módulo depois de ativá-lo." Ativar módulo e permissões de papel são separados. Ativar um módulo o expõe; se seu papel pode ler ou escrever lá dentro é assunto de Usuários e papéis.

Próximos passos

• Visão geral de Configurações — para abas que vivem em Configurações em vez de página própria.
• Usuários e papéis — controle quem na sua organização pode usar os módulos ativados.
• Canais — Canais é em si um módulo; ative ele aqui primeiro.