mirror of
https://github.com/rickbarrette/simple-aircraft-manager-rails.git
synced 2026-11-17 15:50:36 -05:00
- 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>
42 lines
2.0 KiB
Ruby
42 lines
2.0 KiB
Ruby
# 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
|