Home Explore Help
Register Sign In
lrosales
/
broad-announce
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki

No Description

Tree: 49b2dba791
Branches Tags
broad-announce
Luis Rosales 49b2dba791 M0(12/12): M0 verification doc, README refresh, SPEC §23 M0 shipped 2 months ago
cmd 66470fd871 M0(8-9/12): four service mains + ingestd HTTP POST handler 2 months ago
deploy 7cd922c72f M0(11/12): docker-compose, Dockerfile, .env.example, prometheus.yml 2 months ago
internal 66470fd871 M0(8-9/12): four service mains + ingestd HTTP POST handler 2 months ago
loadgen 4f4727bcdc M0(10/12): loadgen-http v0 with normal profile 2 months ago
.env.example 7cd922c72f M0(11/12): docker-compose, Dockerfile, .env.example, prometheus.yml 2 months ago
.gitignore 4f4727bcdc M0(10/12): loadgen-http v0 with normal profile 2 months ago
ARCHITECTURE.md 8ca86628a1 feat(spec): add gRPC bidi-streaming as fourth ingest protocol (M11) 2 months ago
Dockerfile 7cd922c72f M0(11/12): docker-compose, Dockerfile, .env.example, prometheus.yml 2 months ago
M0_VERIFICATION.md 49b2dba791 M0(12/12): M0 verification doc, README refresh, SPEC §23 M0 shipped 2 months ago
PROMPT.md 7483c74ecf feat(spec): source protection (throttling, quotas, circuit breaking) 2 months ago
README.md 49b2dba791 M0(12/12): M0 verification doc, README refresh, SPEC §23 M0 shipped 2 months ago
SPEC.md 49b2dba791 M0(12/12): M0 verification doc, README refresh, SPEC §23 M0 shipped 2 months ago
docker-compose.yml 7cd922c72f M0(11/12): docker-compose, Dockerfile, .env.example, prometheus.yml 2 months ago
go.mod d099955d6a M0(4-7/12): broker (NATS JS), store (redis), dedupe, ratelimit 2 months ago
go.sum d099955d6a M0(4-7/12): broker (NATS JS), store (redis), dedupe, ratelimit 2 months ago

README.md

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: M0 shipped 2026-06-13. Single-host docker-compose stack

  • 4 Go services + loadgen-http + alert schema. See M0_VERIFICATION.md for the smoke test. Spec is in SPEC.md, diagrams in ARCHITECTURE.md, build log in PROMPT.md.

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
M0_VERIFICATION.md  — M0 smoke test (signed webhook → 202)
docker-compose.yml  — single-host M0 stack
Dockerfile          — multi-stage build for all 5 binaries
.env.example        — every BA_* knob documented
cmd/ingestd/        — HTTP POST handler (M0), other transports in M4/M5/M11
cmd/routerd/        — scaffold (M2)
cmd/deliverd/       — scaffold (M3+)
cmd/admind/         — scaffold + /v1/ping (M8)
loadgen/cmd/http/   — traffic generator (M0)
internal/alert/     — Alert v1 type + Validate()
internal/broker/    — NATS JetStream wrapper
internal/config/    — env-driven config
internal/dedupe/    — 60s SET NX EX + INCR
internal/ratelimit/ — per-second INCR bucket
internal/httpserver/ — /health + /metrics scaffold
internal/observability/ — slog + Prometheus
internal/store/     — Redis + (later) Postgres
deploy/prometheus/  — prometheus.yml
migrations/         — (coming, M2)
testfakes/          — (coming, M3) fake-FCM, fake-Telegram, fake-SMS

License

Private. © 2026 Techno-World.