mirror of
https://github.com/rickbarrette/simple-aircraft-manager-rails.git
synced 2026-11-17 23: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>
49 lines
1.8 KiB
Ruby
49 lines
1.8 KiB
Ruby
class Document < ApplicationRecord
|
|
include Versioned
|
|
include UploadValidation
|
|
|
|
TYPES = {
|
|
"LOG" => "Logbook", "ALTER" => "Alteration Record", "REPORT" => "Report",
|
|
"ESTIMATE" => "Estimate", "DISC" => "Discrepancy List", "INVOICE" => "Receipt / Invoice",
|
|
"AIRCRAFT" => "Aircraft Record", "REGISTRATION" => "Registration Certificate",
|
|
"AIRWORTHINESS_CERT" => "Airworthiness Certificate", "INSURANCE" => "Insurance Policy",
|
|
"RADIO" => "Radio Station License", "OTHER" => "Other"
|
|
}.freeze
|
|
# An expired registration means the aircraft may not be flown (14 CFR
|
|
# 91.203(a)(2)); renewal takes a while, so warn earlier.
|
|
GROUNDING_EXPIRY_TYPES = %w[REGISTRATION].freeze
|
|
EXPIRY_WARNING_DAYS = { "REGISTRATION" => 90 }.freeze
|
|
|
|
belongs_to :aircraft
|
|
belongs_to :document_collection, optional: true
|
|
has_many_attached :pages
|
|
has_many :logbook_entries, dependent: :nullify
|
|
|
|
validates :name, presence: true
|
|
validates :doc_type, inclusion: { in: TYPES.keys }
|
|
validates :visibility, inclusion: { in: DocumentCollection::VISIBILITIES.keys }, allow_nil: true
|
|
validates_uploads :pages
|
|
normalizes :visibility, with: ->(v) { v.presence }
|
|
|
|
scope :ordered, -> { order(:name) }
|
|
scope :expiring, -> { where.not(expires_on: nil) }
|
|
|
|
def to_s = name
|
|
def type_label = TYPES[doc_type]
|
|
def expired?(today = Date.current) = expires_on.present? && today > expires_on
|
|
def expiry_warning_days = EXPIRY_WARNING_DAYS.fetch(doc_type, 30)
|
|
|
|
# nil visibility inherits from the collection; uncollected docs default to private.
|
|
def effective_visibility
|
|
visibility || document_collection&.visibility || "private"
|
|
end
|
|
|
|
def visible_to_share?(share)
|
|
case effective_visibility
|
|
when "status" then true
|
|
when "maintenance" then share.maintenance?
|
|
else false
|
|
end
|
|
end
|
|
end
|