BuscaLogo Server

Servidor web de coleta e análise de conteúdo com scraping, busca P2P e PouchDB.

Instalação

# Global
npm install -g buscalogo-server

# Comandos: bls ou buscalogo-server
bls
# ou: npx bls

Uso Rápido

# 1. Configurar ambiente
cp .env.example .env
# Edite .env com suas configurações

# 2. Iniciar
bls
# ou: npx bls

Servidor em http://localhost:3005 (ou PORT no .env).

A pasta db/ é criada automaticamente em process.cwd()/db. Com npx ou instalação global, defina POUCHDB_PATH no .env para escolher outro diretório (ex: persistir fora do cache npm).

Características

• PouchDB – Banco local com sincronização
• Scraping – Coleta web com fila e progresso em tempo real
• Interface – Dashboard com Tailwind CSS
• WebSocket – Comunicação em tempo real
• P2P – Comunicação entre instâncias

Scripts

| Script | Descrição | |--------|-----------| | npm start | Inicia servidor | | npm run start:daemon | Inicia em segundo plano (detached) | | npm run dev | Desenvolvimento com hot-reload | | npm run build | Build CSS + JS | | npm run build:prod | Build otimizado (executado antes do publish) |

Segundo plano (daemon)

# Via flag (global ou npx)
bls -d
# ou: npx bls --daemon

# Via npm (no projeto)
npm run start:daemon

# Via PM2 (produção)
npm install -g pm2
pm2 start ecosystem.config.cjs
pm2 save && pm2 startup

Estrutura

├── server.js          # Entry point
├── src/
│   ├── routes/        # API e web
│   ├── services/      # PouchDB, scraping, P2P, auth
│   ├── views/         # Templates EJS
│   └── middleware/
└── public/            # CSS, JS estáticos

API

Bancos

• GET/POST /api/databases – Listar/criar
• DELETE /api/databases/:name – Remover
• POST /api/databases/:name/connect-remote – Conectar remoto
• POST /api/databases/:local/sync/:remote – Sincronizar

Scraping

• GET/POST /api/scraping/tasks – Listar/criar tarefas
• GET/DELETE /api/scraping/tasks/:id – Status/cancelar

Documentos

• GET/POST /api/databases/:db/docs – Listar/adicionar
• PUT/DELETE /api/databases/:db/docs/:id – Atualizar/remover

Variáveis de Ambiente

PORT=3005
NODE_ENV=development
POUCHDB_ADAPTER=memory
POUCHDB_PREFIX=buscalogo_
POUCHDB_PATH=/caminho/absoluto    # Persistência (recomendado com npx/global)
MAX_CONCURRENT_SCRAPING=3
DEFAULT_TIMEOUT=30000
SESSION_SECRET=change-me-in-production
P2P_SIGNALING_URLS=ws://localhost:3001

Pré-requisitos

• Node.js 18+

Licença

MIT – LICENSE