Tours
Backoffice path: Backoffice > Tours (/backoffice/tours)
Available to roles: System Administrator, Administrator
Overview
Tours are predefined multi-leg routes that pilots can enroll in, fly sequentially, and complete to earn a badge award and bonus points. Each tour defines a series of legs with specific departure and arrival airports, and optionally restricts which aircraft types may be used.
Tours support flexible configuration including repeatable completion, license restriction bypass, and aircraft repositioning options (fly-to-origin or point-based teleport).
Tour Configuration
Tour Fields
| Field | Description |
|---|---|
| Title | The tour name displayed to pilots. |
| Description | A detailed description of the tour and its route. |
| Badge Image | An optional badge image awarded to pilots upon completion. |
| Status | Draft (not visible to pilots), Published (available for enrollment), or Archived (no longer available). |
| Repeatable | When enabled, pilots can re-enroll and complete the tour multiple times. |
| Bypass License Restrictions | When enabled, all fleet-assigned aircraft are eligible regardless of the pilot's license. |
| Allow Fly to Origin | Permits pilots to reposition their aircraft to the leg departure airport by flying it there. |
| Allow Pay to Move | Permits pilots to spend points to teleport their aircraft to the leg departure airport. |
| Points Award | Bonus points awarded to the pilot upon completing all legs. Set to 0 for no bonus. |
Tour Legs
Each tour has one or more legs that must be flown in sequence. A leg defines:
| Field | Description |
|---|---|
| Sequence | The order of this leg within the tour (1, 2, 3, ...). |
| Airline | The airline associated with the flight number. |
| Flight Number | The numeric flight number for this leg. Combined with the airline IATA code to form the full flight number (e.g., "AB1234"). |
| Departure Airport | The airport where this leg begins. |
| Arrival Airport | The airport where this leg ends. |
Fleet Assignments
Each tour can be restricted to specific aircraft types by assigning fleets or subfleets. Only aircraft belonging to the assigned fleets or subfleets will be eligible for booking tour legs. If no fleet assignments are configured, pilots will not be able to find eligible aircraft.
| Field | Description |
|---|---|
| Fleet Type | Either Fleet (entire aircraft fleet) or Subfleet (specific aircraft subfleet). |
| Fleet/Subfleet | The specific fleet or subfleet to allow. |
Pilot Enrollment and Progress
Enrolling
When a pilot enrolls in a published tour, the system creates a progress record with status In Progress and generates a progress entry for each tour leg with status Pending. The pilot starts at leg sequence 1.
If the pilot is already enrolled and in progress, the existing enrollment is returned rather than creating a duplicate.
For non-repeatable tours, a pilot who has already completed the tour cannot enroll again.
Booking and Flying Legs
Pilots fly legs in strict sequence. For each leg, the pilot must:
- Book the leg using an eligible aircraft
- Fly the booked leg in a simulator
- The system automatically detects the completed flight and advances to the next leg
The system matches completed flights to tour legs by checking the booking ID or, as a fallback, by matching the departure and arrival airports.
Completing a Tour
When the final leg is completed, the tour progress is automatically set to Completed. The system then:
- Creates a Tour Award record for the pilot
- Awards bonus points (if configured with a non-zero points award)
Abandoning a Tour
Pilots can abandon an in-progress tour at any time. Abandoning:
- Cancels all active bookings linked to booked progress legs
- Sets the progress status to Abandoned
Aircraft Teleportation
When the Allow Pay to Move option is enabled, pilots can spend points to teleport their aircraft to the departure airport of the next tour leg. The cost is calculated as:
Cost = ceil(distance in NM x cost per NM)
The cost-per-NM rate is configured via the system setting Tour Teleport Cost per NM (default: 0.2 points per nautical mile). The pilot must have sufficient points for the teleport to proceed.
Tour Statuses
| Status | Description |
|---|---|
| Draft | Tour is being configured and is not visible to pilots. |
| Published | Tour is available for pilot enrollment. |
| Archived | Tour is no longer available for new enrollments. |
Progress Statuses
| Status | Description |
|---|---|
| In Progress | Pilot is actively enrolled and flying the tour. |
| Completed | Pilot has completed all legs and received the award. |
| Abandoned | Pilot has abandoned the tour. |
Leg Statuses
| Status | Description |
|---|---|
| Pending | Leg has not been booked yet. |
| Booked | Leg has been booked and is awaiting completion. |
| Completed | Leg has been flown and completed. |