feat(schedules): 每台服务器可设计划任务，按星期和时区定时发命令、重启、停服、开服或备份，重启和备份前可在游戏内提醒

cmd/felis/api.go

@@ -370,6 +370,7 @@ func cmdAPI(args []string, stdout, stderr io.Writer) int {
 		InternalBaseURL: internalAPIBaseURL(),
 		Submissions:     submissions,
 		Mailer:          mailer,
+		Schedules:       repo,
 		// The external face authenticates the local session cookie the sign-in doors
 		// mint, live once `felis breakGlass` flips local_auth_enabled on. Cloudflare
 		// Access, when the install sits behind it, is enforced at the edge only.
@@ -464,6 +465,7 @@ func cmdAPI(args []string, stdout, stderr io.Writer) int {
 	// reconciles it, but this loop converges builds nobody is polling.
 	go reconcileBuilds(ctx, builder, stderr)
 	go settleRestoreChains(ctx, a, stderr)
+	go runSchedules(ctx, a, stderr)
 	// A daily restore point of every world played since its last one, taken
 	// once the server stops ([archive] scheduled_every; 0s turns it off).
 	if backuper != nil && rcfg.ScheduledEvery > 0 {
@@ -734,6 +736,24 @@ func settleRestoreChains(ctx context.Context, a *api.API, stderr io.Writer) {
 	}
 }
 
+// runSchedules runs the servers' scheduled tasks (api.API.RunSchedules). The
+// interval is how late a task may start, and how often a restart or backup in
+// progress checks whether it can take its next step.
+func runSchedules(ctx context.Context, a *api.API, stderr io.Writer) {
+	t := time.NewTicker(15 * time.Second)
+	defer t.Stop()
+	for {
+		select {
+		case <-ctx.Done():
+			return
+		case <-t.C:
+			if err := a.RunSchedules(ctx); err != nil {
+				fmt.Fprintf(stderr, "felis api: scheduled tasks: %v\n", err)
+			}
+		}
+	}
+}
+
 // scheduleBackups starts the scheduled backups (api.BackupScheduler). Each tick
 // starts at most one, so the interval also spaces the worlds that stopped at
 // the same time: a world that stops waits at most this long for its point to