Manual do Usuário - Gestor de Clientes

1. Introdução

O Gestor de Clientes é o painel usado para acompanhar clientes de servidor de streaming: cadastro, vencimentos, pagamentos, cobrança por WhatsApp e lembretes automáticos. Este manual cobre tudo que você, como usuário, vai usar no dia a dia.

💡 Seus dados ficam separados dos de outros usuários — cada pessoa vê e edita só os próprios clientes.

1.1 Fazendo login

Abra o link do aplicativo no navegador do celular ou computador.
Clique em "Entrar com Google".
Escolha a conta Google autorizada pelo administrador.

💡 Se aparecer "e-mail ainda não tem acesso liberado", peça ao administrador para liberar seu e-mail.

1.2 Instalando como aplicativo no celular

Abra o link no Chrome (Android) ou Safari (iPhone).
Toque no menu do navegador e escolha "Instalar aplicativo" (Android) ou "Adicionar à Tela de Início" (iPhone).
O ícone passa a aparecer junto com os outros aplicativos do celular, abrindo em tela cheia.

2. Visão geral do painel

Assim que você loga, vê o painel principal com um resumo dos seus clientes:

Total — quantos clientes você tem cadastrados.
Vencidos — clientes com a data de vencimento já passada.
Vence em 3 dias — clientes cujo vencimento está próximo.
Em dia — clientes sem pendência de vencimento.
Receita mensal (MRR) — soma do valor de todos os clientes, normalizado por mês. Tem um ícone 👁 ao lado: clique para ocultar/mostrar esse valor.

No topo da tela também ficam os botões de Notificações, tema claro/escuro, Relatório, Exportar CSV, Configurações e Sair.

3. Cadastrando um cliente

Clique em "+ Novo cliente".
Preencha os campos do formulário (detalhados abaixo).
Clique em "Salvar".

3.1 Campos do formulário

Nome completo — nome do cliente.
Tipo de servidor — qual servidor atende esse cliente (o app sugere os servidores já cadastrados).
Tipo do plano — descrição livre do plano (ex: "1 tela", "Premium 4K").
Data de vencimento — quando o serviço deste cliente precisa ser renovado.
Ciclo de renovação — Mensal, Trimestral, Semestral ou Anual. Define de quanto em quanto tempo o botão "Renovar" avança a data.
Próxima cobrança mensal — só aparece se o ciclo não for mensal. É um lembrete separado, útil para clientes trimestrais/semestrais que você quer relembrar todo mês, sem mexer na data de vencimento real.
Valor da renovação — valor cobrado nesse ciclo.
WhatsApp — número do cliente, usado pelos botões de mensagem.
Renovação já paga — marque se o cliente já pagou essa cobrança.
Observações — texto livre para anotações (ex: "prefere pagar por PIX").

💡 Renovar (avançar a data) e Pago (status financeiro) são independentes: marcar como pago não muda a data de vencimento, e vice-versa.

3.2 Editando ou excluindo um cliente

No card do cliente, use o ícone ✎ para editar os dados, ou ✕ para excluir permanentemente (o app pede confirmação antes de excluir).

4. Entendendo os status

Cada cliente mostra dois selos (badges) de status:

4.1 Status de vencimento

Vencido — a data já passou.
Vence em X dias — está a 3 dias ou menos do vencimento.
Em dia — vencimento distante, sem urgência.

4.2 Status de pagamento

Pago — a cobrança dessa etapa já foi recebida.
Pendente — ainda não foi paga.

💡 O status de pagamento não afeta os lembretes: mesmo que o cliente pague adiantado, o app continua avisando conforme a data de vencimento se aproxima, até você clicar em "Renovar".

5. Ações rápidas em cada cliente

Cobrar renovação — abre o WhatsApp com uma mensagem de cobrança já pronta, que muda conforme o status (vencido, vencendo ou pago).

💬

Conversa livre — abre o WhatsApp com o cliente sem nenhum texto pronto.

🗓

Google Agenda — cria um lembrete no seu Google Agenda com os dados do cliente e a data certa.

↻

Renovar — avança a data de vencimento para o próximo ciclo e volta o pagamento para pendente. Use quando você efetivamente renovar o serviço do cliente no servidor.

$ / ✓

Marcar pago / pendente — alterna o status financeiro do cliente, sem alterar a data de vencimento.

📅

Cobrança mensal feita — aparece só em clientes com ciclo não mensal. Avança só o lembrete de cobrança mensal em 1 mês, sem mexer no vencimento real.

✎ / ✕

Editar / Excluir — edita os dados do cliente ou remove o cadastro permanentemente.

6. Buscando e filtrando clientes

Campo de busca — digite nome, servidor ou plano para filtrar a lista.
Filtros de status — Todos, Vencidos, Vencendo, Em dia, Pendentes, Pagos.
Filtro por servidor — mostra só os clientes de um servidor específico.

7. Alternando a visualização

O botão "⇄" no topo alterna entre três formatos de exibição:

Cards — visualização padrão, com todos os detalhes.
Lista compacta — uma linha por cliente, ideal para muitos clientes na tela.
Tabela — formato de planilha, com colunas ordenáveis (clique no cabeçalho da coluna para ordenar).

💡 A escolha de visualização fica salva no navegador e é lembrada da próxima vez que você abrir o app.

8. Selecionando vários clientes de uma vez

Marque a caixinha de seleção no canto de cada cliente que deseja marcar como pago.
Uma barra aparece no rodapé mostrando quantos foram selecionados.
Clique em "Marcar como pago" para aplicar a todos de uma vez, ou "Cancelar" para desmarcar.

9. Exportando para CSV

O botão "Exportar CSV" no topo baixa um arquivo com os clientes visíveis no momento (respeitando os filtros aplicados), pronto para abrir no Excel ou Google Sheets.

10. Relatório mensal

O botão "Relatório" abre um resumo financeiro do mês escolhido:

Receita — quanto você recebeu, separado por servidor, com base nos pagamentos marcados.
Despesas — registre e acompanhe os "abastecimentos" que você faz nos painéis de servidor (valor, servidor e data), com o total gasto e quantas vezes abasteceu cada um.
Lucro líquido do mês — receita menos despesas, calculado automaticamente.

💡 O relatório só considera pagamentos e despesas registrados a partir do momento em que essas funções foram criadas — não reconstrói histórico anterior.

11. Configurações (⚙)

No botão de engrenagem, você pode configurar uma agenda do Google dedicada para os lembretes de clientes (em vez de usar sua agenda pessoal principal). Isso é útil se sua agenda principal for compartilhada com outras pessoas, evitando que elas vejam os lembretes de clientes.

Crie uma agenda nova no Google Agenda, sem compartilhar com ninguém.
Copie o "ID da agenda" nas configurações dela (opção "Integrar agenda").
Cole esse ID no campo de Configurações do app e clique em Salvar.

💡 Esse campo é opcional. Se deixado em branco, os lembretes vão para sua agenda principal do Google.

12. Notificações e aparência

12.1 Notificações

O botão "Notificações" no topo pede permissão do navegador para avisos do sistema. Uma vez ativado, o app confere os vencimentos ao abrir e a cada 30 minutos enquanto estiver aberto (mesmo minimizado), avisando sobre clientes vencidos ou perto do vencimento.

💡 As notificações só chegam enquanto o app estiver aberto ou minimizado — se for fechado por completo, nenhum aviso é enviado.

12.2 Tema claro/escuro

O ícone ◐ no topo alterna entre modo claro e escuro. A escolha fica salva no navegador.

13. Privacidade dos seus dados

Cada usuário só enxerga e edita os próprios clientes. Outros usuários comuns não têm acesso aos seus dados. O administrador da plataforma tem uma visão consolidada de todos os usuários, para fins de acompanhamento e segurança da operação.