Scheduled Commands

PNLCS automates recurring work through Laravel's scheduler. One cron line drives all of it:

* * * * * cd /path/to/pnlcs && php artisan schedule:run >> /dev/null 2>&1

On the official Docker image this runs inside the container automatically.

What the scheduler runs

Command	Schedule	What it does
pnlcs:generate-invoices	Daily 06:00	Create renewal invoices for upcoming due dates
pnlcs:mark-overdue	Daily 06:30	Flag unpaid invoices past due as overdue
pnlcs:auto-suspend	Daily 07:00	Suspend services with long-unpaid invoices
pnlcs:apply-late-fees	Daily 07:30	Add late fees to overdue invoices
pnlcs:payment-reminders	Daily 08:00	Email upcoming/overdue payment reminders
pnlcs:process-cancellations	Daily 02:00	Action scheduled cancellations
pnlcs:domain-sync	Daily 03:00	Sync domain statuses with registrars
pnlcs:unsuspend-on-payment	Every 30 min	Unsuspend services whose invoice was just paid
pnlcs:module-queue	Every 5 min	Retry failed provisioning jobs (backoff)
pnlcs:mail-import	Every 5 min	Import support mailboxes into tickets
pnlcs:currency-update	Daily 05:30	Refresh exchange rates
pnlcs:db-backup	Daily 04:30	Gzip database backup with rotation
pnlcs:prune-logs	Daily 03:45	Trim old log/history rows
pnlcs:ssl-status-poll	Every 5 min	Poll SSL order status
pnlcs:ssl-expiry-check	Daily 09:00	Warn about expiring certificates
pnlcs:ticket-escalation	Every 15 min	Escalate tickets per your rules
pnlcs:usage-polling	Hourly	Pull disk/bandwidth usage for overage billing

Running a command manually

You can run any of these by hand from the project directory, e.g.:

php artisan pnlcs:db-backup
php artisan pnlcs:currency-update --force
php artisan pnlcs:prune-logs --dry-run

The queue worker

Emails and background jobs run through a queue. Keep a worker running (via supervisor) so they process promptly:

[program:pnlcs-worker]
command=php /path/to/pnlcs/artisan queue:work database --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
user=www-data

Relevant settings

Setting	Effect
db_backup_enabled / db_backup_retention	Toggle backups, how many to keep
currency_auto_update	Toggle exchange-rate updates
retention_*_days	How long each log/history table is kept