Files
simple-aircraft-manager-rails/docs/guide/sharing.md
T
rickyandClaude Opus 5.5 d8cd462194 Configurable roles: Owner, Mechanic, Pilot, Viewer and custom roles
What people can do on an aircraft now comes from their role there, and
administrators set what each role allows (Admin → Roles).

- Roles are installation-wide sets of permissions (31, grouped as flying,
  squawks and notes, maintenance records, imports and exports, the
  aircraft, notifications). Seeing an aircraft's records needs none.
- Built in: Owner (always every permission, so an aircraft can always be
  managed), Mechanic (shop maintenance: logbook, signing, components,
  inspections, ADs, squawks, reminders), Pilot (what pilots could do
  before) and Viewer (view only). Administrators can change all but
  Owner's, and add their own; a role can be deleted once nobody has it.
- Existing owners and pilots keep exactly what they could do.
- Admin → Users → a user lists their role on every aircraft, to change,
  remove or add. On the aircraft's Access page, anyone who manages people
  hands out roles, but only an Owner can give or take away Owner, nobody
  changes their own (except administrators), and an aircraft always
  keeps an Owner (AircraftAccess).
- Controllers declare the permission each action needs; a request that
  changes something with none declared is refused (and raises in
  development and tests), and a test walks every route to check.
- Weekly reminders and overdue alerts go to roles that get reminders;
  the DRS reminder also needs Manage ADs. The API follows the person's
  role; its owners_only error is now not_permitted.

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

2.5 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.

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. Record history shows every change to the maintenance records field by field (see Electronic records and signing).