Add comprehensive project documentation and architecture guidelines

Establishes core rules and conventions for the FuelAlert Laravel application: architecture patterns (fat services, thin controllers), database schema with partitioned station_prices table, multi-tier notification system with Vonage and OneSignal, 4-signal scoring engine for fuel price recommendations, Stripe subscription tiers, Livewire classic component structure, and Pest testing standards.

CLAUDE.local.md

@@ -0,0 +1,33 @@
+# Local overrides (gitignored — personal only)
+
+## Local environment
+
+- PhpStorm with SFTP sync to Proxmox LXC (CT 150, 192.168.1.150)
+- MySQL on IONOS VPS: 192.168.x.x (update with actual)
+- Local dev URL: http://fuel-alert.test (Valet) or http://localhost:8000
+
+## Test credentials (local only)
+
+- Stripe test publishable key: pk_test_...
+- Fuel Finder sandbox credentials (if available): see 1Password
+- Vonage test account: see 1Password
+- OneSignal test app: see 1Password
+
+## Deployment
+
+- Production: IONOS VPS behind Traefik (same setup as uovidiu.com portfolio)
+- Deploy: git push → SSH → composer install --no-dev → php artisan migrate --force → php artisan queue:restart
+- Redis: Docker container on IONOS VPS
+
+## Useful local commands
+
+```bash
+# Manually trigger fuel price poll
+php artisan app:poll-fuel-prices
+
+# Run scoring for a specific user
+php artisan app:score-user {user_id}
+
+# Clear scored results cache
+php artisan cache:forget scoring_results
+```