Part 91 inspection rules: limitations, annual as 100-hour, overrun, clock

- Inspection types say what overdue means: grounds the aircraft, no IFR
  (91.411), no transponder (91.413) or advisory. Overdue limitations show
  as a new LIMITED status ("VFR only", "No transponder") and don't block
  flights under airworthiness enforcement
- "Also counts as": an annual satisfies the 100-hour (91.409(b))
- Overrun allowance: a 100-hour done within 10 hrs of due counts the next
  one from when it was due; done early, from when it was done
- Per-aircraft maintenance clock (tach or Hobbs) for time in service; new
  records default to it (fixes the tach-offset mismatch)
- Status labels Current / Due soon / limitation / Grounded, with the
  91.7 pilot-in-command note
- Migration converts existing types by name; archives carry the new fields

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rickyandClaude Opus 5.5 committed 2026-11-07 10:04:46 -05:00
1 parent ef7cd2efba
commit a4b72cf2c1
28 files changed
+371 -63

No files matched your search

+2 -2
View File
@@ -16,7 +16,7 @@ class AdCompliance < ApplicationRecord
# + interval). Only fills a blank/zero value, so a typed-in reading wins.
def fill_next_due
return if closed? || airworthiness_directive.nil?
base = aircraft_hours_at_compliance || aircraft&.tach_time
base = aircraft_hours_at_compliance || aircraft&.current_hours
due = Compliance.next_due(airworthiness_directive.due_rule, date: date_complied, hours: base)
self.next_due_at_time = due[:hours] if due[:hours]
end
@@ -35,7 +35,7 @@ class AdCompliance < ApplicationRecord
def next_due_is_a_future_reading
due = next_due_at_time.to_d
return if closed? || due <= 0
base = aircraft_hours_at_compliance || aircraft&.tach_time
base = aircraft_hours_at_compliance || aircraft&.current_hours
return unless base && due <= base
errors.add(:next_due_at_time, "must be a tach reading after the compliance hours (#{base}). " \
"For “every 100 hours” enter #{base + 100}, not 100")
+11 -2
View File
@@ -28,7 +28,12 @@ class Aircraft < ApplicationRecord
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 = { "tach" => "Tach", "hobbs" => "Hobbs" }.freeze
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: "must be an ICAO type designator like C150" }, allow_blank: true
normalizes :icao_type, with: ->(t) { t.strip.upcase.presence }
@@ -40,11 +45,15 @@ class Aircraft < ApplicationRecord
def status_label = STATUSES[status]
# Hours used for compliance calculations (tach minus offset, as in the original).
# Time in service used for maintenance: the chosen clock minus its offset
# (as in the original, offsets cover a replaced meter).
def current_hours
tach_time - tach_time_offset
hobbs? ? hobbs_time - hobbs_time_offset : tach_time - tach_time_offset
end
def hobbs? = time_basis == "hobbs"
def time_basis_label = TIME_BASES[time_basis]
def airworthiness
@airworthiness ||= Airworthiness.new(self).call
end
+28
View File
@@ -1,9 +1,26 @@
class InspectionType < ApplicationRecord
# What it means for the aircraft when this inspection is overdue.
EFFECTS = {
"grounds" => "Grounds the aircraft",
"no_ifr" => "No IFR flight (e.g. pitot-static, 91.411)",
"no_transponder" => "Transponder can't be used (91.413)",
"advisory" => "Advisory only"
}.freeze
# Short form for the airworthiness status ("VFR only").
LIMITATIONS = { "no_ifr" => "VFR only", "no_transponder" => "No transponder" }.freeze
has_and_belongs_to_many :aircraft
has_and_belongs_to_many :components
has_many :inspection_records, dependent: :destroy
belongs_to :satisfies, class_name: "InspectionType", optional: true
has_many :satisfied_by, class_name: "InspectionType", foreign_key: :satisfies_id, inverse_of: :satisfies, dependent: :nullify
validates :name, presence: true
validates :effect, inclusion: { in: EFFECTS.keys }
validates :hours_tolerance, numericality: { greater_than_or_equal_to: 0, less_than_or_equal_to: 100 }
validate { errors.add(:satisfies, "can't be the inspection itself") if satisfies_id.present? && satisfies_id == id }
# `required` mirrors effect, for archives shared with the original app.
before_validation { self.required = effect != "advisory" }
scope :ordered, -> { order(:name) }
@@ -15,6 +32,17 @@ class InspectionType < ApplicationRecord
end
def to_s = name
def effect_label = EFFECTS[effect]
def limitation = LIMITATIONS[effect]
def advisory? = effect == "advisory"
# Records that count for this inspection on the aircraft: its own, plus
# those of inspections that satisfy it (an annual for the 100-hour).
def records_for(aircraft)
InspectionRecord.for_aircraft(aircraft).where(inspection_type_id: [ id, *satisfied_by.ids ])
end
def latest_record_for(aircraft) = records_for(aircraft).recent_first.first
def due_rule
{ hours: recurring_hours.to_f, months: recurring_months, days: recurring_days } if recurring?