feat: add configurable scheduler interval and improve related documentation

Author: costa-alex

README.md

@@ -102,7 +102,7 @@ The **Automation** page allows you to create recurring calendar synchronization
 Current scheduler behavior:
 
 - scheduled jobs process the **current day**;
-- all schedules run every **60 minutes**;
+- all schedules use the global scheduler interval, which defaults to **1 hour**;
 - schedules are persisted in SQLite and survive container restarts;
 - duplicate schedule definitions are rejected;
 - each schedule can be executed immediately with **Run now**;
@@ -224,12 +224,18 @@ services:
     environment:
       # Replace with your local IANA timezone.
       JAVA_TOOL_OPTIONS: "-Duser.timezone=Europe/Lisbon"
+      # Global interval for all scheduled syncs. Accepted values: 1-24 hours.
+      SCHEDULER_INTERVAL_HOURS: "${SCHEDULER_INTERVAL_HOURS:-1}"
     ports:
       - "8098:8080"
     volumes:
       - ./data:/data
 ```
 
+`SCHEDULER_INTERVAL_HOURS` is read when the application starts. It accepts whole
+hours from `1` to `24`, applies to every scheduled sync in the instance, and
+defaults to `1`. Recreate the container after changing it.
+
 Start the application:
 
 ```bash
@@ -296,6 +302,7 @@ docker run --rm \
   --name tp2intervals \
   -p 8098:8080 \
   -e JAVA_TOOL_OPTIONS="-Duser.timezone=Europe/Lisbon" \
+  -e SCHEDULER_INTERVAL_HOURS=1 \
   -v "$(pwd)/data:/data" \
   tp2intervals:local
 ```
@@ -323,6 +330,7 @@ cd boot
 
 SPRING_DATASOURCE_URL="jdbc:sqlite:../data/tp2intervals.sqlite" \
 LOGGING_FILE_NAME="../data/tp2intervals.log" \
+SCHEDULER_INTERVAL_HOURS=1 \
 ./gradlew bootRun
 ```
 
@@ -424,8 +432,8 @@ The TrainingPeaks and TrainerRoad integrations depend on web endpoints and sessi
 - TrainerRoad is supported as a source, not as a synchronization destination.
 - Changed-workout replacement is currently limited to one-day TrainerRoad → TrainingPeaks operations.
 - Changed-workout detection is primarily based on the TrainerRoad workout identifier. A content change that keeps the same identifier may be treated as already synchronized.
-- Scheduled jobs always process the current day and currently run at a fixed 60-minute interval.
-- The scheduler interval cannot yet be configured per schedule.
+- Scheduled jobs always process the current day.
+- The scheduler interval is global for the application instance and cannot be configured per schedule.
 - Synchronization history currently covers calendar-to-calendar operations only.
 - TrainingPeaks capabilities can differ between athlete, coach, free, and Premium accounts.
 

boot/build.gradle.kts

@@ -33,6 +33,7 @@ dependencies {
     implementation("org.springframework.boot:spring-boot-starter-web")
     implementation("org.springframework.boot:spring-boot-starter-data-jpa")
     implementation("org.springframework.boot:spring-boot-starter-actuator")
+    implementation("org.springframework.boot:spring-boot-starter-validation")
 
     implementation("org.hibernate.orm:hibernate-community-dialects:6.4.2.Final")
     implementation("org.xerial:sqlite-jdbc:3.45.0.0")

boot/src/main/kotlin/org/freekode/tp2intervals/Application.kt

@@ -1,6 +1,7 @@
 package org.freekode.tp2intervals
 
 import org.freekode.tp2intervals.infrastructure.configuration.DefaultConfiguration
+import org.freekode.tp2intervals.infrastructure.configuration.SchedulerProperties
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.context.properties.EnableConfigurationProperties
 import org.springframework.boot.runApplication
@@ -12,7 +13,10 @@ import org.springframework.scheduling.annotation.EnableScheduling
 @EnableFeignClients
 @EnableCaching
 @EnableScheduling
-@EnableConfigurationProperties(DefaultConfiguration::class)
+@EnableConfigurationProperties(
+    DefaultConfiguration::class,
+    SchedulerProperties::class,
+)
 class Application
 
 fun main(args: Array<String>) {

boot/src/main/kotlin/org/freekode/tp2intervals/app/workout/schedule/WorkoutScheduledJob.kt

@@ -73,8 +73,8 @@ class WorkoutScheduledJob(
     }
 
     @Scheduled(
-        fixedRate = 60,
-        timeUnit = TimeUnit.MINUTES
+        fixedRateString = "\${app.scheduler.interval-hours}",
+        timeUnit = TimeUnit.HOURS
     )
     fun job() {
         val requests = scheduleRequestRepository
@@ -113,4 +113,4 @@ class WorkoutScheduledJob(
             C2CTodayScheduledRequest::class.java
         )
     }
-}
+}

boot/src/main/kotlin/org/freekode/tp2intervals/infrastructure/configuration/SchedulerProperties.kt

@@ -0,0 +1,14 @@
+package org.freekode.tp2intervals.infrastructure.configuration
+
+import jakarta.validation.constraints.Max
+import jakarta.validation.constraints.Min
+import org.springframework.boot.context.properties.ConfigurationProperties
+import org.springframework.validation.annotation.Validated
+
+@Validated
+@ConfigurationProperties("app.scheduler")
+data class SchedulerProperties(
+    @field:Min(1)
+    @field:Max(24)
+    val intervalHours: Long,
+)

boot/src/main/resources/application.yaml

@@ -1,4 +1,6 @@
 app:
+  scheduler:
+    interval-hours: ${SCHEDULER_INTERVAL_HOURS:1}
   training-peaks:
     api-url: https://tpapi.trainingpeaks.com
   intervals:

docker-compose.yml

@@ -6,7 +6,8 @@ services:
     restart: unless-stopped
     environment:
       JAVA_TOOL_OPTIONS: "-Duser.timezone=Europe/Lisbon"
+      SCHEDULER_INTERVAL_HOURS: "${SCHEDULER_INTERVAL_HOURS:-1}"
     ports:
       - "8098:8080"
     volumes:
-      - ./data:/data
+      - ./data:/data

ui/src/app/automation/automation.component.html

@@ -5,7 +5,7 @@ <h1>Automation</h1>
 
     <p>
       Configure recurring workout synchronizations. Scheduled syncs
-      currently run every 60 minutes for the current day.
+      run at the configured interval for the current day.
     </p>
   </section>
 
@@ -104,7 +104,7 @@ <h2>Scheduled syncs</h2>
             </mat-card-title>
 
             <mat-card-subtitle>
-              Every 60 minutes · Current day
+              Configured interval · Current day
             </mat-card-subtitle>
           </mat-card-header>
 
@@ -265,4 +265,4 @@ <h2>Sync history</h2>
     </div>
   </section>
 
-</div>
+</div>

ui/src/infrastructure/notification.service.ts

@@ -162,7 +162,7 @@ export class NotificationService {
   }
 
   scheduledSyncCreated(): void {
-    this.success('Scheduled sync created. It will run every 60 minutes for today.');
+    this.success('Scheduled sync created. It will run at the configured interval for today.');
   }
 
   scheduledSyncDeleted(): void {