Files
simple-aircraft-manager-rails/docs/guide/records.md
T
rickyandClaude Opus 5.5 14316bb60f Sign-in hardening: lockout, stronger passwords, authenticator codes
- 10 failed sign-ins in a row (password, authenticator code, or password
  at signing) lock an account for 15 minutes from any address; the user
  is emailed; admins can unlock. Same message as a wrong password.
- Passwords: at least 12 characters (max 72), refused if found in Have I
  Been Pwned (k-anonymity range API; fails open; PWNED_PASSWORDS_CHECK=false)
- Optional TOTP (authenticator app) with 10 recovery codes for password
  and emailed-link sign-in, and at signing (auth method password_totp);
  codes accepted once; admins can reset; SSO sign-in unaffected
- Demo/test passwords updated; guide, README and procedures document

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-07 15:17:56 -05:00

2.8 KiB

Electronic records and signing

These are the instructions for everyone who keeps or signs maintenance records here. They're part of the aircraft's recordkeeping procedures (FAA Advisory Circular 120-78B), so read them before signing your first entry.

Writing an entry

On the aircraft's Logbook tab, choose + New Entry (owners). Give the date, the logbook (aircraft, engine, propeller), the airframe total time and what was done. For an engine or propeller entry, pick the component (its times fill in) and tick any sub-components. A template can start the wording. An entry isn't a signed record until it's signed. See The logbook.

Signing

  1. Add your certificate (kind and number) once, on your profile.
  2. Open the entry and choose Sign. Read the entry as shown: your signature covers exactly that.
  3. Pick the certificate you're signing with. The statement you'll certify is shown with it (return to service, or the inspection statement).
  4. Re-enter your password (and your authenticator code, if you've set one up), or sign in again with single sign-on, tick the confirmation and choose Sign entry. You'll see a confirmation and get an email.

Never share your password or let someone else sign while you're signed in: a signature is yours alone. If you think someone has, tell the administrator straight away.

Mistakes

A signed entry can't be edited or deleted. Open it and choose Correct this entry (owners): a new entry starts from the original. Fix it, save it and sign it. The original stays, marked “Superseded by a correction”, with a link to the correction.

Someone else did the work

The owner can choose Ask someone to sign on the entry. The mechanic gets a one-time email link (valid for 14 days), signs in or creates their own account, adds their certificate and signs.

If they prefer paper, print the entry (Print for logbook), have it signed in ink, and keep the paper with the logbooks (scan it into Documents).

Checking a record

A signed entry shows who certified it, with which certificate, when (UTC), what they certified, and its status:

  • Valid: nothing has changed since signing.
  • Superseded: a signed correction replaces it.
  • Altered: the entry no longer matches what was signed. Tell the administrator.

The fingerprint (a SHA-256 of the entry) is printed on paper copies so a copy can be matched to the record.

Every change to any record is kept, with who made it and when, under Activity → Record history and in each entry's Change history. The history can't be edited, and it's checked every night along with every signature.

If the system is down

Make the entry on paper and sign it in ink. When the system is back, add the entry and scan the signed paper into Documents. The paper stays with the logbooks and remains the signed record for that entry.