Add guest push notifications and queue alerts

docs/deployment/docker.md

@@ -79,6 +79,16 @@ To enable Horizon (dashboard, smart balancing):
 docker compose --profile horizon up -d horizon
 ```
 
+## 6. Scheduler & cron jobs
+
+The compose stack ships a `scheduler` service that runs `php artisan schedule:work`, so all scheduled commands defined in `App\Console\Kernel` stay active. For upload health monitoring, keep the helper script from `cron/upload_queue_health.sh` on the host (or inside a management container) and add a cron entry:
+
+```
+*/5 * * * * /var/www/html/cron/upload_queue_health.sh
+```
+
+This wrapper logs to `storage/logs/cron-upload-queue-health.log` and executes `php artisan storage:check-upload-queues`, which in turn issues guest-facing upload alerts when queues stall or fail repeatedly. In containerised environments mount the repository so the script can reuse the same PHP binary as the app, or call the artisan command directly via `docker compose exec app php artisan storage:check-upload-queues`.
+
 The dashboard becomes available at `/horizon` and is protected by the Filament super-admin auth guard.
 
 ## 6. Persistent data & volumes