Files
simple-aircraft-manager-rails/docs/guide/flights.md
T
rickyandClaude Opus 5.5 8d5f57da81 Installed app: offline squawks and pre-flight pages, push notifications, shortcuts
Offline
- Flights and squawks saved offline are tagged with their user and only sent
  while that user is signed in; storage is made persistent; Background Sync
  sends them with the app closed (Chromium); unsent count on the app badge
- Report Squawk works offline (photos included, one-time key like flights)
- The Fleet page and, for each of your aircraft, the Overview, W&B, Log
  Flight and Report Squawk pages and photo are saved ahead of time, so the
  app opens and works without signal; copies say when they were saved
- Sign-out clears saved forms, pages and photos (asks first if items wait)
- Offline page rendered by Rails (localized, follows the theme, no inline
  script); service worker version follows the build

Install and notify
- Web Push (web-push gem, VAPID keys from env or storage/vapid_keys.json):
  grounding squawks, newly overdue items (daily, once each), signing
  requests; per-device on/off and test in Profile -> This device; only
  browser push service endpoints accepted
- Manifest shortcuts (Log Flight, Report Squawk via /go/...), lang and
  localized description; install help on Profile; reload notice after a
  release

Also
- Dockerfile: libssl-dev in the build stage (openssl gem); lockfile checksums
- Leftover English and %{_} interpolation names from the localization pass
- Guide and README updated

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 22:39:42 -05:00

2.8 KiB

Flights and hours

Every hour flown is added to the aircraft and to each installed component, which is what moves inspections, ADs, TBOs and replacement times toward due.

Log a flight

Log Flight (top of every aircraft page) records:

  • The date, and tach out / in and Hobbs out / in, or just the durations.
  • Oil and fuel added, the level after and the product. These feed the oil and fuel trends.
  • The route (From/To airports autocomplete) and notes.
  • Optionally a track log (GPX, KML or CSV) and engine monitor data (CGR-30P / CGR-30C .csv), which you can chart on the flight's page.

With no signal

On a phone or tablet with the app installed (see Getting started), you can log a flight without a connection. While you're online, the app saves what it needs on the device for each of your aircraft (up to 10), so without signal you open the app, tap the aircraft and Log Flight as usual: the form opens from the saved copy, and Log Flight saves the flight on the device instead of sending it. The next leg starts where the last one ended. When the connection is back, the app sends the saved flights by itself (on Android, even if the app is closed) and says so at the top of the page. The device asks the browser to keep them safe until then. A flight that's rejected (for example a typo in the tach) stays there with the reason, to log again by hand or discard. Sending twice never logs a flight twice.

Track and engine data files attached offline are kept and sent too.

Update hours

When you don't log each flight, use Update Hours on the overview: enter the current meter readings and the difference is applied to every installed component. A reading lower than the current one is treated as a correction.

If Enforce airworthiness is on, neither works while the aircraft is grounded.

The Flights tab

The Flights tab shows totals and hours by month, then the flight log grouped by day: each day shows the whole route flown (KOQU → KBID → KOQU; a "·" marks where the aircraft moved without a logged leg) and that day's tach and Hobbs time, fuel and oil. Click a day to see its legs, and a leg to open the flight. The most recent 30 days load with the page; earlier ones load as you scroll down (or with Load more). The flight log's More button has:

  • Import from spreadsheet (owners): historical flights from .xlsx or .csv (Date, From, To, Tach, Hobbs, Oil Added, Fuel Added). A preview flags problems such as a tach going backwards and skips rows already imported. It only adds history: component hours don't change unless you choose to advance the meters.
  • Export for AirTrail: a file to import into AirTrail. For automatic syncing, see Your profile.
  • Standardize airport codes: fix codes that don't match a known airport (often a typo), or add a private strip.