Fundamentos da organização

A aba Configurações → Identidade visual carrega dois cartões. O primeiro é a própria Identidade visual (coberta no próximo artigo); o segundo é Configurações regionais, onde você diz ao GCM onde sua organização está no mundo. Há também um cartão Identidade da organização sob a mesma aba que captura os detalhes da entidade legal que aparecem em recibos e avisos de privacidade.

Este artigo passa por ambos — são a fundação sobre a qual tudo o mais é construído.

Identidade da organização

O cartão Identidade da organização fica abaixo de Identidade visual na mesma aba. Preencha uma vez e os valores fluem para extratos fiscais, política de privacidade, e-mails gerados por edge functions e o rodapé do formulário de visitante público.

Os campos são:

Campo	Para que serve
Nome legal	O nome legal completo da sua igreja ou entidade sem fins lucrativos. Aparece em recibos fiscais.
Nome da marca	O nome amigável (por exemplo, "Igreja da Graça" vs "Igreja da Graça Inc."). Aparece no cabeçalho do app e nos e-mails enviados.
Nome do app	Como o app se chama na barra lateral. Geralmente igual ao nome da marca.
NIT / ID fiscal	Obrigatório para Colômbia e outras jurisdições que esperam um ID fiscal registrado em recibos. Opcional em outros lugares.
Endereço	Rua + bairro, uma linha.
Cidade	A cidade ou município.
E-mail	O e-mail público de contato da sua igreja. Usado como Endereço de resposta padrão se você não configurar o e-mail separadamente.
Telefone	Um telefone público. Mostrado em recibos.

Clique em Salvar configurações da organização. Os valores caem em app_settings com as chaves org_* e são lidos por cada recibo, extrato e e-mail transacional enviado.

TIP

Se você opera várias entidades legais (por exemplo, igreja-mãe + braço sem fins lucrativos separado), defina o nome legal para a entidade que detém o ID fiscal, e use o nome da marca para o que as pessoas realmente chamam de você. Podem ser diferentes.

Configurações regionais

O cartão Configurações regionais controla três coisas que afetam toda a plataforma: idioma padrão, país padrão e fuso horário.

Idioma padrão

Inglês ou Espanhol. Esse é o idioma que novos usuários veem antes de escolher o seu, e o idioma que e-mails de sistema enviados usam quando o destinatário ainda não entrou. Visitantes que chegam ao seu site público também recebem esse idioma primeiro.

Usuários individuais sobrescrevem o padrão da organização no perfil. Mudar o padrão da organização não muda nada para usuários que já definiram a preferência.

País padrão

Escolha no dropdown. Isso define:

• O código de país padrão para novos telefones de membros.
• O país padrão para novos endereços de membros (para o dropdown de país já vir certo).
• O símbolo de moeda em doações (indiretamente — via a moeda do país).
• O centro inicial do módulo Mapa.

Fuso horário

A configuração mais importante de todo o app. Acerte isto antes de qualquer outra coisa. Agendamentos cron, execuções de doação recorrente, cálculos de janela de presença, disparo de lembrete de evento — tudo isso lê o fuso horário da organização.

O dropdown agrupa fusos por região (África, América, Ásia, Austrália, Europa, Pacífico). Um relógio ao vivo abaixo do dropdown mostra a hora atual no fuso escolhido para você conferir antes de salvar.

Dois lugares de armazenamento

O fuso horário é gravado em dois lugares quando você salva:

1. organizations.timezone — lido por cada edge function (cron, lembretes, webhooks de processador de pagamento).
2. app_settings.app_timezone — lido pelo frontend via BrandingContext.

O botão de salvar atualiza os dois de forma atômica. Nunca edite um direto no SQL sem editar o outro — você acaba com o frontend e as tarefas cron discordando sobre o que significa "hoje", o que produz bugs de lembrete extremamente confusos.

Salvar configurações regionais

Clique em Salvar configurações regionais. O botão fica desabilitado até você mudar algo, então o formulário lembra o que já estava salvo no servidor. Um toast confirma; se a atualização da organização ou a configuração de fuso horário falhar, o toast te diz exatamente qual — elas são salvas em paralelo via Promise.allSettled para que uma falha parcial não derrube o conjunto.

O que "organização" significa por baixo dos panos

Cada usuário logado pertence a exatamente uma organização (pertencimento multi-organização não é um recurso — usuários com acesso a várias organizações entram em cada uma separadamente). A organização é a fronteira para RLS, faturamento, identidade visual e tudo mais. A função SQL current_org_id() resolve a organização ativa a partir do JWT em cada consulta, motivo pelo qual você não consegue ver dados de outra igreja por acidente.

Para admins de plataforma impersonando um tenant, current_org_id() retorna o ID da organização impersonada — então editar configurações enquanto impersonando grava no lugar certo. Procure o banner de impersonação no topo da página para confirmar qual organização você está editando.

Armadilhas comuns

"Meu fuso horário está errado nos lembretes de evento." Você provavelmente mudou o fuso horário no frontend (app_settings) mas não em organizations. Salve novamente as configurações regionais pela interface e os dois atualizam.

"O símbolo de moeda nas doações mudou quando troquei de país." Sim — a moeda é derivada do país padrão. Se sua igreja usa moeda diferente do país sede (raro), avise o suporte e a gente define uma sobrescrita de moeda por organização.

"Mudei o nome legal e os extratos fiscais antigos ainda mostram o nome antigo." Extratos renderizam o valor atual de org_legal_name no momento em que o PDF é gerado. Reemita o extrato e o novo nome aparecerá. A gente não guarda um snapshot por recibo.

Próximos passos

• Identidade visual — deixe o app com a sua cara.
• E-mail + notificações — escolha um provedor de envio.
• Domínio personalizado — reivindique seu subdomínio ou conecte um domínio personalizado.