Introdução
O Contador de Acessos é uma plataforma para registrar visitantes em sites de imóveis, com painel administrativo geral (você) e painel do gestor (dono de cada site).
- Admin Geral — cadastra sites, define limites, valores e senhas dos gestores
- Gestor do Site — acompanha visitantes, relatórios, SEO e localidades
- Widget — script instalado no site do cliente que alimenta o contador
URLs padrão: /admin (administrador) e /dashboard (gestor).
Login e Acesso
Administrador
- Acesse
/admin no navegador
- Informe usuário e senha do administrador
- Login padrão inicial:
admin / admin123
Se esquecer a senha, use Esqueci a senha na tela de login. O aviso aparecerá no sino de notificações (se houver senha registrada).
Gestor do site
Cada site possui um usuário e senha próprios, criados no cadastro. O gestor acessa /dashboard.
Cadastro de Sites
Na aba Sites, clique em + Novo Site e preencha:
| Campo | Descrição |
| Nome do Site | Nome exibido nos relatórios (ex: Lançamentos Ibs) |
| Domínio | URL do site do cliente (ex: meusite.com.br/lancamentos) |
| IP do Site | Opcional — usado no perfil; se vazio, resolve pelo domínio |
| Máximo de Visitantes | Limite do contador (padrão: 15.000). Ao atingir, para de incrementar |
| Valor Único (R$) | Valor cobrado do gestor pela plataforma |
| Início / Fim do Disparo | Horário em que o contador incrementa (0–23). Pausa é o intervalo complementar |
| Usuário / Senha do Gestor | Credenciais de acesso ao painel do cliente |
Ações em cada site
- Acesso do Gestor — usuário, senha e link
/dashboard para consulta rápida
- Editar — altera nome, domínio, IP, limite, valor, horários e status ativo/inativo
- Senha — redefine a senha do gestor
- Código — exibe o script para instalar no site
- Excluir — remove o site e todos os dados vinculados
Instalação do Widget
Após criar o site, copie o código de instalação (botão Código) e cole antes do </body> do site do cliente:
<!-- Contador de Acessos -->
<script src="https://SEU-DOMINIO/widget.js" data-site-key="CHAVE_DO_SITE" async></script>
Substitua SEU-DOMINIO pelo endereço onde a plataforma está hospedada (ex: contador.seudominio.com).
A data-site-key é única por site e é gerada automaticamente no cadastro.
Painel do Gestor
O gestor, em /dashboard, pode:
- Ver contador de visitantes e estatísticas em tempo real
- Cadastrar localidades (bairros) para distribuição de visitantes
- Consultar relatórios por bairro, portais, canais de anúncio, gênero e faixa etária
- Ver Distribuição do Anúncio — como o anúncio é enviado a redes sociais, portais e buscadores
- Configurar SEO Premium (meta tags, Open Graph, Schema, FAQ)
- Ver perfil do site, IP e valor contratado
O administrador não precisa acessar o painel do gestor no dia a dia — apenas fornece usuário e senha ao cliente.
Senhas e Recuperação
Alterar senha do gestor (admin)
- Na aba Sites ou Financeiro, clique em Senha no site desejado
- Informe a nova senha (mínimo 4 caracteres) e confirme
- Salve — a alteração é imediata
Esqueci a senha (gestor)
O gestor clica em Esqueci a senha no login do dashboard. Você recebe um aviso no sino 🔔 com a senha registrada.
Se a senha não estiver salva (cadastros antigos), use o botão Senha no admin para definir uma nova.
Financeiro
Na aba Financeiro você controla os pagamentos únicos de cada site:
- Total Contratado — soma de todos os valores cadastrados
- Recebido / Pendente — valores já pagos e em aberto
- Marcar Pago — registra a data do pagamento automaticamente
- Observações — anotações livres (ex: PIX, boleto, parcela)
O valor também pode ser alterado na edição do site (aba Sites).
Notificações
O ícone 🔔 no topo exibe avisos de Esqueci a senha enviados por gestores ou pelo próprio admin.
Cada aviso mostra: usuário, site (se gestor), senha registrada e data/hora. Use Marcar todas como lidas para limpar o destaque.
Horário de Disparo e Pausa
Cada site possui horário próprio de disparo (quando o contador incrementa) e pausa (intervalo complementar), configurado no cadastro ou edição do site.
- Início do disparo — hora em que os visitantes começam a subir (0–23)
- Fim do disparo — hora em que o contador pausa (ex: 22 = até 21:59 ativo)
- Pausa — calculada automaticamente do fim até o início (ex: 22:00 às 06:00)
Padrão: 06:00 às 22:00 (pausa das 22:00 às 06:00), horário de Brasília. O gestor vê o status em tempo real no painel dele.
Publicação no cPanel
Para publicar em produção com Node.js no cPanel:
- Envie os arquivos do projeto (sem
node_modules)
- Crie um aplicativo Node.js (versão 18+) com startup
server.js
- Execute
npm install --production
- Configure variáveis de ambiente se necessário e reinicie o app
- Use HTTPS para sessões de login seguras
Consulte o arquivo CPANEL.md na raiz do projeto para o passo a passo detalhado.
Dúvidas Frequentes
- O contador não aumenta no site do cliente
- Verifique se o widget está instalado, se a
data-site-key está correta e se o site está ativo. Confira também o horário de disparo (06h–22h).
- O gestor não consegue entrar
- Use o botão Senha no admin para redefinir. Reinicie o servidor após alterações manuais no banco de dados.
- Como ver o código de instalação depois?
- Na aba Sites, clique em Código no card do site.
- O que acontece ao atingir o máximo de visitantes?
- O status muda para Limite e o contador para de subir. Edite o máximo ou reative conforme necessário.
- Os dados ficam onde?
- No arquivo
data.json na pasta do projeto. Faça backup regularmente em produção.