feat: add ddev-cron configuration and Dockerfile, implement scheduled tasks for queued jobs and heartbeat

Author: Devsome

.ddev/addon-metadata/ddev-cron/manifest.yaml

@@ -0,0 +1,10 @@
+name: ddev-cron
+repository: ddev/ddev-cron
+version: 1.9.0
+install_date: "2026-06-16T22:17:06+02:00"
+project_files:
+    - web-build/Dockerfile.ddev-cron
+    - web-build/cron.conf
+    - web-build/time.cron.example
+global_files: []
+removal_actions: []

.ddev/web-build/Dockerfile.ddev-cron

@@ -0,0 +1,18 @@
+#ddev-generated
+# Install cron package; this can be done in webimage_extra_packages, but put it here for now.
+RUN (apt-get update || true) && DEBIAN_FRONTEND=noninteractive apt-get install -y -o Dpkg::Options::="--force-confold" --no-install-recommends --no-install-suggests cron
+
+# Copy our custom config
+COPY ./cron.conf /etc/supervisor/conf.d/cron.conf
+
+# Make it so you can add to cron.d without root privileges
+RUN chmod 777 /etc/cron.d /var/run
+
+# Copy over our custom jobs
+COPY ./*.cron /etc/cron.d/
+
+# Give execution rights on the cron jobs
+RUN chmod -f 0644 /etc/cron.d/*.cron || true
+
+# Concatenate files
+RUN { cat /etc/cron.d/*.cron; } | crontab -u ${username} -

.ddev/web-build/cron.conf

@@ -0,0 +1,8 @@
+#ddev-generated
+[program:cron]
+command=sudo /usr/sbin/cron -f -L7
+autorestart=true
+startretries=10
+stdout_logfile=/proc/self/fd/2
+stdout_logfile_maxbytes=0
+redirect_stderr=true

.ddev/web-build/local.cron

@@ -0,0 +1,2 @@
+# ddev exec service cron reload
+* * * * * cd /var/www/html && php artisan schedule:run >> /dev/null 2>&1

app/Providers/AppServiceProvider.php

@@ -11,17 +11,11 @@
 
 class AppServiceProvider extends ServiceProvider
 {
-    /**
-     * Register any application services.
-     */
     public function register(): void
     {
         //
     }
 
-    /**
-     * Bootstrap any application services.
-     */
     public function boot(): void
     {
         if (app()->environment('production')) {
@@ -43,11 +37,6 @@ public function boot(): void
         $this->registerBladeDirectives();
     }
 
-    /**
-     * Register custom Blade directives for settings.
-     *
-     * @return void
-     */
     private function registerBladeDirectives(): void
     {
         Blade::directive('settings', function (string $expression): string {

app/Providers/Filament/AdminPanelProvider.php

@@ -91,6 +91,11 @@ public function panel(Panel $panel): Panel
             $panel->plugin($votingPluginClass::make());
         }
 
+        $discordPluginClass = 'SilkPanel\\Discord\\DiscordPlugin';
+        if (class_exists($discordPluginClass)) {
+            $panel->plugin($discordPluginClass::make());
+        }
+
         return $panel;
     }
 }

composer.lock

@@ -4,3 +4,11 @@
 use Illuminate\Support\Facades\Schedule;
 
 Schedule::command(ProcessReferrals::class)->hourly();
+
+// Processes queued jobs (e.g. Discord webhooks) every minute and exits when the queue is empty.
+// This is an alternative to running a persistent queue:work daemon.
+// Requires the scheduler itself to be triggered via cron: * * * * * php artisan schedule:run
+Schedule::command('queue:work --stop-when-empty')->everyMinute()->withoutOverlapping();
+
+// Writes a heartbeat timestamp to cache so the admin panel can detect whether the scheduler is running.
+Schedule::call(fn() => cache()->put('silkpanel_scheduler_last_run', now()->toIso8601String(), now()->addMinutes(10)))->everyMinute()->name('scheduler-heartbeat');