PG Pass
Puerto Galera Pass
a digital visitor registration and travel pass system
PG Pass turns tourist intake, QR-based entry verification, payment handling, and government reporting into one operational workflow for Puerto Galera.
01 / Problem
Operational coordination
Puerto Galera depends on tourism, which makes visitor intake more than a form submission problem. The municipality needs to know who is arriving, where travelers are staying, whether they have been verified, whether fees have been handled, and when visitors enter through official points of entry.
PG Pass exists to make that workflow digital and traceable. It gives tourists a straightforward way to register their travel details, gives staff a shared system for reviewing registrations, and gives verifiers a QR-based way to record arrivals at ports or checkpoints.
The core problem it addresses is operational coordination: registration, accommodation review, tourism verification, QR issuance, payment recording, entry scanning, and reporting should not live in disconnected manual processes.
02 / Solution
One system end to end
01
Registration
Tourist registers travel and traveler details. Directus field metadata drives form order, document upload categories, and role-based visibility.
02
QR pass issuance
After verification, travelers receive a QR pass tied to their travel and traveler records. The pass is downloadable as a styled card rendered by a Puppeteer worker.
03
Payment handling
LinkBiz handles online fee payment with request, callback, inquiry, and checksum flows. Staff can also record cash payments for assisted transactions.
04
Entry verification
Verifiers scan QR codes at ports or checkpoints. The scan checks travel association, verified status, confirmed IDs, and valid travel dates — then records the point of entry.
05
Reporting
Async Excel reports cover tourism, gender and development, nationality, and Philippine province breakdowns. The report worker queues jobs, builds artifacts, and updates Directus.
03 / Build
How it was built
Production monorepo
PG Pass is a production-oriented monorepo with separate services for the public app, admin workflows, QR rendering, reporting, and deployment. Each service has its own Dockerfile and health checks, orchestrated by Docker Compose with Traefik.
Frontend
- SvelteKit
- Svelte 5
- TypeScript
- Tailwind CSS v4
Backend
- Directus
- MySQL
- SvelteKit server routes
QR
- qr-code-styling
- html5-qrcode
- Puppeteer renderer
Infra
- Docker Compose
- Traefik
- Health checks
Tourist flow
Directus field metadata drives the form: field order, options, and document upload categories (kid, PWD, student, senior citizen, Oriental Mindoro resident) are all configured in the CMS, not hardcoded.
- 01 Tourist registers travel and traveler details
- 02 Staff reviews and verifies the registration
- 03 QR passes are issued for verified travelers
- 04 Payment via LinkBiz or cash recorded by staff
Staff workflows
Access and actions are scoped by role. Each dashboard shows only what that role needs — no permission sprawl, no shared super-admin accounts.
Roles
- Administrator
- Tourism officer
- Verifier
- EUF verifier
- Hotel officer
Actions
- Review registrations
- Verify documents
- Assign ports
- Scan QR codes
- Record payments
Async reporting
The TypeScript report worker queues jobs, builds Excel artifacts, uploads them, and updates the Directus job record. All report types support async export.
04 / Design
Screens
The full PG Pass interface spans public registration, staff dashboards, QR verification, payment flows, and government reporting.
05 / Value
Government value
A durable operational layer
For the Municipality of Puerto Galera, PG Pass can become a durable operational layer for tourism management. It centralizes visitor registration, creates a cleaner verification trail, and gives staff a shared source of truth for arrivals, accommodations, payment status, and traveler categories.
Decision support
Structured entry scans and registrations let the municipality understand arrival volume by port and date, traveler demographics, domestic province distribution, nationality mix, and fee collection workflows. That supports staffing, planning, tourism policy, sustainability programs, and inter-office coordination.
A reusable civic pattern
PG Pass is reusable as a civic-service pattern — digital intake, document review, QR credentials, payment support, and reporting without requiring each office to maintain separate workflows.
Build a public-service
workflow that works
PG Pass shows how visitor registration, verification, payment handling, and reporting can work together as one practical municipal system. Let's build something similar.
Digital intake, QR credentials, payment support, and reporting — one civic workflow.
PG Pass — Puerto Galera