Files
rickyandClaude Opus 5.5 b4c7aaa3ff Invitation codes: a link that gives an account and roles
Ported from the original (InvitationCode), adapted to configurable roles.

- Admin → Invitations: a label, optionally one email address (only it can
  use the link, and it's emailed) and a name, how many uses (or
  unlimited), an expiry (or never), and a role on any aircraft (or none,
  for an account only).
- An aircraft's Access page: whoever manages its people invites to that
  aircraft, with only the roles they can give; they see and revoke its
  invitations.
- /join/<code>: shows what it gives; create an account (when password
  sign-in is on) or sign in, then accept. Existing accounts and SSO users
  accept too. A role someone already has on an aircraft stays.
- Roles are given as the invitation's creator (AircraftAccess), and only
  while they can still manage that aircraft's people. Codes are kept as
  digests and shown once; uses are counted under a lock; account creation
  and accepting are rate-limited; any invalid link gets the same answer.
- Docs: guide (Administration, Access & sharing), README, and why /join
  isn't on the Authentik bypass list. The README's not-yet-ported list
  now names Prometheus metrics, and no longer claims oil analysis import
  as new.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 18:50:58 -05:00

106 lines
3.9 KiB
Ruby

class Aircraft < ApplicationRecord
STATUSES = LabelSet.new("aircraft.statuses", %w[AVAILABLE MX GROUND UNAVAILABLE])
# Small copies of the photo for the pages (the original can be several MB):
# made when it's uploaded; see #picture_for.
has_one_attached :picture do |picture|
picture.variant :thumb, resize_to_fill: [ 192, 192 ], preprocessed: true
picture.variant :card, resize_to_fill: [ 960, 432 ], preprocessed: true
end
has_many :roles, class_name: "AircraftRole", dependent: :destroy
has_many :invitation_grants, class_name: "AccessInvitationRole", dependent: :delete_all
has_many :users, through: :roles
has_many :notes, class_name: "AircraftNote", dependent: :destroy
has_many :events, class_name: "AircraftEvent", dependent: :delete_all
has_many :share_tokens, dependent: :destroy
has_many :components, dependent: :destroy
has_many :squawks, dependent: :destroy
has_many :logbook_entries, dependent: :destroy
has_many :draft_batches, dependent: :destroy
has_many :logbook_imports, dependent: :destroy
has_many :document_collections, dependent: :destroy
has_many :documents, dependent: :destroy
has_many :inspection_records, dependent: :destroy
has_many :ad_compliances, dependent: :destroy
has_many :drs_imports, dependent: :delete_all
has_many :major_records, dependent: :destroy
has_many :flight_logs, dependent: :destroy
has_many :consumable_records, dependent: :destroy
has_many :oil_analyses, dependent: :destroy
has_many :weight_balance_records, dependent: :destroy
has_many :ad_alerts, dependent: :destroy
has_and_belongs_to_many :inspection_types
has_and_belongs_to_many :airworthiness_directives
# Which clock counts as time in service for maintenance (14 CFR 1.1 defines
# it as takeoff to landing; many owners use tach, some Hobbs).
TIME_BASES = LabelSet.new("aircraft.time_bases", %w[tach hobbs])
validates :tail_number, presence: true
validates :time_basis, inclusion: { in: TIME_BASES.keys }
validates :status, inclusion: { in: STATUSES.keys }
validates :icao_type, format: { with: /\A[A-Z0-9]{1,4}\z/, message: :icao_type }, allow_blank: true
normalizes :icao_type, with: ->(t) { t.strip.upcase.presence }
validate :picture_is_image
scope :ordered, -> { order(:tail_number) }
def to_s = tail_number
def status_label = STATUSES[status]
# Time in service used for maintenance: the chosen clock minus its offset
# (as in the original, offsets cover a replaced meter).
def current_hours
hobbs? ? hobbs_time - hobbs_time_offset : tach_time - tach_time_offset
end
def hobbs? = time_basis == "hobbs"
def current_weight_balance = weight_balance_records.recent_first.first
def loading_setup = LoadingSetup.from_aircraft(self)
def time_basis_label = TIME_BASES[time_basis]
def airworthiness
@airworthiness ||= Airworthiness.new(self).call
end
def reload(*)
@airworthiness = nil
super
end
# ADs that apply directly or via any installed component.
def applicable_ads
AirworthinessDirective.applicable_to(self)
end
def applicable_inspection_types
InspectionType.applicable_to(self)
end
def log_event!(category, event_name, user: Current.user, notes: nil)
events.create!(category: category, event_name: event_name, user: user, notes: notes)
end
# A saved photo to show (not one just rejected by validation, which has no
# address yet).
def picture_shown? = picture.attached? && picture.attachment.persisted?
# The photo at a page's size (:thumb or :card), or the original when it
# isn't a kind that can be resized. (One that can't be read is sent as the
# original too: see config/initializers/active_storage_images.rb.)
def picture_for(size)
picture.variable? ? picture.variant(size) : picture
end
private
def picture_is_image
if picture.attached? && (!picture.content_type.to_s.start_with?("image/") || picture.blob.byte_size.zero?)
errors.add(:picture, :not_image)
end
end
end