Centralized email / notification API for HaloRT apps.
| Repo | halort-notification-service |
| Stack | Express · TypeScript · BullMQ · Redis · PostgreSQL · React Email (@halort/email) |
| Local | http://127.0.0.1:8090/health |
| Production | https://notifications.halort.com |
Auth
Service-to-service: X-Halort-Internal-Key (INTERNAL_API_KEY).
Key routes
GET /healthPOST /v1/emails/send·POST /v1/emails/raw- Templates + delivery logs / retry
Templates (examples)
WELCOME, PASSWORD_RESET, PAYMENT_REMINDER, CONTACT_INQUIRY, CONTACT_AUTO_REPLY, …
Callers
- Surfaces/Platform API (product emails)
- Surfaces/Marketing Web (contact form)
Pipeline: API → Redis/BullMQ → worker → SMTP (or SES/SendGrid/Mailgun) → PostgreSQL logs. See Architecture/Request Flow · Architecture/Data Stores · Surfaces/Design System.
Deploy
Primary path: Hetzner K8s via GHCR + Argo CD. Legacy Mac mini / tunnel scripts may still exist in-repo for alternate hosting.