AAdvantage Miles
Description
An easy, automated way to reward pilots, create incentives, promote destinations, unlock special flights (or Rank-Free flights), and even reward real-world items (gift cards, sponsors’ perks, etc.)?
AAdvantage Miles is a lightweight, production-tested module that adds miles/points to your VA with automatic earning rules, leaderboards, and an optional in-VA Shop with “special” Flight Passes for sale.
Why it’s good for your VA (and keeps pilots hooked):
- Fly → Earn → Unlock: clear progression loop that turns every flight into visible progress.
- Zero micromanagement: automated awards align with your rules (time flown, landing quality, airports), so good behavior is reinforced without admin work.
- Daily habit builder: login miles, create streaks, and reasons to come back, even on non-flying days.
- Friendly competition: leaderboards spark rivalry and social proof, boosting activity across the week.
- Real rewards, not fluff: the Shop converts effort into perks (simulated or not); Flight Passes add scarcity and excitement (including Ranks-Free access when you want it).
- Event-ready: drop special routes/passes for weekends or special rewards to spike engagement on demand.
- Trust & transparency: per-pilot ledger shows exactly how miles were earned/spent.
Result: more flights, better flying, happier pilots - on autopilot.
What it does
- Per-pilot miles ledger
- Full earn/spend history
Auto-awards
- Daily login miles (idempotent)
- PIREP rules: miles/minute, smooth-landing bonus, bad-landing penalty, score bonus (with cap)
- Airport-specific bonuses (per rule: departure/arrival / both)
Frontend pages
- My Miles, Leaderboard, Shop, My Purchases
Admin tools
- Settings (toggle/tune all rules)
- Manage Pilot Miles (search, review history, add/subtract with note)
- Shop Admin (categories/products, stock, per-user limits, purchase ledger)
- Flight Passes (optional)
- Create Pass products targeting a specific flight (Flight ID)
- Optional aircraft pre-bind for SimBrief / aircraft lock
- Direct-bid endpoint for pass owners
- Auto-marks Pass “used” when the related PIREP is filed
- Default expiry: 30 days
- New: Bid strictness options
- Off → Pass bids bypass rank/type checks (only the core “at departure airport” rule applies). Ideal for “selling” access to flights to lower ranks
- On → Pass bids must satisfy your VA’s current rank/type restrictions (module validates pilot eligibility and subfleet/flight compatibility)
Compatibility
- phpVMS v7 (Laravel 8+)
- DB: JSON columns required (MySQL 5.7+ / MariaDB 10.2+)
- Views namespaced as AAMiles:: and override-friendly
Quick install
- Copy folder to: modules/AAdvantageMiles
- Admin → Addons → Modules → Enable
- PHPVMS Update → visit your.domain/update (runs migrations)
- Admin → Maintenance → Clear All Caches
- Configure under Admin → AAdvantage Miles
That’s it — pilots start earning based on your settings.
Submitter
William
Submitted
08/29/25
Category