📊 Public Analytics API

API completa de analytics com integração Discord para rastreamento de visualizações em tempo real.

🚀 Recursos

• ✅ API REST completa com Express.js
• ✅ Banco de dados SQLite para persistência
• ✅ Notificações em tempo real no Discord via Webhook
• ✅ Bot Discord com comandos interativos
• ✅ Estatísticas detalhadas por página
• ✅ Histórico de visualizações recentes
• ✅ CORS habilitado para uso público

📋 Pré-requisitos

• Node.js 16+ instalado
• Conta no Discord
• Servidor Discord (para o bot)

🔧 Instalação

1. Clone o repositório

git clone https://github.com/rickcosta-dev/public-analytics-api.git
cd public-analytics-api

2. Instale as dependências

npm install

3. Execute o setup

npm run setup

4. Configure o Discord

Criar Webhook:

1. Acesse seu servidor Discord
2. Vá em Configurações do Servidor > Integrações > Webhooks
3. Clique em Novo Webhook
4. Copie a URL do webhook

Criar Bot:

1. Acesse Discord Developer Portal
2. Clique em New Application
3. Vá em Bot > Add Bot
4. Copie o Token
5. Em OAuth2 > URL Generator, selecione:
   • Scopes: bot, applications.commands
   • Permissions: Send Messages, Embed Links, Use Slash Commands
6. Copie a URL gerada e adicione o bot ao seu servidor

5. Configure as variáveis de ambiente

Edite o arquivo .env:

PORT=3000
API_URL=http://localhost:3000
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/SEU_WEBHOOK_AQUI
BOT_TOKEN=SEU_TOKEN_DO_BOT_AQUI
DISCORD_CHANNEL_ID=ID_DO_CANAL (opcional)

🎯 Uso

Iniciar apenas a API

npm start

Iniciar apenas o Bot

npm run bot

Iniciar API + Bot simultaneamente

npm run all

Modo desenvolvimento (com hot reload)

npm run dev      # Apenas API
npm run dev:bot  # Apenas Bot
npm run all      # API + Bot

📡 Endpoints da API

POST /api/view

Registra uma nova visualização

Request:

{
  "page": "/home",
  "userAgent": "Mozilla/5.0...",
  "ip": "192.168.1.1"
}

Response:

{
  "success": true,
  "message": "View recorded successfully",
  "data": {
    "view": {
      "id": 1,
      "page": "/home",
      "userAgent": "Mozilla/5.0...",
      "ip": "192.168.1.1",
      "timestamp": "2024-01-15T10:30:00.000Z"
    },
    "totalViews": 42
  }
}

GET /api/stats

Retorna estatísticas gerais

Response:

{
  "success": true,
  "data": {
    "totalViews": 150,
    "pages": {
      "/home": 100,
      "/about": 30,
      "/contact": 20
    }
  }
}

GET /api/stats/:page

Retorna estatísticas de uma página específica

Response:

{
  "success": true,
  "data": {
    "page": "/home",
    "views": 100
  }
}

GET /api/recent?limit=10

Retorna visualizações recentes

Response:

{
  "success": true,
  "data": [
    {
      "id": 150,
      "page": "/home",
      "user_agent": "Mozilla/5.0...",
      "ip": "192.168.1.1",
      "timestamp": "2024-01-15T10:30:00.000Z"
    }
  ]
}

🤖 Comandos do Bot Discord

/stats

Exibe estatísticas completas do analytics

• Total de visualizações
• Top 10 páginas mais acessadas

/recent [limit]

Exibe visualizações recentes

• limit: Número de visualizações (1-25, padrão: 10)

/page [path]

Exibe estatísticas de uma página específica

• path: Caminho da página (ex: /home)

📦 Estrutura do Projeto

public-analytics-api/
├── src/
│   ├── index.js                 # Entrada principal da API
│   ├── routes.js                # Definição das rotas
│   ├── database.js              # Configuração do SQLite
│   └── services/
│       ├── analyticsService.js  # Lógica de negócio
│       └── discordService.js    # Integração Discord
├── bot/
│   └── bot.js                   # Bot Discord com comandos
├── scripts/
│   └── setup.js                 # Script de configuração inicial
├── data/
│   └── analytics.db             # Banco de dados (criado automaticamente)
├── .env                         # Variáveis de ambiente
├── .env.example                 # Exemplo de configuração
├── .gitignore                   # Arquivos ignorados pelo Git
├── package.json                 # Dependências e scripts
└── README.md                    # Documentação

Imagem

🔒 Segurança

• ✅ Não exponha seu .env no Git
• ✅ Use HTTPS em produção
• ✅ Configure rate limiting se necessário
• ✅ Valide todos os inputs do usuário
• ✅ Considere adicionar autenticação para endpoints sensíveis

🌐 Deploy

Heroku

heroku create seu-app
heroku config:set DISCORD_WEBHOOK_URL=sua_url
heroku config:set BOT_TOKEN=seu_token
git push heroku main

Railway

railway login
railway init
railway add
railway up

Render

1. Conecte seu repositório
2. Configure as variáveis de ambiente
3. Deploy automático a cada push

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para:

1. Fork o projeto
2. Criar uma branch (git checkout -b feature/NovaFuncionalidade)
3. Commit suas mudanças (git commit -m 'Adiciona nova funcionalidade')
4. Push para a branch (git push origin feature/NovaFuncionalidade)
5. Abrir um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📞 Suporte

• 🐛 Encontrou um bug? Abra uma issue
• 💡 Tem uma sugestão? Abra uma discussion
• 📧 Email: rickdev0021@gmail.com
• Discord: rickzin02

🎉 Agradecimentos

• Express.js
• Discord.js
• SQLite

---

Feito com ❤️ por RickZin