mirror of
https://github.com/rickbarrette/simple-aircraft-manager-rails.git
synced 2026-11-17 15: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
|
||||
|
||||
@@ -0,0 +1,41 @@
|
||||
# Signs a logbook entry for a user with one of their certificates
|
||||
# (AC 120-78B 2.1.2 / 2.2): the entry's signer fields are set from the
|
||||
# certificate, then the signature records exactly what was signed. Signing a
|
||||
# correction marks the entry it corrects as superseded (2.2.8).
|
||||
class EntrySigner
|
||||
REAUTH_WINDOW = 5.minutes
|
||||
|
||||
class Error < StandardError; end
|
||||
|
||||
def initialize(entry, user:, certificate:, auth_method:, request: nil)
|
||||
@entry = entry
|
||||
@user = user
|
||||
@certificate = certificate
|
||||
@auth_method = auth_method
|
||||
@request = request
|
||||
end
|
||||
|
||||
def sign!
|
||||
raise Error, "Your account is disabled" if @user.disabled?
|
||||
raise Error, "That certificate isn't yours" unless @certificate && @certificate.user_id == @user.id
|
||||
problems = @entry.signing_problems(@certificate)
|
||||
raise Error, "This entry can't be signed: #{problems.to_sentence}" if problems.any?
|
||||
|
||||
LogbookEntry.transaction do
|
||||
@entry.update!(signoff_person: @user.display_name, signoff_certificate_type: @certificate.kind,
|
||||
signoff_certificate_number: @certificate.number)
|
||||
@entry.reload
|
||||
signature = @entry.create_signature!(
|
||||
user: @user, signer_name: @user.display_name, signer_email: @user.email_address,
|
||||
certificate_kind: @certificate.kind, certificate_number: @certificate.number,
|
||||
statement: @entry.certification_statement(@certificate.kind), signed_at: Time.current,
|
||||
content_digest: @entry.content_digest, content_snapshot: @entry.content_snapshot.to_json,
|
||||
auth_method: @auth_method, ip_address: @request&.remote_ip, user_agent: @request&.user_agent.to_s.first(255)
|
||||
)
|
||||
@entry.supersedes&.update_column(:superseded_at, signature.signed_at)
|
||||
@entry.aircraft.log_event!("logbook", "Logbook entry signed electronically (#{@entry.date})",
|
||||
notes: "#{signature.signer_name}, #{signature.certificate_label} #{signature.certificate_number}", user: @user)
|
||||
signature
|
||||
end
|
||||
end
|
||||
end
|
||||
@@ -195,6 +195,7 @@ class LogbookEntryPdf
|
||||
def signature_block_height(small) = (small + 3) * 3 + 6
|
||||
|
||||
def signature_block(entry, w, height, small, more:)
|
||||
return electronic_signature_block(entry, w, height, small, more: more) if entry.signature
|
||||
@pdf.bounding_box([ 0, height ], width: w, height: height) do
|
||||
if more
|
||||
@pdf.text_box "Continued on the next #{more}.", at: [ 0, height ], width: w, height: small + 2, size: small,
|
||||
@@ -212,6 +213,24 @@ class LogbookEntryPdf
|
||||
end
|
||||
end
|
||||
|
||||
# Signed entries: who certified it, when, and the fingerprint to check it by.
|
||||
def electronic_signature_block(entry, w, height, small, more:)
|
||||
sig = entry.signature
|
||||
@pdf.bounding_box([ 0, height ], width: w, height: height) do
|
||||
top = height
|
||||
if more
|
||||
@pdf.text_box "Continued on the next #{more}.", at: [ 0, top ], width: w, height: small + 2, size: small, style: :italic, overflow: :truncate
|
||||
end
|
||||
top -= small + 3
|
||||
@pdf.text_box clean("#{EntrySignature::LABEL} #{sig.signer_name}, #{sig.certificate_label} #{sig.certificate_number}" \
|
||||
"#{' (SUPERSEDED BY A CORRECTION)' if entry.superseded?}"),
|
||||
at: [ 0, top ], width: w, height: small + 2, size: small, style: :bold, overflow: :shrink_to_fit, min_font_size: 5
|
||||
top -= small + 3
|
||||
@pdf.text_box clean("Signed electronically #{sig.signed_at.utc.strftime('%Y-%m-%d %H:%M UTC')} · fingerprint #{sig.content_digest.first(16)}"),
|
||||
at: [ 0, top ], width: w, height: small + 2, size: small - 1, overflow: :shrink_to_fit, min_font_size: 5
|
||||
end
|
||||
end
|
||||
|
||||
def certificate(entry)
|
||||
kind = { "AP" => "A&P", "IA" => "A&P/IA", "A" => "A", "P" => "P", "REPAIR_STATION" => "Repair station", "REPAIRMAN" => "Repairman",
|
||||
"PILOT" => "Pilot", "OTHER" => "" }[entry.signoff_certificate_type].to_s
|
||||
@@ -223,6 +242,7 @@ class LogbookEntryPdf
|
||||
# result is recorded but whose text doesn't already certify it.
|
||||
def body_text(entry)
|
||||
text = entry.text.to_s.strip
|
||||
return "#{text}\n\n#{entry.signature.statement}" if entry.signature
|
||||
return text unless entry.entry_type == "INSPECTION" && entry.inspection_result.present? && !text.match?(/I certify/i)
|
||||
type = inspection_kind(entry, text)
|
||||
statement =
|
||||
|
||||
Reference in new issue
Block a user