Plumcert (PHP / Laravel)

Gas engineer field service & admin platform.

Stack

• PHP 8.3+
• Laravel 13.8
• Filament 4 (admin panel — Livewire/Alpine, no Vue)
• SQLite default (MySQL switchable)
• dompdf — PDF certificates
• Sanctum — API tokens for Field Service Companion mobile app
• Horizon — queue management
• Telescope — debug panel
• Spatie webhook-client + webhook-server

Quick start

composer install
cp .env.example .env
php artisan key:generate
touch database/database.sqlite
php artisan migrate --seed
php artisan storage:link
php artisan serve

Then visit:

• / — public website
• /admin — Filament admin (default: admin@plumcert.local / password)
• /horizon — queue dashboard (admin only)
• /telescope — debug panel (admin only)
• /api/v1/* — mobile API (Sanctum auth)

Switch to MySQL

Edit .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=plumcert
DB_USERNAME=root
DB_PASSWORD=

Architecture

Layer	Tech
Public site	Blade + Tailwind CDN
Admin panel	Filament 4 (Livewire)
Mobile API	Sanctum REST /api/v1/
PDFs	dompdf renders Blade views in resources/views/certificates/
Queues	Horizon (Redis recommended; falls back to database)
Webhooks	Spatie webhook-client (Stripe) + webhook-server (outbound)

Models

companies, users, customers, properties, boilers, jobs, leads, certificates, findings, quotes, invoices, reminders

Certificates (9 PDF types)

CP12 Homeowner, CP12 Landlord, Gas Warning Notice, Installation/Commissioning Checklist, Gas Service Record, Minor Works, Disconnection Notice, Invoice, Quote.

Scheduler

When	Command	Purpose
Daily 08:00	reminders:generate	Creates staggered (30/7/0-day) service + certificate-renewal reminders
Hourly	reminders:process	Dispatches due reminders via each reminder's channel (email/SMS/WhatsApp)
Mondays 07:00	reminders:report	Emails the admin a weekly maintenance summary

Lead times and certificate recurrence intervals are configurable in config/plumcert.php.

Install the cron entry (runs Laravel's scheduler every minute):

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

Verify what's registered with php artisan schedule:list. Run any command manually, e.g. php artisan reminders:generate.

Recurring jobs

Issuing a CP12 / gas service record auto-schedules the next compliance visit (CertificateObserver → RecurringJobScheduler). The interval comes from config/plumcert.php (cert_recurrence) and can be overridden per certificate in the creation wizard ("Recurring follow-up").

Logging & debugging

• Domain events (reminders, recurring jobs, certificate dispatch, SMS/WhatsApp) log to a dedicated daily channel: storage/logs/plumcert.log.
• /telescope — full request/query/job/mail debug panel (admin only).
• /horizon — queue throughput & failed jobs (admin only).

Email & SMS

• Email: set MAIL_MAILER=smtp with Gmail (App Password) — see .env.example.
• SMS/WhatsApp: set SMS_DRIVER=twilio + Twilio creds, or leave as log for dev (messages are written to plumcert.log).

Tests

php artisan test

Covers email-template rendering, SMS sender, OSM address parsing, certificate recurrence, reminder generation, and reminder dispatch.

Tools (public calculators)

/tools — Gas Rate, Pipe Sizing, Heat Loss, Installation Volume (client-side JS).

API endpoints

~60 endpoints under /api/v1/. See routes/api.php.

License

MIT