feat(reminders): Phase 4 partial — schema + service + validators

Migration 0072 — reminders/interests expansion:
- interests.reminder_note: optional cadence note for the existing
  reminderEnabled+reminderDays flow. Surfaces in notification body
  + inbox row.
- reminders.yacht_id (+ FK + relation): fourth entity link so
  yacht-scoped tasks have a typed home alongside client/interest/berth.
- reminders.fired_at: worker idempotency. Partial index
  idx_reminders_due_unfired drives the scan.

Service + validator updates:
- createReminderSchema / updateReminderSchema accept yachtId.
- assertReminderFksInPort validates yacht ownership against the
  caller's port — defense-in-depth, same shape as other entity FKs.
- createReminder / updateReminder thread yachtId through.

Worker scheduler + CreateReminderDialog yachtId UI deferred. The
existing reminders/reminder-form.tsx already covers the dialog
contract — Phase 4b extends it with yachtId + the per-user
digest_time_of_day picker.

Tests: 1374/1374 passing. tsc clean.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-18 15:03:12 +02:00
parent 918c23fc0b
commit fb4a09e2ec
6 changed files with 86 additions and 1 deletions

View File

@@ -0,0 +1,46 @@
-- Phase 4 — Reminders expansion (POST-AUDIT-SPEC §2 + MASTER-PLAN §D).
--
-- Adds:
-- 1. interests.reminder_note — cadence note surfaced in notification body + inbox row.
-- 2. reminders.yacht_id — fourth supported entity link (was: client/interest/berth).
-- 3. reminders.fired_at — worker idempotency; set once the firing notification is
-- created so a parallel worker can't double-fire.
-- 4. user_profiles.preferences gains `digest_time_of_day` (JSONB key; no DDL).
--
-- The existing reminders table already carries title/note/dueAt/priority/assignedTo/
-- snoozedUntil/googleCalendarEventId — those columns are reused unchanged. No new
-- table; standalone tasks set client_id/interest_id/berth_id/yacht_id all NULL.
ALTER TABLE interests
ADD COLUMN IF NOT EXISTS reminder_note text;
ALTER TABLE reminders
ADD COLUMN IF NOT EXISTS yacht_id text,
ADD COLUMN IF NOT EXISTS fired_at timestamptz;
-- Yacht FK with the same ON DELETE behaviour as the other entity links.
DO $$
BEGIN
IF NOT EXISTS (
SELECT 1 FROM pg_constraint
WHERE conname = 'reminders_yacht_id_fkey'
) THEN
ALTER TABLE reminders
ADD CONSTRAINT reminders_yacht_id_fkey
FOREIGN KEY (yacht_id) REFERENCES yachts(id) ON DELETE SET NULL;
END IF;
END $$;
-- Index supports the worker scan: "give me every pending reminder whose
-- due_at has passed and we haven't fired yet."
CREATE INDEX IF NOT EXISTS idx_reminders_due_unfired
ON reminders (port_id, due_at)
WHERE fired_at IS NULL AND status IN ('pending', 'snoozed');
-- Comments for downstream readers.
COMMENT ON COLUMN interests.reminder_note IS
'Phase 4: optional cadence note surfaced in reminder notification body + inbox row. NULL = use the default cadence copy.';
COMMENT ON COLUMN reminders.yacht_id IS
'Phase 4: link to a yacht for yacht-scoped reminders. Mirrors client_id/interest_id/berth_id semantics.';
COMMENT ON COLUMN reminders.fired_at IS
'Phase 4: set by the worker once the due-reminder notification has been created. NULL = not yet fired; used as the worker idempotency gate (alongside the partial index above).';