Skip to main content

​
Overview

This feature automatically sends reminder emails to customers 48 hours before their confirmed tattoo appointments.

​
How It Works

​
Scheduled Function

  • Schedule: Daily at 9:00 AM Sydney time
  • Function: scheduled.sendBookingReminders
  • Logic: Checks for CONFIRMED bookings happening in 2 days and sends reminder emails

​
Email Template

  • Template: BookingReminderEmail.tsx
  • Content: Appointment details, preparation tips, booking management link
  • Style: Follows existing email template design

​
Database Updates

  • New Fields: Added to BookingConfirmed type:
    • reminderEmailSent?: boolean
    • reminderEmailSentAt?: number

​
Implementation Details

​
Files Created/Modified

  1. Types:
    • types/models/bookings.ts - Added reminder tracking fields
  2. Email Template:
    • functions/emails/templates/BookingReminderEmail.tsx - New template
  3. Email Function:
    • functions/src/email/sendBookingReminder.ts - Email sending logic
  4. Scheduled Function:
    • functions/src/scheduled/sendBookingReminders.ts - Main scheduled job
  5. Functions Index:
    • functions/src/index.ts - Export new scheduled function

​
Dependencies Added

  • date-fns-tz - For proper timezone handling

​
Deployment

​
Prerequisites

  1. Ensure Mailgun is properly configured
  2. Set FRONTEND_URL environment variable for booking links
  3. Verify Firebase Functions permissions for Pub/Sub

​
Deploy Commands

cd functions
npm run build
firebase deploy --only functions:scheduled.sendBookingReminders

​
Testing

​
Local Testing

cd functions
npm run serve
# Use Firebase emulator to test the function

​
Email Preview

cd functions
npm run email:preview
# Navigate to the BookingReminderEmail template

​
Monitoring

​
Logs

  • Check Cloud Functions logs for execution results
  • Monitor success/failure rates
  • Track email delivery via Mailgun dashboard

​
Alerts

Consider setting up Cloud Monitoring alerts for:
  • Function execution failures
  • High email failure rates
  • Function timeout issues

​
Configuration

​
Timezone

  • All operations use Sydney timezone (Australia/Sydney)
  • Handles DST automatically

​
Reminder Timing

  • Sends reminders exactly 48 hours before appointments
  • Only processes CONFIRMED bookings
  • Prevents duplicate emails with tracking flags

​
Future Enhancements

  • Multiple reminder types (24h, 2h before)
  • User preference for reminder timing
  • SMS reminders
  • Artist notification preferences