feat: media duplicate purge, part 2 of 3: the automatic purge scheduler (Go only)

internal/infrastructure/useCases/PurgeScheduler.go

@@ -0,0 +1,35 @@
+package useCases
+
+import (
+	"RenewCMS/internal/domain/purge"
+	"time"
+)
+
+type PurgeRunner interface {
+	Run(fingerprint *string) (purge.RunResult, error)
+}
+
+type PurgeSchedulerUseCase struct {
+	repository purge.Repository
+	runner     PurgeRunner
+}
+
+func NewPurgeSchedulerUseCase(repository purge.Repository, runner PurgeRunner) *PurgeSchedulerUseCase {
+	return &PurgeSchedulerUseCase{repository, runner}
+}
+
+func (u *PurgeSchedulerUseCase) Tick(now time.Time) (purge.RunResult, bool, error) {
+	settings, err := u.repository.Get()
+	if err != nil {
+		return purge.RunResult{}, false, err
+	}
+	next := settings.NextPurgeAt()
+	if next == nil || now.Before(*next) {
+		return purge.RunResult{}, false, nil
+	}
+	result, err := u.runner.Run(nil)
+	if err != nil {
+		return purge.RunResult{}, false, err
+	}
+	return result, true, nil
+}

internal/infrastructure/useCases/RunPurge.go

@@ -10,14 +10,6 @@ import (
 	"time"
 )
 
-type RunPurgeResult struct {
-	GroupsTotal     int
-	GroupsPurged    int
-	Merged          int
-	ArticlesUpdated int
-	FailedGroups    int
-}
-
 type RunPurgeUseCase struct {
 	planner    *purgePlanner
 	merge      *MergeMediaUseCase
@@ -37,30 +29,30 @@ func NewRunPurgeUseCase(imageRepository image.Repository, articleRepository arti
 	}
 }
 
-func (u *RunPurgeUseCase) Run(fingerprint *string) (RunPurgeResult, error) {
+func (u *RunPurgeUseCase) Run(fingerprint *string) (purge.RunResult, error) {
 	if !u.guard.TryLock() {
-		return RunPurgeResult{}, purge.ErrPurgeBusy
+		return purge.RunResult{}, purge.ErrPurgeBusy
 	}
 	defer u.guard.Unlock()
 
 	plan, err := u.planner.plan()
 	if err != nil {
-		return RunPurgeResult{}, err
+		return purge.RunResult{}, err
 	}
 	if fingerprint != nil && *fingerprint != plan.fingerprint {
-		return RunPurgeResult{}, purge.ErrPurgeConflict
+		return purge.RunResult{}, purge.ErrPurgeConflict
 	}
 
 	result := u.mergeGroups(plan)
 	if err := u.recordRun(result); err != nil {
 		u.logger.Printf("purge: could not record the run result: %v", err)
-		return RunPurgeResult{}, err
+		return purge.RunResult{}, err
 	}
 	return result, nil
 }
 
-func (u *RunPurgeUseCase) mergeGroups(plan purgePlan) RunPurgeResult {
-	result := RunPurgeResult{GroupsTotal: len(plan.groups)}
+func (u *RunPurgeUseCase) mergeGroups(plan purgePlan) purge.RunResult {
+	result := purge.RunResult{GroupsTotal: len(plan.groups)}
 	updated := map[uint32]bool{}
 	for _, group := range plan.groups {
 		merged, err := u.merge.Merge(group.kept.ID, slices.Clone(group.mergedIds))
@@ -78,14 +70,6 @@ func (u *RunPurgeUseCase) mergeGroups(plan purgePlan) RunPurgeResult {
 	return result
 }
 
-func (u *RunPurgeUseCase) recordRun(result RunPurgeResult) error {
-	settings, err := u.repository.Get()
-	if err != nil {
-		return err
-	}
-	at := u.now().UTC()
-	settings.LastPurgeAt = &at
-	settings.LastPurgeMerged = result.Merged
-	settings.LastPurgeArticlesUpdated = result.ArticlesUpdated
-	return u.repository.Save(settings)
+func (u *RunPurgeUseCase) recordRun(result purge.RunResult) error {
+	return u.repository.SaveLastRun(u.now().UTC(), result.Merged, result.ArticlesUpdated)
 }