Files
simple-aircraft-manager-rails/docs/guide/sharing.md
T
rickyandClaude Opus 5.5 19bc3efa19 New accounts only from an administrator or an administrator's invitation
Anyone can add an aircraft and so manage its people, so invitations from
non-administrators could bring in new accounts without an administrator.

- An invitation makes a new account only if whoever made it is still an
  administrator when it's used; an aircraft's Access page invitations are
  for people who already have an account (its welcome page says so).
- Signing invitations no longer make accounts: the mechanic needs one
  first, and the owner is told when they don't have one.
- With SSO, "Continue with <provider>" on an administrator's invitation
  makes the account and accepts the invitation (only for its address when
  it has one), so invitations work without OIDC_AUTO_CREATE_USERS. That
  setting stays, documented as giving accounts without an invitation; the
  Authentik example now leaves it off.
- Docs: who makes accounts (guide, README, Authentik, .env.example, API).

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

3.3 KiB

Access, sharing and transfer

Access & sharing is for people whose role lets them manage the aircraft's people, share links or exports (Owners): open it from More at the top of the aircraft's pages.

People

Add people by email with a role: Owner, Mechanic, Pilot, Viewer, or one the administrator added (they need an account; ask the administrator). Change or remove their role at any time; What each role can do on the page lists them. See the roles table in Getting started.

Only an Owner can give or take away the Owner role, nobody can change their own, and an aircraft always keeps at least one Owner. An administrator can also give people roles on any aircraft from Admin → Users.

Invitations

To bring in someone who has an account, without knowing their email, use Invitations on the same page (new accounts are made only by the administrator or an administrator's invitation, so ask the administrator for someone who has no account yet): choose the role, optionally their email (then only they can use it, and it's emailed to them when email is set up), how many times it works and when it expires, then Create invitation. Copy the link shown and send it; it isn't shown again. Whoever opens it creates an account, or signs in, and gets the role on this aircraft. Revoke stops a link that hasn't been used. Administrators can also make invitations for several aircraft at once (Admin → Invitations).

Create Share Link gives a read-only link that needs no account, for a mechanic, partner, buyer or insurer:

  • Current Status: airworthiness, open squawks, components, inspection and AD status, consumption, notes and shared documents.
  • Maintenance Detail: also the logbook, inspection and AD compliance history, major repairs and alterations, resolved squawks and the printable status report.

Give it a label and optionally an expiry. Documents only appear if their visibility allows it (see Documents). Delete a link to revoke it. An aircraft can have up to 10.

Records package

Download records package builds a zip for the FAA, a buyer or a new maintainer: every logbook entry as a PDF with its signatures, a signature register, the change history, the status report, the current recordkeeping procedures, and the data archive. Its README explains each file, links to the source code, and includes a ready-to-run viewer/docker-compose.yml: with Docker Desktop, the recipient can run the app on their own computer and import the archive to browse everything.

Backup and transfer

Download .sam.zip exports the whole aircraft with its files. Anyone can load it with Fleet → More → Import from a .sam.zip archive (in this app or the original Simple Aircraft Manager) to make a copy they own, for example when the aircraft is sold. Use a new tail number if the original is already in that app. If an older download arrived as a folder (Safari can unzip downloads by itself), compress the folder back into a zip (in Finder: right-click → Compress) and import that.

Activity

The Activity tab lists everything done on the aircraft and by whom, newest first, loading more as you scroll (filter it by category). Record history shows every change to the maintenance records field by field (see Electronic records and signing).