feat: add GPS tracking with Traccar integration

- Add GPS module with Traccar client service for device management - Add driver enrollment flow with QR code generation - Add real-time location tracking on driver profiles - Add GPS settings configuration in admin tools - Add Auth0 OpenID Connect setup script for Traccar - Add deployment configs for production server - Update nginx configs for SSL on GPS port 5055 - Add timezone setting support - Various UI improvements and bug fixes Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 18:13:17 +01:00
parent 3814d175ff
commit 5ded039793
91 changed files with 4403 additions and 68 deletions
--- a/QUICK_START_PDF.md
+++ b/QUICK_START_PDF.md
@@ -0,0 +1,142 @@
+# Quick Start: VIP Schedule PDF Export
+
+## How to Export a VIP Schedule as PDF
+
+### Step 1: Navigate to VIP Schedule
+1. Go to the VIP list page
+2. Click on any VIP name
+3. You'll be on the VIP schedule page at `/vips/:id/schedule`
+
+### Step 2: Click Export PDF
+Look for the blue "Export PDF" button in the top-right corner of the VIP header section:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ VIP Schedule Page                                               │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ← Back to VIPs                                                │
+│                                                                 │
+│  ┌──────────────────────────────────────────────────────────┐ │
+│  │ John Doe                    [Email Schedule] [Export PDF]│ │
+│  │ Example Organization                                      │ │
+│  │ OFFICE OF DEVELOPMENT                                    │ │
+│  │                                                           │ │
+│  │ Generation Timestamp Warning Banner (Yellow)             │ │
+│  └──────────────────────────────────────────────────────────┘ │
+│                                                                 │
+│  Schedule & Itinerary                                          │
+│  ┌──────────────────────────────────────────────────────────┐ │
+│  │ Monday, February 3, 2026                                 │ │
+│  │ ┌────────────────────────────────────────────────────┐  │ │
+│  │ │ 9:00 AM - 10:00 AM  [TRANSPORT]  Airport Pickup    │  │ │
+│  │ └────────────────────────────────────────────────────┘  │ │
+│  └──────────────────────────────────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### Step 3: PDF Downloads Automatically
+- File name: `John_Doe_Schedule_2026-02-01.pdf`
+- Opens in your default PDF viewer
+- Ready to print or share
+
+## What's Included in the PDF
+
+### Header Section
+- VIP name (large, blue)
+- Organization
+- Department
+- **Generation timestamp warning** (yellow banner)
+
+### VIP Information
+- Arrival mode
+- Expected arrival time
+- Airport pickup status
+- Venue transport status
+
+### Flight Information (if applicable)
+- Flight numbers
+- Routes (departure → arrival)
+- Scheduled times
+- Flight status
+
+### Schedule
+- Events grouped by day
+- Color-coded by type:
+  - 🔵 Transport (blue)
+  - 🟣 Meeting (purple)
+  - 🟢 Event (green)
+  - 🟠 Meal (orange)
+  - ⚪ Accommodation (gray)
+- Time ranges
+- Locations
+- Driver assignments
+- Vehicle details
+- Status badges
+
+### Footer
+- Contact email: coordinator@vip-board.com
+- Contact phone: (555) 123-4567
+- Page numbers
+
+## Important: Timestamp Warning
+
+Every PDF includes a prominent yellow warning banner that shows:
+
+```
+⚠️ DOCUMENT GENERATED AT:
+Saturday, February 1, 2026, 3:45 PM EST
+
+This is a snapshot. For the latest schedule, visit: https://vip-coordinator.example.com
+```
+
+This ensures recipients know the PDF may be outdated and should check the app for changes.
+
+## Customizing Contact Information
+
+Edit `frontend/.env`:
+
+```env
+VITE_CONTACT_EMAIL=your-coordinator@example.com
+VITE_CONTACT_PHONE=(555) 987-6543
+VITE_ORGANIZATION_NAME=Your Organization Name
+```
+
+Restart the dev server for changes to take effect.
+
+## Tips
+
+- Generate PDFs fresh before meetings
+- Print in color for best visual clarity
+- Use A4 or Letter size paper
+- Share via email or print for VIPs
+- Remind recipients to check app for updates
+
+## Troubleshooting
+
+**Button doesn't work:**
+- Check browser console for errors
+- Ensure VIP has loaded
+- Try refreshing the page
+
+**PDF looks different than expected:**
+- Some PDF viewers render differently
+- Try Adobe Acrobat Reader for best results
+- Colors may vary on screen vs print
+
+**Download doesn't start:**
+- Check browser popup blocker
+- Ensure download permissions are enabled
+- Try a different browser
+
+## Browser Support
+
+Works in all modern browsers:
+- ✅ Chrome 90+
+- ✅ Edge 90+
+- ✅ Firefox 88+
+- ✅ Safari 14+
+
+---
+
+That's it! You now have professional, print-ready VIP schedules with just one click.