AirTrail sync and export, GPS tracks, airport database with autocomplete

AirTrail (https://github.com/johanohly/AirTrail):
- File export (Flights → Export for AirTrail) in AirTrail's import
  format, validated against its schema; same-day repeat legs get leg
  numbers so AirTrail's de-duplication doesn't merge them.
- Automatic sync through AirTrail's REST API (Profile → AirTrail sync):
  per-user connection with an encrypted API key and scope check; flights
  are created/updated/deleted in background jobs; a full sync first
  links flights already in AirTrail (e.g. from a file import) instead of
  duplicating them; airports are resolved and cached, with manual
  mapping for unknown codes.
- GPS tracks: GPX, KML and CSV track logs are converted to AirTrail's
  track format for both sync and export; the flight page shows a summary.
- Aircraft ICAO type (e.g. C150) for AirTrail's aircraft type.

Airport database (OurAirports, the source AirTrail uses):
- Managed like AirTrail: downloaded in the background on first start,
  updated in place from Admin → Airports (adds, changes, removes; ids
  stable), with admin-managed custom airports that updates never touch.
- Each airport carries AirTrail's code, so logged codes translate to
  AirTrail's exactly (1B9 → K1B9, 4MB → K5M3).
- From/To autocomplete on new flights (airports this aircraft has used
  rank first); From is pre-filled with the last flight's destination;
  codes are normalized to uppercase.
- Flights → Standardize airport codes: rewrite logged codes to the
  standard code, and fix codes not in the database (typos such as 0R8 →
  08R are suggested).

Also: admin pages grouped under an Admin dropdown menu.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rickyandClaude Opus 5.5 committed 2026-11-05 19:40:20 -05:00
1 parent 0c4803d717
commit 5bf682502b
68 files changed
+2667 -10

No files matched your search

@@ -0,0 +1,46 @@
class CreateAirTrailSync < ActiveRecord::Migration[8.1]
def change
# ICAO type designator (e.g. C150), used for AirTrail's aircraft type.
add_column :aircraft, :icao_type, :string
# One AirTrail account per user; flights sync to their pilot's account.
create_table :air_trail_connections do |t|
t.references :user, null: false, foreign_key: true, index: { unique: true }
t.string :base_url, null: false
t.text :api_key, null: false # encrypted
t.boolean :enabled, null: false, default: true
t.string :remote_user_id
t.string :remote_username
t.string :status # ok | error
t.text :last_error
t.datetime :checked_at
t.datetime :backfilled_at
t.timestamps
end
# Which AirTrail flight each local flight corresponds to.
create_table :air_trail_syncs do |t|
t.references :air_trail_connection, null: false, foreign_key: true
t.references :flight_log, null: false, foreign_key: true
t.integer :remote_id
t.string :payload_digest
t.string :status, null: false, default: "pending" # pending | synced | error
t.text :last_error
t.datetime :synced_at
t.timestamps
end
add_index :air_trail_syncs, [ :air_trail_connection_id, :flight_log_id ], unique: true, name: "idx_air_trail_syncs_unique"
# Airport code → AirTrail airport id (nil = looked up, not found).
create_table :air_trail_airports do |t|
t.references :air_trail_connection, null: false, foreign_key: true
t.string :code, null: false
t.integer :remote_id
t.string :remote_icao
t.boolean :manual, null: false, default: false
t.datetime :looked_up_at
t.timestamps
end
add_index :air_trail_airports, [ :air_trail_connection_id, :code ], unique: true, name: "idx_air_trail_airports_unique"
end
end
@@ -0,0 +1,32 @@
# Airport reference data (OurAirports, the source AirTrail uses) for
# autocomplete and for translating codes to AirTrail's. The data itself is
# downloaded on first start (AirportUpdateJob), as AirTrail does.
class CreateAirports < ActiveRecord::Migration[8.1]
def up
create_table :airports do |t|
t.string :ident, null: false
t.string :airtrail_code, null: false
t.string :gps_code
t.string :local_code
t.string :iata
t.string :name, null: false
t.string :kind
t.string :municipality
t.string :region
t.string :country
t.float :latitude
t.float :longitude
t.integer :elevation_ft
t.timestamps
end
add_index :airports, :ident, unique: true
add_index :airports, :airtrail_code
add_index :airports, :gps_code
add_index :airports, :local_code
add_index :airports, :iata
end
def down
drop_table :airports
end
end
@@ -0,0 +1,21 @@
class AddCustomAirportsAndUpdates < ActiveRecord::Migration[8.1]
def change
# Airports added by an admin; never touched by OurAirports updates.
add_column :airports, :custom, :boolean, null: false, default: false
add_index :airports, :custom
# History of OurAirports updates (shown on the admin Airports page).
create_table :airport_updates do |t|
t.string :status, null: false, default: "queued" # queued | running | done | failed
t.string :source_url
t.integer :created_count, null: false, default: 0
t.integer :updated_count, null: false, default: 0
t.integer :removed_count, null: false, default: 0
t.text :error
t.references :requested_by, foreign_key: { to_table: :users, on_delete: :nullify }
t.datetime :started_at
t.datetime :finished_at
t.timestamps
end
end
end
Generated
+91 -1
View File
@@ -10,7 +10,7 @@
#
# It's strongly recommended that you check this file into your version control system.
ActiveRecord::Schema[8.1].define(version: 2026_11_06_120000) do
ActiveRecord::Schema[8.1].define(version: 2026_11_06_150000) do
create_table "active_storage_attachments", force: :cascade do |t|
t.string "name", null: false
t.string "record_type", null: false
@@ -60,6 +60,50 @@ ActiveRecord::Schema[8.1].define(version: 2026_11_06_120000) do
t.index ["logbook_entry_id"], name: "index_ad_compliances_on_logbook_entry_id"
end
create_table "air_trail_airports", force: :cascade do |t|
t.integer "air_trail_connection_id", null: false
t.string "code", null: false
t.integer "remote_id"
t.string "remote_icao"
t.boolean "manual", default: false, null: false
t.datetime "looked_up_at"
t.datetime "created_at", null: false
t.datetime "updated_at", null: false
t.index ["air_trail_connection_id", "code"], name: "idx_air_trail_airports_unique", unique: true
t.index ["air_trail_connection_id"], name: "index_air_trail_airports_on_air_trail_connection_id"
end
create_table "air_trail_connections", force: :cascade do |t|
t.integer "user_id", null: false
t.string "base_url", null: false
t.text "api_key", null: false
t.boolean "enabled", default: true, null: false
t.string "remote_user_id"
t.string "remote_username"
t.string "status"
t.text "last_error"
t.datetime "checked_at"
t.datetime "backfilled_at"
t.datetime "created_at", null: false
t.datetime "updated_at", null: false
t.index ["user_id"], name: "index_air_trail_connections_on_user_id", unique: true
end
create_table "air_trail_syncs", force: :cascade do |t|
t.integer "air_trail_connection_id", null: false
t.integer "flight_log_id", null: false
t.integer "remote_id"
t.string "payload_digest"
t.string "status", default: "pending", null: false
t.text "last_error"
t.datetime "synced_at"
t.datetime "created_at", null: false
t.datetime "updated_at", null: false
t.index ["air_trail_connection_id", "flight_log_id"], name: "idx_air_trail_syncs_unique", unique: true
t.index ["air_trail_connection_id"], name: "index_air_trail_syncs_on_air_trail_connection_id"
t.index ["flight_log_id"], name: "index_air_trail_syncs_on_flight_log_id"
end
create_table "aircraft", force: :cascade do |t|
t.string "tail_number", null: false
t.string "make"
@@ -75,6 +119,7 @@ ActiveRecord::Schema[8.1].define(version: 2026_11_06_120000) do
t.boolean "airworthiness_enforcement", default: false, null: false
t.datetime "created_at", null: false
t.datetime "updated_at", null: false
t.string "icao_type"
end
create_table "aircraft_airworthiness_directives", id: false, force: :cascade do |t|
@@ -124,6 +169,46 @@ ActiveRecord::Schema[8.1].define(version: 2026_11_06_120000) do
t.index ["user_id"], name: "index_aircraft_roles_on_user_id"
end
create_table "airport_updates", force: :cascade do |t|
t.string "status", default: "queued", null: false
t.string "source_url"
t.integer "created_count", default: 0, null: false
t.integer "updated_count", default: 0, null: false
t.integer "removed_count", default: 0, null: false
t.text "error"
t.integer "requested_by_id"
t.datetime "started_at"
t.datetime "finished_at"
t.datetime "created_at", null: false
t.datetime "updated_at", null: false
t.index ["requested_by_id"], name: "index_airport_updates_on_requested_by_id"
end
create_table "airports", force: :cascade do |t|
t.string "ident", null: false
t.string "airtrail_code", null: false
t.string "gps_code"
t.string "local_code"
t.string "iata"
t.string "name", null: false
t.string "kind"
t.string "municipality"
t.string "region"
t.string "country"
t.float "latitude"
t.float "longitude"
t.integer "elevation_ft"
t.datetime "created_at", null: false
t.datetime "updated_at", null: false
t.boolean "custom", default: false, null: false
t.index ["airtrail_code"], name: "index_airports_on_airtrail_code"
t.index ["custom"], name: "index_airports_on_custom"
t.index ["gps_code"], name: "index_airports_on_gps_code"
t.index ["iata"], name: "index_airports_on_iata"
t.index ["ident"], name: "index_airports_on_ident", unique: true
t.index ["local_code"], name: "index_airports_on_local_code"
end
create_table "airworthiness_directives", force: :cascade do |t|
t.string "name", null: false
t.string "short_description", null: false
@@ -394,12 +479,17 @@ ActiveRecord::Schema[8.1].define(version: 2026_11_06_120000) do
add_foreign_key "ad_compliances", "components"
add_foreign_key "ad_compliances", "inspection_records", on_delete: :nullify
add_foreign_key "ad_compliances", "logbook_entries", on_delete: :nullify
add_foreign_key "air_trail_airports", "air_trail_connections"
add_foreign_key "air_trail_connections", "users"
add_foreign_key "air_trail_syncs", "air_trail_connections"
add_foreign_key "air_trail_syncs", "flight_logs"
add_foreign_key "aircraft_events", "aircraft"
add_foreign_key "aircraft_events", "users", on_delete: :nullify
add_foreign_key "aircraft_notes", "aircraft"
add_foreign_key "aircraft_notes", "users", on_delete: :nullify
add_foreign_key "aircraft_roles", "aircraft"
add_foreign_key "aircraft_roles", "users"
add_foreign_key "airport_updates", "users", column: "requested_by_id", on_delete: :nullify
add_foreign_key "airworthiness_directives", "documents", on_delete: :nullify
add_foreign_key "components", "aircraft"
add_foreign_key "components", "component_types"