Files
simple-aircraft-manager-rails/app/services/hours_service.rb
T
rickyandClaude Opus 5.5 a4b72cf2c1 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>
2026-11-07 10:04:46 -05:00

80 lines
3.1 KiB
Ruby

# Flight-activity writes: absolute hours updates and flight logs. Both cascade
# the time-in-service delta (tach or Hobbs, per the aircraft's maintenance
# clock) to every IN-USE component.
class HoursService
def initialize(aircraft, user: Current.user)
@aircraft = aircraft
@user = user
end
def enforce_airworthiness!
return unless @aircraft.airworthiness_enforcement?
status = Airworthiness.new(@aircraft).call
raise AircraftGroundedError, status if status.red?
end
# Set absolute tach (and optional hobbs); component hours are clamped at 0
# so downward corrections can't go negative.
def update_hours!(tach_time:, hobbs_time: nil)
enforce_airworthiness!
tach = BigDecimal(tach_time.to_s)
hobbs = BigDecimal(hobbs_time.to_s) if hobbs_time.present?
old = @aircraft.tach_time
tach_delta = tach - old
# On Hobbs time, components follow the Hobbs change (when one is given).
delta = @aircraft.hobbs? && hobbs ? hobbs - @aircraft.hobbs_time : tach_delta
Aircraft.transaction do
@aircraft.tach_time = tach
@aircraft.hobbs_time = hobbs if hobbs
@aircraft.save!
cascade_to_components(delta, clamp: true)
@aircraft.log_event!("hours",
"Hours #{tach_delta >= 0 ? 'updated' : 'corrected'} to #{tach}",
user: @user, notes: "Previous: #{old}, delta: #{tach_delta >= 0 ? '+' : ''}#{tach_delta}")
end
tach_delta
end
# Persist a flight log and apply its side effects atomically.
def log_flight!(flight)
enforce_airworthiness!
Aircraft.transaction do
flight.aircraft = @aircraft
flight.user ||= @user
flight.save!
@aircraft.tach_time += flight.tach_time
@aircraft.hobbs_time += flight.hobbs_time if flight.hobbs_time
@aircraft.save!
cascade_to_components(@aircraft.hobbs? && flight.hobbs_time ? flight.hobbs_time : flight.tach_time)
{ "oil" => [ flight.oil_added, flight.oil_level_after, flight.oil_added_type ],
"fuel" => [ flight.fuel_added, flight.fuel_level_after, flight.fuel_added_type ] }.each do |type, (qty, level, kind)|
next unless qty.to_f > 0
@aircraft.consumable_records.create!(
record_type: type, flight_log: flight, date: flight.date, quantity_added: qty,
level_after: level, consumable_type: kind, flight_hours: @aircraft.tach_time,
notes: "Auto-created from flight log")
@aircraft.log_event!(type, "#{type.capitalize} added: #{qty} #{ConsumableRecord::UNITS[type]}",
user: @user, notes: "From flight log")
end
route = flight.route_summary.presence
@aircraft.log_event!("flight", "Flight logged: #{flight.tach_time} hrs#{" (#{route})" if route}", user: @user)
end
flight
end
private
def cascade_to_components(delta, clamp: false)
@aircraft.components.in_use.find_each do |c|
his = c.hours_in_service + delta
hso = c.hours_since_overhaul + delta
his, hso = [ his, 0 ].max, [ hso, 0 ].max if clamp
c.update_columns(hours_in_service: his, hours_since_overhaul: hso, updated_at: Time.current)
end
end
end