mirror of
https://github.com/rickbarrette/simple-aircraft-manager-rails.git
synced 2026-11-17 15:50:36 -05:00
AC 120-78B chapter 3:
- Every change to logbook entries, sub-components, signatures, inspection
records, AD compliance, major records, W&B, components, squawks and
documents is kept as a RecordVersion (who, IP, when, field changes),
hash-chained per aircraft; versions can't be edited or deleted. Shown on
each logbook entry and in Activity -> Record history
- Nightly job: SQLite online-backup copy to storage/backups, verified
(integrity_check + record counts), pruned to the configured number; then
an integrity check of the history chains and every signature's seal and
fingerprint. Results on Admin -> About ("Back up and check now"); admins
are emailed on failure
- Software versions recorded (first/last seen) on Admin -> About
- Records package (Access & Sharing): logbook entries PDF with signatures,
signatures.csv, record-history.csv, self-contained status report HTML,
the .sam.zip, and a README, for the FAA/NTSB or a buyer
- Legacy (paper) records: documents can be marked as legacy records;
aircraft have an "electronic records since" date (status report, package)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
31 lines
1.3 KiB
Ruby
31 lines
1.3 KiB
Ruby
# One change to a maintenance record (create, update, destroy), kept for
|
|
# good (AC 120-78B 3.2.2). Each aircraft's versions form a hash chain:
|
|
# chain_hash = SHA-256(prev_hash + payload), so deleting, reordering or
|
|
# editing a version breaks the chain and the nightly check reports it.
|
|
class RecordVersion < ApplicationRecord
|
|
belongs_to :user, optional: true
|
|
|
|
scope :chronological, -> { order(:id) }
|
|
|
|
before_update { throw :abort }
|
|
before_destroy { throw :abort }
|
|
|
|
def self.digest(prev_hash, payload) = OpenSSL::Digest::SHA256.hexdigest("#{prev_hash}\n#{payload}")
|
|
|
|
def self.append!(item:, aircraft_id:, event:, changes:)
|
|
now = Time.current
|
|
payload = { "item_type" => item.class.name, "item_id" => item.id, "event" => event, "changes" => changes,
|
|
"user_id" => Current.user&.id, "at" => now.utc.iso8601(6) }.to_json
|
|
prev = where(aircraft_id: aircraft_id).order(:id).last&.chain_hash
|
|
create!(aircraft_id: aircraft_id, item_type: item.class.name, item_id: item.id, event: event, user_id: Current.user&.id,
|
|
ip_address: Current.ip_address, payload: payload, prev_hash: prev, chain_hash: digest(prev, payload), created_at: now)
|
|
end
|
|
|
|
def changes_hash = JSON.parse(payload)["changes"]
|
|
|
|
# Field names changed by this version (for display).
|
|
def changed_fields
|
|
event == "update" ? changes_hash.keys : []
|
|
end
|
|
end
|