dc840bfc14
The Communications surface. Hosts can schedule custom broadcasts to a
chosen audience (everyone / attending / pending / declined / maybe),
edit or cancel anything that hasn't fired, and review delivery
outcomes. Four auto-reminders are pre-seeded on every new event:
7-day, 3-day last call, 1-day, and day-of.
Schema (migration 0012)
- scheduled_messages — one row per message envelope, with status
walking draft -> scheduled -> sending -> sent (or cancelled/failed).
Partial index on (send_at) WHERE status='scheduled' for the
scheduler poll; per-event index for the Communications tab list.
- message_deliveries — per-recipient outcomes so a partial-failure
batch doesn't lose the rows that did succeed.
Domain
- MessageAudience / MessageChannel / MessageStatus enums
- SeedAutoReminders helper that returns four canonical reminder rows
for a given event_date, skipping any whose send_at would land in
the past (events created close to the date)
Storage
- MessageRepo: Create / CreateBatch / Get / ListByEvent / Update
(locks the row and refuses unless status is draft|scheduled) /
Cancel / PromoteToScheduled (the send-now path) / ListDue /
ClaimForSending (atomic guard against two replicas double-sending) /
MarkSent / MarkFailed / RecordDelivery / DeliveryStats /
LoadRecipients (audience-filtered guest list) / CountRecipients
- EventRepo.Create now seeds auto-reminders in the same transaction
that inserts the event and its owner collaborator row
API (all editor+, except recipient-count which is viewer+)
- GET /events/{id}/messages
- GET /events/{id}/messages/recipient-count?audience=...
- POST /events/{id}/messages (draft / schedule / send-now)
- PATCH /events/{id}/messages/{message_id}
- POST /events/{id}/messages/{message_id}/send-now
- DELETE /events/{id}/messages/{message_id}
Scheduler worker (cmd/notifier)
- New file scheduler.go: polls ListDue every 30s, claims each row
atomically (ClaimForSending uses a status=scheduled guard so two
notifier replicas don't double-send), renders subject and body
per recipient with the {{guest_name}} / {{event_name}} /
{{event_date}} / {{venue}} / {{rsvp_link}} placeholders, sends via
the existing GuestEmailDispatcher (Resend > SMTP > SES > log
stub, same picker as the API), records each delivery row.
Frontend
- New CommunicationsCard.vue with compose form (audience + channel +
subject + body + send-mode radios), live "X guests will receive
this" recipient-count preview, and three sub-tabs for Scheduled /
Sent / Cancelled. Per-message Send-now and Cancel actions for
draft/scheduled rows. Friendly labels for auto-seeded reminders
("1-day reminder", "Day-of reminder") so the slugs never leak.
- New top-level tab "Communications" on the event-detail page,
between Collaborators and Branding.
Tests
- TestAutoReminderSeeding confirms a future-dated event lands the
four canonical reminders in scheduled state.
- TestComposeAndEditMessage walks draft -> patch -> send-now ->
cancel and asserts the conflict on PATCH-after-cancel.
- TestRecipientCountAudienceFilter seeds a known guest mix and
checks every audience preset returns the right count.
- Full integration suite passes (~177s).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
356 lines
8.8 KiB
Go
356 lines
8.8 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
"log/slog"
|
|
"os"
|
|
"os/signal"
|
|
"syscall"
|
|
|
|
"github.com/alchemistkay/guestguard/internal/config"
|
|
"github.com/alchemistkay/guestguard/internal/natspub"
|
|
"github.com/alchemistkay/guestguard/internal/notification"
|
|
"github.com/alchemistkay/guestguard/internal/storage"
|
|
)
|
|
|
|
func main() {
|
|
if err := run(); err != nil {
|
|
slog.Error("fatal", "err", err)
|
|
os.Exit(1)
|
|
}
|
|
}
|
|
|
|
func run() error {
|
|
cfg, err := config.Load()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
logger := slog.New(slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{Level: levelFor(cfg.Env)}))
|
|
slog.SetDefault(logger)
|
|
logger = logger.With("service", "notifier")
|
|
|
|
rootCtx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
|
|
defer stop()
|
|
|
|
logger.Info("connecting to database")
|
|
db, err := storage.NewDB(rootCtx, cfg.DatabaseURL)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer db.Close()
|
|
|
|
logger.Info("connecting to nats", "url", cfg.NATSURL)
|
|
natsClient, err := natspub.Connect(rootCtx, cfg.NATSURL, logger)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer natsClient.Close()
|
|
|
|
repo := notification.NewRepo(db)
|
|
suppressions := notification.NewSuppressionRepo(db)
|
|
tpls, err := notification.NewTemplates()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
// Email dispatcher: Resend > SMTP > SES > log stub, same picker as cmd/api.
|
|
combinedEmail, backend, err := notification.PickEmailSender(rootCtx, notification.EmailSenderConfig{
|
|
Resend: notification.ResendConfig{
|
|
APIKey: cfg.ResendAPIKey,
|
|
FromEmail: cfg.ResendFromEmail,
|
|
FromName: cfg.ResendFromName,
|
|
},
|
|
SMTP: notification.SMTPConfig{
|
|
Host: cfg.SMTPHost,
|
|
Port: cfg.SMTPPort,
|
|
Username: cfg.SMTPUsername,
|
|
Password: cfg.SMTPPassword,
|
|
FromEmail: cfg.SMTPFromEmail,
|
|
FromName: cfg.SMTPFromName,
|
|
TLS: cfg.SMTPTLS,
|
|
},
|
|
SES: notification.SESConfig{
|
|
Region: cfg.SESRegion,
|
|
FromEmail: cfg.SESFromEmail,
|
|
FromName: cfg.SESFromName,
|
|
ConfigurationSet: cfg.SESConfigurationSet,
|
|
PublicBaseURL: cfg.PublicBaseURL,
|
|
},
|
|
}, tpls, logger)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
logger.Info("email backend selected", "backend", backend)
|
|
emailSender := notification.NewEmailSender(combinedEmail, suppressions)
|
|
|
|
// SMS: Twilio when creds are set, otherwise no-op log sender.
|
|
var smsSender notification.Sender
|
|
if cfg.TwilioAccountSID != "" && cfg.TwilioAuthToken != "" && cfg.TwilioFromNumber != "" {
|
|
t, err := notification.NewTwilioSender(notification.TwilioConfig{
|
|
AccountSID: cfg.TwilioAccountSID,
|
|
AuthToken: cfg.TwilioAuthToken,
|
|
FromNumber: cfg.TwilioFromNumber,
|
|
})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
smsSender = t
|
|
logger.Info("twilio sms sender configured", "from", cfg.TwilioFromNumber)
|
|
} else {
|
|
smsSender = notification.LogSender{}
|
|
logger.Info("twilio not configured — SMS will use the log stub")
|
|
}
|
|
|
|
sender := notification.NewRouter(emailSender, smsSender)
|
|
|
|
rsvpSub, err := natspub.NewRSVPConfirmedSubscriber(
|
|
rootCtx, natsClient, "notifier-rsvp-confirmed",
|
|
func(ctx context.Context, evt natspub.RSVPConfirmed) error {
|
|
return handleRSVPConfirmed(ctx, logger, repo, sender, evt)
|
|
},
|
|
logger,
|
|
)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
rsvpCC, err := rsvpSub.Start(rootCtx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer rsvpCC.Stop()
|
|
|
|
fraudSub, err := natspub.NewFraudScoredSubscriber(
|
|
rootCtx, natsClient, "notifier-fraud-scored",
|
|
func(ctx context.Context, evt natspub.FraudScored) error {
|
|
return handleFraudScored(ctx, logger, repo, sender, evt)
|
|
},
|
|
logger,
|
|
)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
fraudCC, err := fraudSub.Start(rootCtx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer fraudCC.Stop()
|
|
|
|
invitationSub, err := natspub.NewInvitationSendSubscriber(
|
|
rootCtx, natsClient, "notifier-invitation-send",
|
|
func(ctx context.Context, evt natspub.InvitationSend) error {
|
|
return handleInvitationSend(ctx, logger, repo, sender, evt)
|
|
},
|
|
logger,
|
|
)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
invitationCC, err := invitationSub.Start(rootCtx)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer invitationCC.Stop()
|
|
|
|
// Block F — scheduled-message worker. Polls scheduled_messages
|
|
// every 30s and dispatches due rows through the same email
|
|
// pipeline as the NATS-driven flows.
|
|
scheduler := newScheduledMessageWorker(logger, db, combinedEmail, cfg.PublicBaseURL)
|
|
go scheduler.Start(rootCtx)
|
|
|
|
logger.Info("notifier started")
|
|
<-rootCtx.Done()
|
|
logger.Info("notifier shutting down")
|
|
return nil
|
|
}
|
|
|
|
func handleRSVPConfirmed(
|
|
ctx context.Context,
|
|
logger *slog.Logger,
|
|
repo *notification.Repo,
|
|
sender notification.Sender,
|
|
evt natspub.RSVPConfirmed,
|
|
) error {
|
|
msg := notification.OutboundMessage{
|
|
GuestID: evt.GuestID,
|
|
Channel: notification.ChannelEmail,
|
|
Type: notification.TypeConfirmation,
|
|
Subject: "Your RSVP is confirmed",
|
|
Body: "Thanks for your response.",
|
|
Metadata: map[string]any{
|
|
"rsvp_id": evt.RSVPID,
|
|
"event_id": evt.EventID,
|
|
"response": evt.Response,
|
|
"plus_ones": evt.PlusOnes,
|
|
"risk_score": evt.RiskScore,
|
|
"submitted_at": evt.SubmittedAt,
|
|
},
|
|
}
|
|
|
|
providerID, sendErr := sender.Send(ctx, msg)
|
|
status := notification.StatusSent
|
|
errStr := ""
|
|
if sendErr != nil {
|
|
status = notification.StatusFailed
|
|
errStr = sendErr.Error()
|
|
}
|
|
|
|
id, err := repo.Record(ctx, notification.RecordParams{
|
|
GuestID: evt.GuestID,
|
|
Channel: msg.Channel,
|
|
Type: msg.Type,
|
|
Status: status,
|
|
ProviderID: providerID,
|
|
Error: errStr,
|
|
})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
logger.Info("notification dispatched",
|
|
"notification_id", id,
|
|
"guest_id", evt.GuestID,
|
|
"channel", msg.Channel,
|
|
"type", msg.Type,
|
|
"status", status,
|
|
"provider_id", providerID,
|
|
)
|
|
return nil
|
|
}
|
|
|
|
func handleFraudScored(
|
|
ctx context.Context,
|
|
logger *slog.Logger,
|
|
repo *notification.Repo,
|
|
sender notification.Sender,
|
|
evt natspub.FraudScored,
|
|
) error {
|
|
// Only alert when the score crosses a meaningful threshold; low/medium
|
|
// scores are noise for the host.
|
|
if evt.Score < 60 {
|
|
return nil
|
|
}
|
|
|
|
msg := notification.OutboundMessage{
|
|
GuestID: evt.GuestID,
|
|
Channel: notification.ChannelEmail,
|
|
Type: notification.TypeReminder, // reusing existing enum; a fraud_alert type would be nicer
|
|
Subject: "Suspicious access attempt detected",
|
|
Body: "A flagged access attempt occurred for one of your guests.",
|
|
Metadata: map[string]any{
|
|
"event_id": evt.EventID,
|
|
"score": evt.Score,
|
|
"risk": evt.Risk,
|
|
"reasons": evt.Reasons,
|
|
},
|
|
}
|
|
|
|
providerID, sendErr := sender.Send(ctx, msg)
|
|
status := notification.StatusSent
|
|
errStr := ""
|
|
if sendErr != nil {
|
|
status = notification.StatusFailed
|
|
errStr = sendErr.Error()
|
|
}
|
|
|
|
id, err := repo.Record(ctx, notification.RecordParams{
|
|
GuestID: evt.GuestID,
|
|
Channel: msg.Channel,
|
|
Type: msg.Type,
|
|
Status: status,
|
|
ProviderID: providerID,
|
|
Error: errStr,
|
|
})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
logger.Warn("fraud alert dispatched",
|
|
"notification_id", id,
|
|
"guest_id", evt.GuestID,
|
|
"score", evt.Score,
|
|
"risk", evt.Risk,
|
|
"reasons", evt.Reasons,
|
|
"status", status,
|
|
"provider_id", providerID,
|
|
)
|
|
return nil
|
|
}
|
|
|
|
// handleInvitationSend renders the invitation template + sends through
|
|
// the configured sender (Resend in prod, Mailpit in dev), then writes a
|
|
// notification row so the host can audit the delivery history.
|
|
func handleInvitationSend(
|
|
ctx context.Context,
|
|
logger *slog.Logger,
|
|
repo *notification.Repo,
|
|
sender notification.Sender,
|
|
evt natspub.InvitationSend,
|
|
) error {
|
|
if evt.GuestEmail == "" {
|
|
// Nothing to do — host-managed delivery.
|
|
return nil
|
|
}
|
|
|
|
eventDate := ""
|
|
if !evt.EventDate.IsZero() {
|
|
eventDate = evt.EventDate.Format("Mon, 02 Jan 2006 · 15:04")
|
|
}
|
|
|
|
msg := notification.OutboundMessage{
|
|
GuestID: evt.GuestID,
|
|
Channel: notification.ChannelEmail,
|
|
Type: notification.TypeInvitation,
|
|
Subject: "You're invited — " + evt.EventName,
|
|
Metadata: map[string]any{
|
|
"to": evt.GuestEmail,
|
|
"GuestName": evt.GuestName,
|
|
"HostName": evt.HostName,
|
|
"EventName": evt.EventName,
|
|
"Venue": evt.Venue,
|
|
"EventDate": eventDate,
|
|
"Link": evt.Link,
|
|
},
|
|
}
|
|
|
|
providerID, sendErr := sender.Send(ctx, msg)
|
|
status := notification.StatusSent
|
|
errStr := ""
|
|
if sendErr != nil {
|
|
status = notification.StatusFailed
|
|
errStr = sendErr.Error()
|
|
}
|
|
|
|
id, err := repo.Record(ctx, notification.RecordParams{
|
|
GuestID: evt.GuestID,
|
|
Channel: msg.Channel,
|
|
Type: msg.Type,
|
|
Status: status,
|
|
ProviderMessageID: providerID,
|
|
Error: errStr,
|
|
})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
logger.Info("invitation dispatched",
|
|
"notification_id", id,
|
|
"guest_id", evt.GuestID,
|
|
"event_id", evt.EventID,
|
|
"to", evt.GuestEmail,
|
|
"status", status,
|
|
"provider_message_id", providerID,
|
|
)
|
|
if sendErr != nil {
|
|
return sendErr
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func levelFor(env string) slog.Level {
|
|
if env == "development" {
|
|
return slog.LevelDebug
|
|
}
|
|
return slog.LevelInfo
|
|
}
|