Tutoriais Maranata

manuais do ecossistema

Entrar
Manual oficial de uso

Festa do Amor

A operação da Festa do Amor: carteira e caixa, barracas, check-in de equipes e sorteios.

Começar o tutorialAbrir o aplicativo

Revisado com base no aplicativo em 26 de julho de 2026. Conteúdo sincronizado do commit 0bc3e7d · ver no app

O caminho recomendado
Esta é a ordem mais segura. Os capítulos abaixo explicam cada etapa em detalhes.
  1. 1Crie a carteira

    Digital pelo celular ou física impressa — é o seu dinheiro da festa.

  2. 2Recarregue no caixa

    Dinheiro vira créditos na hora (padrão: R$ 1 = 100 créditos).

  3. 3Gaste nas barracas

    Cada compra debita da carteira — e gera números de sorteio.

  4. 4Kids com ingresso próprio

    Atividades infantis têm ingresso com QR próprio, conferido na entrada.

  5. 5Acompanhe o sorteio

    O painel público mostra o resultado ao vivo, atualizado sozinho.

Encontre uma resposta

Buscar e filtrar o manual

14 tópicos · 19 páginas

Mostrar para

Capítulo 1

Primeiros passos

O que é o app da festa, o que é público e como os operadores entram.

O que é a Festa do Amor no app

Todos os perfis

O evento da IME Maranata sem dinheiro em espécie circulando: carteira com créditos, barracas das igrejas, atividades infantis com ingresso, equipes de voluntários e sorteios ao vivo.

Como usar

  1. 1
    Entenda os créditos. 1 crédito = R$ 0,01 (padrão: R$ 1,00 = 100 créditos). Só o caixa transforma dinheiro em créditos — as barracas só debitam.
  2. 2
    Entenda os papéis. "Admin · Caixa · Barraca · Equipe · Infantil · Sorteio" — cada operador entra com o PIN do seu papel; visitantes não precisam de conta.
  3. 3
    Instale se quiser. O app é instalável no celular (adicionar à tela inicial), com atalhos direto pro Caixa e pra Nova carteira.

Resultado esperado: Você sabe quem faz o quê — e que o visitante usa quase tudo sem login.

Acesso do operador

Onde encontrar: Rodapé da página inicial → "acesso operador" (/login)

Administração
Caixa
Barraca
Check-in
Recepção infantil
Sorteio

Em "Acesso operador": "Digite seu PIN ou use a Maranata Key". O PIN define o papel; o SSO da Suite entra direto como administração.

Como usar

  1. 1
    Entre com o PIN. O PIN do seu papel ("PIN do operador") — errou, "PIN inválido"; muitas tentativas, "Muitas tentativas. Tente em 15 min."
  2. 2
    Ou pela Maranata Key. "Admins da igreja entram direto (SSO)" — Google, Key ou email e senha. Sem papel de admin: "Você logou na Maranata Key mas não é admin da Festa do Amor. Use PIN ou peça acesso pro Paulo."
  3. 3
    Sessão de 12 horas. Depois disso o app pede o PIN de novo — normal em evento que atravessa o dia.

Resultado esperado: Cada operador com o alcance exato do seu papel.

Abrir esta área no app

Capítulo 2

A festa do ponto de vista do visitante

Carteira, saldo, extrato e o que dá pra ver sem nenhum login.

Criar e acompanhar a carteira

Onde encontrar: Página inicial → "Nova carteira" (/carteira/nova)

Todos os perfis

"Nova carteira": nome, e-mail opcional e o tipo ("📱 Digital" ou "🖨️ Física"). A página da carteira mostra o QR, o "Saldo atual", os números de sorteio e as "Últimas transações".

Como usar

  1. 1
    Crie. "Criar carteira" — você cai direto na página da sua carteira, com o QR pronto pra usar.
  2. 2
    Apresente o QR. No caixa (recarga), nas barracas (compra) e na recepção infantil (ingresso) — o QR é a sua identidade na festa.
  3. 3
    Acompanhe. "🔄 Atualizar" refresca o saldo; "🖨️ Imprimir" gera a versão em papel; o extrato lista recargas (✅), compras (🛍️), infantil (🎠) e estornos (↩️).

Resultado esperado: Sua carteira na palma da mão — saldo, números de sorteio e extrato.

Dicas

  • Guarde o link da carteira: qualquer pessoa com o QR consulta o saldo — trate como o seu cartão.
Abrir esta área no app

O que dá pra ver sem login

Todos os perfis

Barracas ("Veja o cardápio das 14 igrejas" — a lista; os preços aparecem na operação), Equipes (quem está presente), Infantil (atividades e vagas) e o painel público do sorteio.

Como usar

  1. 1
    Barracas. A lista mostra nome, categoria e quantos itens cada barraca tem — a venda em si é tela de operador.
  2. 2
    Equipes e Infantil. Equipes com turnos e presença ("N/N presentes"); atividades infantis com preço e vagas ("esgotado" quando acabam).
  3. 3
    Sorteio ao vivo. "Sorteio ao vivo" atualiza a cada 10 segundos — antes do resultado, "Gaste créditos nas barracas para ganhar números".

Resultado esperado: A festa transparente pra quem chega — sem pedir conta de ninguém.

Capítulo 3

Caixa: recarga, identificação e estorno

"Recarregar carteiras com dinheiro" — e desfazer com critério.

Recarregar uma carteira

Onde encontrar: Página inicial → "Caixa" (/caixa)

Caixa
Administração

Busque a carteira ("Digite ou escaneie o QR Code"), confira o dono e recarregue: o valor em R$ vira créditos na hora ("= N créditos"), com atalhos de R$ 10/20/50/100.

Como usar

  1. 1
    Busque pelo QR. Câmera ("📷") ou digitação — "Carteira não encontrada" indica código errado.
  2. 2
    Identifique se for do lote. Carteira física anônima pede "🆕 Identificar antes de recarregar": nome completo (e telefone opcional) — "✓ Identificar e prosseguir".
  3. 3
    Confirme a recarga. "✓ Confirmar recarga" → "✅ Recarga R$ X,XX = Ncr · saldo: Mcr".

Resultado esperado: Dinheiro no cofre, créditos na carteira — com a tabela de conversão sempre à vista.

Abrir esta área no app

Estornar com critério

Onde encontrar: Caixa → "↩️ Estornar" (/caixa/estornar)

Caixa
Administração

O estorno reverte uma transação específica, com motivo obrigatório. O caixa opera até o limite configurado ("Limite do caixa: R$ X,XX · acima exige ADMIN").

Como usar

  1. 1
    Ache a transação. Busque a carteira e toque na transação original (estornos não podem ser estornados).
  2. 2
    Informe valor e motivo. Até o valor original ("Valor maior que o original" barra o excesso); o "Motivo *" fica registrado.
  3. 3
    Respeite o limite. "Acima do limite do caixa (Xcr). Chame um ADMIN." — valores altos são decisão da administração.

Resultado esperado: "✅ Estorno aplicado" — tudo rastreável no relatório de fechamento (valor, motivo e quem autorizou).

Atenção: Estorno de recarga exige que o saldo ainda cubra o valor: "Saldo da carteira não cobre o estorno da recarga (já foi gasto)".

Abrir esta área no app

Capítulo 4

Barracas: vender

O cardápio da barraca, a compra por QR e os números de sorteio.

Vender um item

Onde encontrar: Barracas → sua barraca (/barraca/[id])

Barraca
Caixa
Administração

Dentro da barraca: busque a carteira do cliente, veja o "📋 Cardápio" (preço em créditos e estoque quando controlado) e toque "Comprar" no item.

Como usar

  1. 1
    Busque a carteira. QR do cliente → nome e "créditos disponíveis" aparecem na tela.
  2. 2
    Venda. "Comprar" debita na hora — "✅ Compra de '{item}' realizada! Novo saldo: N créditos", e "+N número(s) de sorteio!" quando a compra gera números.
  3. 3
    Respeite o estoque. Item controlado mostra "Estoque: N" e o botão vira "Esgotado" quando acaba; "Saldo insuficiente" barra compra sem crédito.

Resultado esperado: Venda sem dinheiro na mão — e o cliente ainda concorre ao sorteio.

Dicas

  • Números de sorteio nascem das compras em barracas (padrão: 1 número a cada 1.000 créditos gastos) — ingresso infantil não gera número.

Capítulo 5

Check-in: equipes e infantil

Presença dos voluntários e a entrada segura das crianças.

Check-in de voluntários

Onde encontrar: Equipes → "📲 Check-in / Check-out" (/equipes/[id]/checkin)

Check-in
Administração

Na tela da equipe, cada membro tem seu botão: "Check-in" na chegada, "Check-out" na saída — o painel mostra "N de N presentes agora" e todos veem a presença na página pública de Equipes.

Como usar

  1. 1
    Abra a sua equipe. A lista de membros mostra o estado de cada um ("✅ Entrou às HH:MM", "Saiu às HH:MM", "Aguardando").
  2. 2
    Marque na chegada e na saída. "✅ {nome}: check-in registrado" — e o contador de presentes atualiza pra todo mundo.

Resultado esperado: A coordenação sabe quem está servindo, em tempo real.

Atenção: A sessão de check-in abre qualquer equipe pelo endereço — combine com a coordenação para cada operador cuidar apenas da sua.

Infantil: ingresso e entrada

Onde encontrar: Infantil → atividade (vender) · "Check-in de ingresso" (entrada)

Recepção infantil
Caixa
Administração

Dois momentos: vender o ingresso (carteira do responsável + nomes das crianças) e conferir na entrada pelo QR DO INGRESSO — que é diferente do QR da carteira.

Como usar

  1. 1
    Venda o ingresso. Busque a carteira do responsável, adicione as crianças ("Nome da criança" + "+"), confira o total e "🎟️ Comprar Ingresso" — "✅ Ingresso criado! QR: {código}".
  2. 2
    Confira na entrada. Em "Check-in Infantil", escaneie o QR do ingresso: "Entrada registrada!" com os nomes das crianças.
  3. 3
    Reentradas são visíveis. O mesmo ingresso pode entrar de novo — a tela avisa "Esta é a Nª entrada" para a recepção decidir.

Resultado esperado: Criança entra com ingresso nominal e a recepção sabe exatamente quem passou.

Dicas

  • "❌ Vagas insuficientes" respeita o limite configurado por atividade — atividade esgotada aparece bloqueada na lista pública.
Abrir esta área no app

Capítulo 6

Sorteios

Criar, realizar com confirmação e anunciar no painel público.

Operar o sorteio

Onde encontrar: Página do operador de sorteio (/sorteio) · painel público (/sorteio/publico)

Sorteio
Administração

Crie o sorteio (nome, prêmio, créditos por número), realize com "🎲 Realizar Sorteio" (pede confirmação) e deixe o painel público anunciar — lá aparece só o número, nunca o nome.

Como usar

  1. 1
    Crie. "+ Criar Novo Sorteio": nome, "Descrição do prêmio" e créditos por número (padrão 1.000).
  2. 2
    Realize uma única vez. "Confirmar realização do sorteio?" — depois de realizado não refaz ("Sorteio já foi realizado"); sem números vendidos, o app recusa.
  3. 3
    Anuncie pelo painel. A tela do operador mostra número E vencedor; o painel público (projetado no telão) mostra o número gigante e o prêmio — atualiza sozinho a cada 10 segundos.

Resultado esperado: Sorteio auditável: números nascem das compras, o resultado é público e o nome fica com a operação.

Capítulo 7

Administração do evento

"⚙️ Painel Admin" — evento, barracas, atividades, equipes, lotes de carteiras e o relatório de fechamento.

Configurar o evento e as barracas

Onde encontrar: Página inicial → "Admin" (/admin)

Administração

No bloco "🎪 Evento": nome, local, datas, "Créditos por R$ 1", "Créditos por número de sorteio" e "Limite de estorno do caixa (cr)". Nas "🏪 Barracas": criar, ordenar, duplicar, ativar/desativar e o cardápio de cada uma (preço e estoque).

Como usar

  1. 1
    Ajuste as conversões. As três constantes do dinheiro da festa (créditos por real, por número de sorteio e o teto de estorno do caixa) vivem no bloco do evento.
  2. 2
    Monte as barracas. Uma por igreja/prato, com itens, preços em créditos e estoque opcional — ⧉ duplica, ↑/↓ reordena, ⚪ desativa.
  3. 3
    Prepare kids, equipes e sorteios. Atividades com preço e vagas; equipes com membros e turnos; sorteios prontos pra tela do operador.

Resultado esperado: A festa inteira configurada num painel só — pronta pra operação.

Abrir esta área no app

Lotes de carteiras físicas e o fechamento

Onde encontrar: Admin → "🖨️ Lotes de carteiras" e "📊 Relatório"

Administração

"Pra quem chega na festa sem celular": lotes de carteiras anônimas impressas (9 por folha A4) que viram nominais no caixa. No fim, "📊 Relatório" gera o fechamento completo pra imprimir.

Como usar

  1. 1
    Gere e imprima o lote. "+ Gerar lote (vai pra impressão)" — a folha traz as instruções da recepção: entregar, apresentar no caixa, identificar e recarregar.
  2. 2
    Acompanhe a ativação. Cada lote mostra "{qtd} carteiras · {ativadas} ativadas · {usadas} já usadas".
  3. 3
    Feche o evento. O relatório consolida arrecadação bruta e líquida, estornos com motivo e autorizador, ranking por igreja e barraca, infantil, sorteios, estoque final e sobra nas carteiras — "🖨️ Imprimir / Salvar PDF".

Resultado esperado: Da carteira impressa ao fechamento auditável — o ciclo completo do evento.

Dicas

  • "💸 Carga manual de carteira" cobre ajustes excepcionais (valor negativo estorna) — "Tudo fica registrado como transação."
Abrir esta área no app

Capítulo 8

Ajuda e solução de problemas

Mensagens comuns da operação e seus significados.

Mensagens comuns

Todos os perfis

As mensagens da festa são diretas — quase sempre saldo, estoque, sessão ou papel.

Como usar

  1. 1
    "Saldo insuficiente". Cliente sem créditos — recarga no caixa resolve.
  2. 2
    "❌ Não autenticado" / "❌ Sem permissão". Sessão expirou (12h) ou o papel não cobre a ação — entre de novo pelo "acesso operador".
  3. 3
    "Carteira não encontrada". QR errado ou carteira inativa — confira o código ou crie uma nova.
  4. 4
    "Muitas tentativas. Tente em 15 min.". Proteção do PIN — aguarde e tente novamente.

Resultado esperado: A operação se resolve na hora, sem parar a fila.

Onde buscar mais ajuda

Todos os perfis

Este manual é público — compartilhe com a equipe antes da festa. Acessos de administração vêm da Maranata Key; PINs, da coordenação do evento.

Como usar

  1. 1
    Reabra este manual. O link "Tutorial" está no rodapé da página inicial e no topo das telas de operação.
  2. 2
    Imprima o essencial. "Imprimir / Salvar PDF" no alto do tutorial — bom pra colar no caixa e nas barracas.
  3. 3
    Peça acesso certo. PIN do papel → coordenação da festa · admin via SSO → Maranata Key.
  4. 4
    Central de tutoriais da Suite. tutorial.maranata.app reúne o manual de cada app da família Maranata — inclusive este.

Resultado esperado: Equipe treinada antes do portão abrir.

Atlas do aplicativo

Diretório de páginas

Todas as páginas de Festa do Amor. As rotas com colchetes, como [id], são abertas a partir de um item real.

Página inicial
/

O evento, os blocos de acesso e o rodapé com acesso operador e tutorial.

Todos os perfis
Abrir
Acesso operador
/login

PIN por papel ou SSO da Maranata Key (admins).

Administração
Caixa
Barraca
Check-in
Recepção infantil
Sorteio
Nova carteira
/carteira/nova

Autoatendimento: criar carteira digital ou física.

Todos os perfis
Abrir
Carteira digital
/carteira/[qrCode]

QR, saldo, números de sorteio e extrato — pública pelo link.

Todos os perfis
Caixa
/caixa

Recarga com identificação de carteiras de lote.

Caixa
Administração
Estorno
/caixa/estornar

Reverter transações com motivo e limite por papel.

Caixa
Administração
Barracas
/barraca

Lista pública das barracas do evento.

Todos os perfis
Abrir
Venda da barraca
/barraca/[id]

Cardápio com preços/estoque e a venda por QR.

Barraca
Caixa
Administração
Equipes
/equipes

Voluntários, turnos e presença — visão pública.

Todos os perfis
Abrir
Check-in da equipe
/equipes/[id]/checkin

Entrada e saída dos voluntários da equipe.

Check-in
Administração
Atividades infantis
/infantil

Lista pública com preços e vagas.

Todos os perfis
Abrir
Venda de ingresso
/infantil/[atividadeId]

Ingresso nominal debitado da carteira do responsável.

Recepção infantil
Caixa
Administração
Check-in infantil
/infantil/checkin

Confere o QR do ingresso na entrada (reentradas visíveis).

Recepção infantil
Administração
Sorteios (operação)
/sorteio

Criar e realizar sorteios — mostra o vencedor à operação.

Sorteio
Administração
Sorteio ao vivo
/sorteio/publico

Painel público do resultado (número, nunca o nome).

Todos os perfis
Abrir
Dashboard
/dashboard

Arrecadação do dia em tempo real (administração).

Administração
Painel Admin
/admin

Evento, barracas, atividades, sorteios, equipes, lotes e carga manual.

Administração
Relatório de fechamento
/admin/relatorio

Consolidado completo do evento, pronto pra imprimir.

Administração
Tutorial
/tutorial

Este manual — público, como a festa.

Todos os perfis
Abrir