Cartões KPI
O painel inicial mostra cinco cartões em linha no topo. Cada cartão é uma contagem ao vivo que se atualiza sempre que os dados subjacentes mudam, e cada um é um link — clicar num cartão leva você direto à página certa com o filtro certo já aplicado.
TIP
Os cartões KPI só aparecem em /home. O painel personalizável em /home-v2 os substitui por widgets que você posiciona. Você pode recriar os mesmos números como widgets (os widgets Funil de visitantes, Ativos vs perdidos e os widgets numéricos cobrem toda a matemática dos KPIs).
Os cinco cartões
| Cartão | O que conta | Permissão | Link direto |
|---|---|---|---|
| Membros ativos | Membros sem lost_at e não excluídos logicamente | members.view | /members |
| Membros perdidos | Membros com lost_at definido | members.view | /members?status=lost |
| Presenças deste mês | Registros de presença distintos do dia 1 deste mês até hoje | attendance.view | /attendance?mode=charts |
| Novos nos últimos 30 dias | Membros cuja date_of_registration está dentro dos últimos 30 dias e que ainda estão ativos | members.view | /members |
| Aniversariantes deste mês | Membros cujo mês de date_of_birth é o mês atual, ainda ativos | members.view | /members?birth_month={month} |
O cartão só aparece se você tem a permissão listada. Um usuário só com acesso à presença vê um cartão; um admin completo vê os cinco.
O que cada cartão significa
Membros ativos
O número principal da sua igreja. Conta todos com um perfil que:
- Não foi excluído logicamente (
deleted_at IS NULL) - Não foi marcado como perdido (
lost_at IS NULL)
É o mesmo número que define a contagem de assentos do seu plano. Se você sobe ou desce de plano, sua cobrança é baseada no número de membros ativos — veja Escolher um plano.
Membros perdidos não são excluídos
Marcar alguém como perdido preserva todo o histórico (presença, doações, registros escolares) mas remove dos contadores de ativos. Se ele voltar, você desativa o flag de perdido e tudo reaparece. Veja Membros ativos vs perdidos.
Membros perdidos
O outro lado de ativos — pessoas que pararam de frequentar ou mudaram, mas cujos registros você quer manter. Clicar no cartão leva direto à lista de membros perdidos já filtrada.
Uma igreja saudável geralmente tem um número de perdidos não-zero. Se for zero, você provavelmente não está marcando membros dormentes como perdidos, e seu número de ativos está inflado.
Presenças deste mês
Uma contagem distinta de linhas de presença do dia 1 do mês atual até hoje. O número é distinto por ID de presença, então um membro que esteve quatro vezes este mês conta como quatro.
A matemática funciona igual independente do tipo de reunião — culto de domingo, oração no meio da semana, capela escolar, tudo soma em um número. Se você quer separar por reunião, clique no cartão para ir em Presença → Gráficos, ou use o widget Presença por reunião no painel personalizado.
Novos nos últimos 30 dias
Membros cuja date_of_registration é igual ou posterior a 30 dias atrás. Esta é sua métrica de "porta de entrada" — diz se seu trabalho de convite e acompanhamento está produzindo novos membros cadastrados.
Últimos 30 dias, não o mês calendário
A etiqueta diz "novos nos últimos 30 dias" propositalmente. Contar "este mês calendário" faz o número depender de ser dia 1 ou dia 28. Uma janela rolante de 30 dias é comparável de semana em semana.
Aniversariantes deste mês
Membros cuja data de nascimento cai no mês calendário atual. Útil para enviar mensagens de aniversário em massa ou imprimir uma lista de cartões de aniversário.
Clicar no cartão leva a /members?birth_month=N com o número do mês atual — esse filtro também está exposto na UI de filtros da lista de membros comum.
Estados de carregamento e erro
Enquanto a consulta do painel roda, você vê cinco barras esqueleto cinzas onde os números aparecerão. Se a consulta falhar — geralmente uma queda do Supabase ou uma má configuração de permissões — uma pequena linha vermelha aparece acima dos cartões:
Não foi possível carregar estatísticas — por favor atualize.
Os próprios cartões aparecem com um 0 como placeholder para que o layout não pule. Atualize a página assim que a conectividade voltar; o painel cacheia estatísticas por 5 minutos para não martelar o banco de dados.
Escopo de unidade organizacional
Quando você escolhe uma unidade organizacional específica no seletor de escopo (canto superior direito da página Início), cada cartão é recalculado em relação aos membros atribuídos a essa unidade e seus descendentes. O recálculo é barato — roda como uma única consulta contra a view v_members_org — mas invalida o cache, então espere um breve flash de esqueleto quando você mudar de escopo.
Se sua igreja não usa hierarquia, o seletor fica oculto e os cartões sempre refletem toda a organização.
Fallback do PowerSync
Quando o PowerSync está habilitado, os KPIs podem usar a cópia SQLite local e evitar uma viagem de rede. Consulte Escolher um plano para a configuração.
O que vem a seguir
- Foco do dia — as três listas abaixo dos cartões KPI
- Membros ativos vs perdidos — o que virar o flag de perdido realmente faz
- Relatórios de presença — aprofundar o cartão de presenças por reunião e data