broad-announce

broad-announce

Multi-tenant notification router. Receives alerts from many source systems (HTTP/JSON webhooks, WebSockets, MQTT, gRPC bidi-streaming), normalizes them, resolves recipients via companies → groups → individuals + subscriptions, and delivers to FCM (Android), Telegram, SMS, email, voice, Slack, MS Teams, and arbitrary outbound webhooks.

Status: spec + architecture, no code yet. See SPEC.md for requirements and ARCHITECTURE.md for diagrams / sequence flows / capacity model. PROMPT.md is the build log.

v1 in one paragraph

Four Go services (ingestd, routerd, deliverd, admind) wired together by NATS JetStream. Postgres + Timescale for live data, ClickHouse for archive, Redis for dedupe + rate limits, EMQX for MQTT. Strict app-level multi-tenant isolation. ~5k alerts/sec on Docker Compose, 50k/sec design ceiling for v2 K8s.

Repo layout

SPEC.md           — requirements, entities, severity, retention
ARCHITECTURE.md   — diagrams, sequences, SLOs, capacity model
PROMPT.md         — build log, decisions, open questions
migrations/       — (coming) golang-migrate SQL files
ingestd/          — (coming) HTTP/WS/MQTT/gRPC ingest binary
routerd/          — (coming) recipient resolution binary
deliverd/         — (coming) per-channel delivery workers
admind/           — (coming) admin HTTP API + UI host
loadgen/          — (coming) per-protocol traffic generators
internal/         — (coming) shared Go packages
deploy/           — (coming) prometheus, grafana, loki configs
docker-compose.yml — (coming) one-shot local stack

License

Private. © 2026 Techno-World.