mirror of
https://github.com/rickbarrette/simple-aircraft-manager-rails.git
synced 2026-11-17 23:50:36 -05:00
Electronic signatures on logbook entries (AC 120-78B chapter 2)
- Sign an entry: review exactly what's certified, choose a current certificate (eligibility checked: pilot only for preventive maintenance, inspections need their result and time), re-enter the password or sign in again with SSO (prompt=login, within 5 minutes), and confirm the "Certified by" statement (43.9 return to service, 43.11(a)(5) for inspections, preventive maintenance for pilots) - The signature stores signer, certificate, statement, UTC time, how they authenticated, IP/browser, a SHA-256 fingerprint of the entry's content and a readable snapshot; an HMAC seal covers the signature record. Status shows Valid / Superseded / Altered since signing. The signer is emailed - Signed entries (and their sub-components) can't be edited or deleted; a correction entry, once signed, supersedes the original (kept) - Owners invite an outside mechanic by email to sign one entry: one-time, 14-day link; they create or use their own account and certificate and see only that entry - Admins can disable accounts (signed out, can't sign in or sign; past signatures kept); users with signatures can't be deleted - Printouts show the electronic signature and fingerprint; archives carry signatures (marked imported, with their origin) and corrections Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
7caa213e7a
commit
d719f663bc
47 files changed
+1059
-17
No files matched your search
@@ -55,7 +55,7 @@ module AircraftArchive
|
||||
document_images: a.documents.includes(pages_attachments: :blob).flat_map do |d|
|
||||
d.pages.map { |page| { id: id(page), document_id: id(d), notes: "", image: file(page, "health/documents") } }
|
||||
end,
|
||||
logbook_entries: a.logbook_entries.includes(:parts).map { logbook_hash(_1) },
|
||||
logbook_entries: a.logbook_entries.includes(:parts, :signature).map { logbook_hash(_1) },
|
||||
squawks: a.squawks.includes(:reported_by, attachments_attachments: :blob).map { squawk_hash(_1) },
|
||||
inspection_types: inspection_types.map { inspection_type_hash(_1, component_ids) },
|
||||
inspection_records: a.inspection_records.map do |r|
|
||||
@@ -131,6 +131,15 @@ module AircraftArchive
|
||||
picture: file(a.picture, "aircraft_pictures"), icao_type: a.icao_type }
|
||||
end
|
||||
|
||||
# Carried as a record of the signature; the importing system can't re-check
|
||||
# this server's seal, so it marks the signature as imported.
|
||||
def signature_hash(sig)
|
||||
{ signer_name: sig.signer_name, signer_email: sig.signer_email, certificate_kind: sig.certificate_kind,
|
||||
certificate_number: sig.certificate_number, statement: sig.statement, signed_at: sig.signed_at.utc.iso8601(6),
|
||||
content_digest: sig.content_digest, content_snapshot: sig.content_snapshot, auth_method: sig.auth_method,
|
||||
origin: sig.origin.presence || @source }
|
||||
end
|
||||
|
||||
def component_hash(c)
|
||||
{ id: id(c), aircraft_id: id(c.aircraft_id), parent_component_id: id(c.parent_component_id), component_type_id: id(c.component_type_id),
|
||||
manufacturer: c.manufacturer, model: c.model, serial_number: c.serial_number, install_location: c.install_location,
|
||||
@@ -153,7 +162,8 @@ module AircraftArchive
|
||||
.reject { |k, v| k.nil? || v.nil? },
|
||||
component_since_overhaul: { id(e.component_id) => dec(e.component_since_overhaul_at_entry) }
|
||||
.merge(e.parts.to_h { [ id(_1.component_id), dec(_1.since_overhaul_at_entry) ] }).reject { |k, v| k.nil? || v.nil? },
|
||||
related_documents: [] }
|
||||
related_documents: [], supersedes_id: id(e.supersedes_id), superseded_at: e.superseded_at&.iso8601,
|
||||
signature: e.signature && signature_hash(e.signature) }
|
||||
end
|
||||
|
||||
def squawk_hash(s)
|
||||
|
||||
@@ -247,8 +247,11 @@ module AircraftArchive
|
||||
e.parts.build(component_id: @map[:component][r.to_s], hours_at_entry: num(hash_value(data["component_hours"], r)),
|
||||
since_overhaul_at_entry: num(hash_value(data["component_since_overhaul"], r)))
|
||||
end
|
||||
e.superseded_at = time(data["superseded_at"])
|
||||
e.save!(validate: false)
|
||||
@map[:logbook][data["id"].to_s] = e.id
|
||||
(@supersedes ||= []) << [ e.id, data["supersedes_id"].to_s ] if data["supersedes_id"].present?
|
||||
import_signature(e, data["signature"]) if data["signature"].is_a?(Hash)
|
||||
|
||||
tick("logbook_entries")
|
||||
end
|
||||
@@ -383,6 +386,22 @@ module AircraftArchive
|
||||
tick("major_records")
|
||||
end
|
||||
import_weight_balance
|
||||
Array(@supersedes).each do |entry_id, ref|
|
||||
target = @map[:logbook][ref]
|
||||
LogbookEntry.where(id: entry_id).update_all(supersedes_id: target) if target
|
||||
end
|
||||
end
|
||||
|
||||
def import_signature(entry, sig)
|
||||
kind = LogbookEntry::CERTIFICATE_TYPES.key?(sig["certificate_kind"]) ? sig["certificate_kind"] : "OTHER"
|
||||
EntrySignature.new(
|
||||
logbook_entry: entry, signer_name: sig["signer_name"].to_s.presence || "Unknown", signer_email: sig["signer_email"],
|
||||
certificate_kind: kind, certificate_number: sig["certificate_number"].to_s.presence || "unknown",
|
||||
statement: sig["statement"].to_s.presence || "—", signed_at: time(sig["signed_at"]) || Time.current,
|
||||
content_digest: sig["content_digest"].to_s.presence || "unknown", content_snapshot: sig["content_snapshot"].to_s.presence || "{}",
|
||||
auth_method: EntrySignature::AUTH_METHODS.key?(sig["auth_method"]) ? sig["auth_method"] : "imported",
|
||||
origin: sig["origin"].to_s.presence || "another system"
|
||||
).save!(validate: false)
|
||||
end
|
||||
|
||||
def import_weight_balance
|
||||
|
||||
Reference in new issue
Block a user