Replaces one-size-fits-all "2 days before" reminders with intelligent
scheduling based on task frequency. Infrequent tasks (annual) get 30-day
advance notice while frequent tasks (weekly) only get day-of reminders.
Key features:
- Frequency-aware pre-reminders: annual (30d, 14d, 7d), quarterly (7d, 3d),
monthly (3d), bi-weekly (1d), daily/weekly/once (day-of only)
- Overdue tapering: daily for 3 days, then every 3 days, stops after 14 days
- Reminder log table prevents duplicate notifications per due date/stage
- Admin endpoint displays notification schedules for all frequencies
- Comprehensive test suite (100 random tasks, 61 days each, 10 test functions)
New files:
- internal/notifications/reminder_config.go - Editable schedule configuration
- internal/notifications/reminder_schedule.go - Schedule lookup logic
- internal/notifications/reminder_schedule_test.go - Dynamic test suite
- internal/models/reminder_log.go - TaskReminderLog model
- internal/repositories/reminder_repo.go - Reminder log repository
- migrations/010_add_task_reminder_log.{up,down}.sql
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
126 lines
3.7 KiB
Go
126 lines
3.7 KiB
Go
package repositories
|
|
|
|
import (
|
|
"time"
|
|
|
|
"gorm.io/gorm"
|
|
|
|
"github.com/treytartt/casera-api/internal/models"
|
|
)
|
|
|
|
// ReminderRepository handles database operations for task reminder logs
|
|
type ReminderRepository struct {
|
|
db *gorm.DB
|
|
}
|
|
|
|
// NewReminderRepository creates a new reminder repository
|
|
func NewReminderRepository(db *gorm.DB) *ReminderRepository {
|
|
return &ReminderRepository{db: db}
|
|
}
|
|
|
|
// HasSentReminder checks if a reminder has already been sent for the given
|
|
// task, user, due date, and reminder stage.
|
|
func (r *ReminderRepository) HasSentReminder(taskID, userID uint, dueDate time.Time, stage models.ReminderStage) (bool, error) {
|
|
// Normalize to date only
|
|
dueDateOnly := time.Date(dueDate.Year(), dueDate.Month(), dueDate.Day(), 0, 0, 0, 0, time.UTC)
|
|
|
|
var count int64
|
|
err := r.db.Model(&models.TaskReminderLog{}).
|
|
Where("task_id = ? AND user_id = ? AND due_date = ? AND reminder_stage = ?",
|
|
taskID, userID, dueDateOnly, stage).
|
|
Count(&count).Error
|
|
|
|
if err != nil {
|
|
return false, err
|
|
}
|
|
|
|
return count > 0, nil
|
|
}
|
|
|
|
// LogReminder records that a reminder was sent.
|
|
// Returns the created log entry or an error if the reminder was already sent
|
|
// (unique constraint violation).
|
|
func (r *ReminderRepository) LogReminder(taskID, userID uint, dueDate time.Time, stage models.ReminderStage, notificationID *uint) (*models.TaskReminderLog, error) {
|
|
// Normalize to date only
|
|
dueDateOnly := time.Date(dueDate.Year(), dueDate.Month(), dueDate.Day(), 0, 0, 0, 0, time.UTC)
|
|
|
|
log := &models.TaskReminderLog{
|
|
TaskID: taskID,
|
|
UserID: userID,
|
|
DueDate: dueDateOnly,
|
|
ReminderStage: stage,
|
|
SentAt: time.Now().UTC(),
|
|
NotificationID: notificationID,
|
|
}
|
|
|
|
err := r.db.Create(log).Error
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return log, nil
|
|
}
|
|
|
|
// GetSentRemindersForTask returns all reminder logs for a specific task and user.
|
|
func (r *ReminderRepository) GetSentRemindersForTask(taskID, userID uint) ([]models.TaskReminderLog, error) {
|
|
var logs []models.TaskReminderLog
|
|
err := r.db.Where("task_id = ? AND user_id = ?", taskID, userID).
|
|
Order("sent_at DESC").
|
|
Find(&logs).Error
|
|
return logs, err
|
|
}
|
|
|
|
// GetSentRemindersForDueDate returns all reminder logs for a specific task,
|
|
// user, and due date.
|
|
func (r *ReminderRepository) GetSentRemindersForDueDate(taskID, userID uint, dueDate time.Time) ([]models.TaskReminderLog, error) {
|
|
dueDateOnly := time.Date(dueDate.Year(), dueDate.Month(), dueDate.Day(), 0, 0, 0, 0, time.UTC)
|
|
|
|
var logs []models.TaskReminderLog
|
|
err := r.db.Where("task_id = ? AND user_id = ? AND due_date = ?",
|
|
taskID, userID, dueDateOnly).
|
|
Order("sent_at DESC").
|
|
Find(&logs).Error
|
|
return logs, err
|
|
}
|
|
|
|
// CleanupOldLogs removes reminder logs older than the specified number of days.
|
|
// This helps keep the table from growing indefinitely.
|
|
func (r *ReminderRepository) CleanupOldLogs(daysOld int) (int64, error) {
|
|
cutoff := time.Now().UTC().AddDate(0, 0, -daysOld)
|
|
|
|
result := r.db.Where("sent_at < ?", cutoff).
|
|
Delete(&models.TaskReminderLog{})
|
|
|
|
return result.RowsAffected, result.Error
|
|
}
|
|
|
|
// GetRecentReminderStats returns statistics about recent reminders sent.
|
|
// Useful for admin/monitoring purposes.
|
|
func (r *ReminderRepository) GetRecentReminderStats(sinceHours int) (map[string]int64, error) {
|
|
since := time.Now().UTC().Add(-time.Duration(sinceHours) * time.Hour)
|
|
|
|
stats := make(map[string]int64)
|
|
|
|
// Count by stage
|
|
rows, err := r.db.Model(&models.TaskReminderLog{}).
|
|
Select("reminder_stage, COUNT(*) as count").
|
|
Where("sent_at >= ?", since).
|
|
Group("reminder_stage").
|
|
Rows()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
defer rows.Close()
|
|
|
|
for rows.Next() {
|
|
var stage string
|
|
var count int64
|
|
if err := rows.Scan(&stage, &count); err != nil {
|
|
return nil, err
|
|
}
|
|
stats[stage] = count
|
|
}
|
|
|
|
return stats, nil
|
|
}
|