Files
simple-aircraft-manager-rails/app/models/document.rb
T
rickyandClaude Opus 5.5 68a1719db2 Records integrity: history, nightly backup and check, records package
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>
2026-11-07 13:21:26 -05:00

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