PromoRadar

Hub operacional de oportunidades comerciais e monitoramento de sinais (MVP local).

Operational hub for commercial opportunities and signal monitoring (local MVP).

PT-BR · English · Stack · Architecture · Quick Start · Author

Repo · Portfolio · LinkedIn

MVP notice: local Next.js (Pages Router) + SQLite app. No public homepage/demo configured. Ingestion may involve Telegram-related client code — use only with accounts/APIs you are authorized to automate; do not abuse unofficial scraping.

---

PT-BR

Visão geral

O PromoRadar é um MVP de central operacional: ingestão de sinais, processamento/parse, feed de oportunidades, alertas, cupons, histórico e saúde de ingestão — com APIs em pages/api/* e SQLite.

Problema

Oportunidades comerciais chegam espalhadas em canais barulhentos; falta um cockpit local para triagem, alerta e auditoria leve.

Para quem

Operadores que querem um MVP local de monitoramento de promoções/sinais (não um SaaS enterprise).

Funcionalidades (conforme código)

• Painel / feed de oportunidades
• Rotas API: opportunities, alerts, coupons, sources, ingest, process, history, settings, db-status
• Camadas lib/ingestion + lib/processor + SQLite
• Verificador de cupons e gerenciador de alertas (UI MVP)

Escopo e limites (honestos)

• MVP local — sem demo Vercel no homepage
• Licença ainda “a definir” no README legado (sem LICENSE no root)
• Integrações de canal exigem credenciais próprias e uso autorizado

---

English

Overview

PromoRadar is an operational MVP: signal ingest, parse/process, opportunity feed, alerts, coupons, history and ingestion health — via pages/api/* and SQLite.

Problem

Commercial opportunities arrive scattered across noisy channels; a local triage/alert/audit cockpit is missing.

Who it is for

Operators who want a local MVP for promo/signal monitoring (not enterprise SaaS).

Features (as implemented)

• Opportunities dashboard/feed
• API routes: opportunities, alerts, coupons, sources, ingest, process, history, settings, db-status
• lib/ingestion + lib/processor + SQLite
• Coupon checker and alert manager (MVP UI)

Scope and honest limits

• Local MVP — no Vercel homepage demo
• License still “to be defined” (no root LICENSE in clone)
• Channel integrations need your own credentials and authorized use

---

Stack

Layer	Technology
Web	Next.js 14 (Pages Router), React 18
Data	SQLite (sqlite3)
Ingest	Node services under src/lib

---

Architecture

src/pages          UI + API routes
src/lib/ingestion  ingest services
src/lib/processor  parsers / processing

---

Quick Start

cp .env.example .env
npm install
npm run dev

---

Technical decisions

• SQLite + API routes for a single-process MVP
• Separate ingest vs process modules for clearer ops debugging
• Keep secrets in .env (never commit sessions/tokens)

---

Roadmap

• Decide/add SPDX license file
• Harden auth for admin settings
• Optional hosted demo with synthetic signals only

---

Author

Felipe Alirio Baruja — data / product / full-stack portfolio.

• Portfolio: https://barujafe.vercel.app/
• GitHub: https://github.com/BarujaFe1
• LinkedIn: https://www.linkedin.com/in/barujafe/

License

License to be defined — no LICENSE file in this repository yet.