# Manual do AppEmpresa # Manual do AppEmpresa — MOC Fidelidade App mobile da **empresa-operadora** do MOC Fidelidade. Use no balcão, na recepção, no caixa — onde for atender o cliente. > **Pra quem é este app:** **administradores** e **operadores** das empresas que contratam o MOC Fidelidade. Tudo que o painel web (Admin) faz, esse app faz também. --- ## 1. Instalação ### Android 1. Abra a **Play Store**. 2. Procure por **"MOC Fidelidade - Empresa"**. 3. Toque em **Instalar**. ### iPhone 1. Abra a **App Store**. 2. Procure por **"MOC Fidelidade - Empresa"**. 3. Toque em **Obter**. > Existem **dois apps diferentes** no MOC: o **cliente** (pra quem acumula pontos) e o **empresa** (pra quem opera). Instale o certo! --- ## 2. Acessar a sua conta ### Primeiro acesso (já criou empresa pelo site) 1. Abra o app. 2. Toque em **"Entrar"**. 3. Use o **mesmo e-mail e senha** que você cadastrou no site **mocfidelidade.com.br** ao contratar. 4. Pronto — entra direto no painel da sua empresa. ### Esqueceu a senha? 1. Toque em **"Esqueci minha senha"**. 2. Digite seu e-mail → receba código de 4 dígitos no e-mail. 3. Valide o código. 4. Crie uma senha nova (mínimo 6 caracteres). ### Ainda não tem empresa cadastrada? Toque em **"Quero cadastrar uma empresa nova"** na tela de login — abre o site no navegador, onde o fluxo completo de cadastro (plano + dados) é feito. > **Operador convidado** (sem ser dono da empresa): você ganhou acesso por um convite. Faça o **"Esqueci minha senha"** com seu e-mail pra ativar a conta. --- ## 3. Escolher a empresa ativa Se você administra **mais de uma empresa**, após login aparece a tela **"Selecionar empresa"**: - Toque na empresa pra ativar. - Mostra seu papel: **Administrador** (gerencia tudo) ou **Operador** (opera o dia-a-dia). - Se só houver uma, o app pula direto pro dashboard. Pode trocar a empresa ativa depois: **menu lateral → "Trocar empresa"**. --- ## 4. Concluir cadastro (banner no dashboard) Se sua empresa foi recém-criada e ainda **não definiu CNPJ + razão social + nome fantasia + modelo de fidelidade**, aparece um **banner laranja** no dashboard pedindo pra concluir. 1. Toque em **"Concluir"** no banner. 2. Preencha: - CNPJ (opcional) - Razão social - Nome fantasia - **Modelo de fidelidade**: Marcações ou Pontos - Meta de marcações (se mrc) **ou** Pontos por R$ (se ptc) 3. Toque em **"Concluir cadastro"**. Após concluir, todas as telas refletem o modelo escolhido. --- ## 5. Dashboard (tela inicial) Mostra: - **Hero laranja:** modelo de fidelidade + total de clientes ativos. - **KPIs do dia:** códigos gerados/usados, marcações ou pontos creditados, recompensas pendentes. - **Ações rápidas:** atalhos pra gerar código, ler QR de cliente, ver clientes, recompensas etc. **Alertas que podem aparecer no topo:** - **Tarja vermelha — Cobrança em atraso:** fatura atrasada bloqueia operações novas (gerar código, criar produto). Toque em **"Ver"** pra pagar. - **Banner laranja — Concluir cadastro:** onboarding incompleto. --- ## 6. Gerar código pra cliente Operação principal do dia-a-dia. Cliente está no caixa, fez uma compra, hora de creditar marcação/pontuação. 1. Menu lateral → **"Códigos"** (ou ação rápida no dashboard). 2. Toque em **"Gerar código"** (botão flutuante). 3. Defina: - **Quantidade** — quantas marcações OU quantos pontos creditar. - **Expira em (minutos)** — padrão 60. Use menor pra códigos "de balcão", maior pra códigos por WhatsApp. 4. Toque em **"Gerar código"**. O app mostra um **QR Code grande** + **código de 5 dígitos** (toque pra copiar). O cliente: - **Escaneia o QR** pela câmera do celular (abre o AppCliente direto). - **OU digita** os 5 dígitos no AppCliente dele. ### Visual da tela - **Aguardando:** QR colorido + código grande. - **Usado (verde):** overlay verde com check + nome/avatar/horário de quem usou + quantidade creditada. **Atualiza em ~2 segundos** após o cliente usar — sem precisar atualizar manualmente. - **Expirado:** overlay cinza com "EXPIRADO". ### Histórico de códigos Toque no **ícone de histórico** (relógio) no topo. Lista os 200 mais recentes. Filtre por **Ativos / Usados / Expirados / Cancelados**. ### Cancelar um código ativo No histórico, cada código com status **Ativo** mostra um ícone vermelho de bloqueio no canto direito. Toque, confirme no diálogo, e o código fica **Cancelado** — não pode mais ser usado. Útil quando você gerou errado ou descobriu que ele vazou pra alguém que não devia receber. Códigos já **Usados** ou **Expirados** não precisam ser cancelados. --- ## 7. Ler QR Code do cliente Cliente está apresentando uma recompensa? Quer identificar o cliente rapidamente? 1. Menu lateral → **"Ler QR do cliente"** (ou ação rápida). 2. Aponte a câmera pro QR que o cliente está mostrando. 3. App identifica o cliente e abre a tela **detalhe do cliente** automaticamente. > Funciona com flash (toque no raio no topo) e câmera frontal (toque no switch). --- ## 8. Clientes Menu lateral → **"Clientes"**. - **Lista** todos os clientes vinculados à empresa ativa, ordenados por nome. - **Busca** por nome, e-mail ou telefone (debounced — digita e busca sozinho em meio segundo). - **Cada item** mostra saldo (marcações OU pontos, conforme modelo). ### Cadastrar cliente manual Toque em **"Novo cliente"**: - Nome (obrigatório) - E-mail (obrigatório) - Telefone (opcional) > **Idempotente no e-mail:** se já existe usuário com esse e-mail no MOC, vincula direto. Senão, cria conta nova com senha aleatória — cliente ativa via "esqueci minha senha". ### Detalhe do cliente Toque em um cliente. Mostra: - Foto/nome/e-mail. - **Card hero** do saldo (marcações ou pontos). - **Histórico** unificado: créditos, débitos, ajustes — cada item mostra origem (`código`, `resgate`, `ajuste manual`) + observação se houver. ### Ajustar saldo manualmente Toque em **"Ajustar saldo"** (botão flutuante) no detalhe do cliente. - Escolha **Creditar** ou **Debitar** (botão segmentado). - Digite **quantidade** (sempre positiva — o botão escolhe o sinal). - **Observação** (opcional, máx 255 caracteres) — fica visível no histórico do cliente. Use para: - Estornar marcação errada. - Premiar cliente por motivo especial. - Corrigir saldo após problema. --- ## 9. Recompensas Menu lateral → **"Recompensas"**. Lista os resgates da empresa. Filtre por status: - **Solicitadas** — cliente pediu o resgate, aguardando você aprovar. - **Aprovadas** — você aprovou, aguardando entrega. - **Entregues** — finalizadas. - **Canceladas** — descartadas. ### Ações inline (botões no card) - **Solicitada:** **Aprovar** (vira aprovada) ou **Cancelar** (devolve pontos no modelo ptc). - **Aprovada:** **Marcar como entregue** (finaliza) ou **Cancelar**. > Ação é **imediata** no card — sem confirmação extra. Em caso de erro, o card volta ao status anterior e mostra uma mensagem. --- ## 10. Produtos (catálogo) Menu lateral → **"Produtos"**. - Lista produtos da empresa com preview da foto, preço (em BRL), pontos pra resgate (modelo ptc). - **Inativos** aparecem riscados. ### Criar/editar produto Toque em **"Novo produto"** (FAB) ou em um produto existente. - **Foto** — tira foto ou escolhe da galeria. Upload em background com indicador. - **Nome** (obrigatório, máx 180 caracteres). - **Descrição** (opcional). - **Preço** em R$ (opcional). - **Pontos para resgate** (só aparece em modelo ptc). - **Categoria** (opcional, dropdown — aparecem só categorias ativas). - **Ativo** — toggle (inativo some das listas pro cliente). > **Remover foto?** Toque em **"Remover imagem"** abaixo da preview. ### Excluir produto Menu de 3 pontos (⋮) no item → **Excluir**. Confirmação modal. Resgates anteriores ficam intactos. --- ## 11. Categorias Menu lateral → **"Categorias"** (ou ícone de categoria no topo da tela de Produtos). - Lista das categorias da empresa. - CRUD simples: criar, renomear, ativar/desativar, excluir. > **Categoria com produto não pode ser excluída.** O backend devolve erro 409 e o app mostra mensagem. --- ## 12. Plano (só Admin) Menu lateral → **"Plano"**. Mostra: - Plano atual + valor mensal. - Janela de **trial** (se aplicável). - **Próxima fatura** (data prevista). - Limite de clientes ativos. Pra **trocar de plano**, use o site **mocfidelidade.com.br** ou o painel Admin (web). --- ## 13. Faturas (só Admin) Menu lateral → **"Faturas"**. Lista todas as faturas da empresa. Filtre por status: - **Abertas** — aguardando pagamento dentro do prazo. - **Atrasadas** — vencidas (bloqueia operações novas). - **Pagas** — quitadas. ### Detalhe da fatura Toque em uma fatura. - **Hero colorido** por status com valor e vencimento. - **Métodos de pagamento** (PIX, Boleto, Cartão) — toque pra iniciar checkout. #### PIX - Mostra **QR Code** + **código copia-e-cola**. - Toque em **"Copiar código PIX"** pra copiar pro clipboard. #### Boleto - **Linha digitável** (botão de copiar). - **Abrir boleto** — abre PDF no navegador. #### Cartão - Abre Checkout Pro do **Mercado Pago** no navegador. > **Idempotente:** se você já gerou o PIX/boleto, tocar de novo no método **não cria outro** — devolve o mesmo enquanto não expirar. --- ## 14. Operadores (só Admin) Menu lateral → **"Operadores"**. Lista todos os operadores vinculados à empresa, com badge **Admin** ou **Operador**. ### Convidar novo operador Toque em **"Convidar"** (FAB). - E-mail (obrigatório). - Nome (opcional — usado se for cadastro novo). - **Tipo:** - **Operador** — opera dia-a-dia (códigos, clientes, recompensas). - **Admin** — pode gerenciar plano, faturas, operadores e cadastros. > **Se o e-mail já tiver conta MOC**, vincula direto. Senão, cria com senha aleatória — o operador ativa via **"esqueci minha senha"**. ### Cota do plano O número de operadores que o plano permite é **adicional ao proprietário** — você (dono da conta) não consome a cota. Plano Start (1) = você + 1 funcionário. Profissional (3) = você + 3. E por aí vai. Pra saber quantos operadores adicionais seu plano permite, abra **Plano** no menu lateral. ### Remover operador Lixeira ao lado do operador → confirmação modal → remoção imediata. > **Operadores comuns** veem a lista mas não podem convidar/remover (botões somem). --- ## 15. Suporte (tickets MOC) Menu lateral → **"Suporte"**. - Lista tickets que você abriu pro time MOC, filtrados por status. - **Abrir ticket:** botão flutuante. Assunto + mensagem. ### Detalhe do ticket - Thread de mensagens com avatar e timestamp. - **Composer** no rodapé pra responder enquanto o ticket está **aberto** ou **em atendimento**. - **Fechar ticket:** ícone X no topo (não pode reabrir, mas pode criar outro depois). --- ## 16. Meus dados, Senha, Sobre ### Meus dados Menu lateral → **"Meus dados"**. Edita nome e telefone. E-mail é fixo. ### Alterar senha Menu lateral → **"Alterar senha"**. Pede senha atual + nova + confirmação (mínimo 6 caracteres). ### Sobre - Versão do app. - Links pra Site, Política, Termos. --- ## 17. Sair Menu lateral → **"Sair"** (em vermelho, no rodapé). Limpa a sessão local. Próximo acesso pede login. --- ## 18. Notificações push Quando um cliente solicita resgate, faz alguma operação relevante, ou uma fatura está perto de vencer, você recebe **notificação push**. - Permita no primeiro login. - Pra reativar depois: **Config do celular → Apps → MOC Fidelidade - Empresa → Notificações**. --- ## 19. Bloqueio por inadimplência Se sua empresa tem **fatura atrasada**, operações de mutação ficam bloqueadas (gerar código, criar produto, ajustar saldo). Aparece a tarja vermelha no dashboard. **Liberadas mesmo inadimplente:** - Login / leitura. - Ver clientes, faturas, plano. - **Pagar a fatura** (PIX/Boleto/Cartão). Após pagamento confirmado (webhook do PSP), a tarja some sozinha — pode demorar alguns minutos. --- ## 20. FAQ — Erros comuns **"Código não encontrado" ao cliente tentar usar:** - Cliente errou o código. - Código expirou (verifique TTL ao gerar). - Código já foi usado por outra pessoa (cada código é one-shot). **"Saldo insuficiente" ao debitar:** - Cliente não tem saldo pra completar o débito. - Verifique histórico no detalhe do cliente. **"Falha no checkout" da fatura:** - Mercado Pago instável — espere 1 minuto e tente de novo. - Verifique se o boleto não está vencido (depois de 30 dias o link some). **"Categoria com produto vinculado":** - Você tentou excluir uma categoria que tem produtos. Mude esses produtos pra outra categoria primeiro. **App pede pra atualizar e não deixa entrar:** - Atualização **obrigatória** por mudança crítica. Atualize na loja. --- ## 21. Limites do plano Cada plano tem **limite de clientes ativos no mês**. "Cliente ativo" = cliente que recebeu ao menos uma marcação/pontuação no mês corrente. Atingiu o limite? Operações de gerar código pra clientes **novos no mês** bloqueiam até o próximo ciclo. Considere **upgrade de plano**. --- ## 22. Suporte - **Dentro do app:** menu **"Suporte"**. - **E-mail:** **contato@mocfidelidade.com.br** - **Site:** **https://mocfidelidade.com.br** > Todos os horários no app aparecem em **horário de São Paulo (UTC-3)**.