Se você já precisou saber se um e-mail foi aberto, qual o alcance de um post em um fórum ou o engajamento de uma imagem no GitHub, sabe que ferramentas de rastreamento costumam ser invasivas ou excessivamente complexas.
O Imagem Acompanhada (parte do ecossistema Crom) surge como um micro-serviço em Go projetado para transformar qualquer imagem em um motor de analytics completo, sem abrir mão da soberania de dados.
O que é o projeto?
O Imagem Acompanhada v4 é um serviço de proxy de imagens que permite embutir rastreamento em ativos visuais. Ele funciona de forma híbrida, atendendo desde o usuário que quer apenas um link temporário rápido até quem deseja oferecer um serviço de rastreamento profissional.
Diferenciais Técnicos e de Privacidade
- Privacidade Blindada (LGPD-Ready): Diferente de rastreadores comuns, o sistema não armazena o IP nominal dos visitantes. Ele utiliza fingerprints criptográficos (Hash + SALT), garantindo que a análise de dados seja possível sem expor a identidade do usuário.
- Arquitetura Local-First: O sistema prioriza o armazenamento físico local (
./storage) e utiliza SQLite, mantendo o controle total dos dados sob o seu domínio. - Hard Delete Sweeper: Uma rotina automática de "vassoura" verifica ativos expirados a cada hora, destruindo fisicamente os arquivos e removendo os registros do banco de dados de forma irrevogável.
Modos de Operação
O projeto pode ser configurado em dois modos principais através de variáveis de ambiente:
- Modo Snipboard (Free): Focado em agilidade. O usuário solta uma imagem no Dropzone (
Ctrl+V) e recebe instantaneamente uma URL pública e um Tracker Proxy. A imagem expira conforme a configuração de dias definida na interface. - Modo Pixel SaaS: Habilita a integração com Webhooks do MercadoPago. Neste modo, o rastreador é gerado com status pendente (exibindo uma imagem branca) até que o pagamento seja processado, permitindo a venda de rastreadores baseados em tempo de retenção ou volume de visualizações.
Por que ser Open Source?
A filosofia por trás deste projeto é a soberania digital. Ser open-source significa que você não precisa confiar em uma empresa terceira para gerenciar seus pixels de rastreamento. Você pode hospedar sua própria instância, auditar o código e garantir que as informações de tráfego dos seus clientes ou leitores permaneçam privadas e sob seu controle.
Como começar a usar (Quickstart)
Para quem deseja rodar o projeto localmente ou em seu próprio servidor, a estrutura está pronta para Docker:
- Configure o ambiente:
cp .env.example .env
Defina o `APP_MODE` (saas ou free) e suas credenciais SMTP para notificações.
2. **Suba o serviço:**
docker-compose up -d --build
A dashboard ficará acessível em `localhost:8080`, onde você poderá gerenciar seus ativos e visualizar relatórios de acesso.
## Contribua!
O Imagem Acompanhada é um projeto vivo. Se você é desenvolvedor Go, entusiasta de infraestrutura ou defensor da privacidade, sinta-se convidado a explorar o código, abrir issues ou enviar Pull Requests.
Acompanhe o projeto e veja ele em funcionamento: [https://crom.run/imagem-acompanhada](https://crom.run/imagem-acompanhada)