Files
simple-aircraft-manager-rails/app/services/procedures_templates.rb
T
rickyandClaude Opus 5.5 e4c27c6ff7 API: draft logbook entries for signing
- POST /aircraft/:id/draft_batches turns a visit's work items into one
  unsigned entry per logbook, signed in the app (by a user with a
  certificate, or a mechanic through a returned or emailed invitation link).
- The squawks they resolve and inspections they complete (with their result)
  are held until every entry is signed, then applied, attributed to the last
  signer; draft_batch.completed webhook. A draft never clears a squawk alone.
- Drafts are for owners (integrations act for one, drafts:write scope);
  unsigned drafts can be withdrawn; lookup by external_ref.
- The signing and entry pages show where a draft came from and what signing
  will do.
- The suggested recordkeeping procedures describe the API once it's in use.

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

52 lines
2.0 KiB
Ruby

# Suggested text for the procedures fields the owner fills in: generated
# from the installation's configuration where the app knows the facts, with
# [bracketed] blanks for what only the owner knows. Inserted into the form
# for review; a revision can't be adopted while any blank is left.
module ProceduresTemplates
module_function
def hosting
[
t(:server, location: t(docker? ? :server_docker : :server_plain)),
t(:network, https: https_sentence),
t(:sign_in, sentence: sign_in_sentence, min: User::PASSWORD_MIN, minutes: User::LOCK_FOR.in_minutes.to_i,
tries: User::LOCK_AFTER, days: Authentication::SESSION_IDLE_TIMEOUT.in_days.to_i),
t(Sso.enabled? ? :signing_sso : :signing),
api_sentence,
t(:updates),
t(:secret_key)
].compact.join("\n\n")
end
def additional
since = Aircraft.where.not(electronic_records_since: nil).minimum(:electronic_records_since)
[
t(:who_makes_entries), t(:outside_signers), t(:account_problems), t(:share_links), t(:retention),
t(:paper_records, since: since ? I18n.l(since, format: :long) : t(:since_blank)),
t(:shop_visits), t(:sale)
].join("\n\n")
end
def https? = Rails.application.config.force_ssl
def https_sentence = t(https? ? :https_on : :https_off)
def sign_in_sentence
if Sso.enabled? && !Sso.password_login? then t(:sign_in_sso_only, provider: Sso.label)
elsif Sso.enabled? then t(:sign_in_sso, provider: Sso.label)
else t(:sign_in_password)
end
end
# Only when the API is in use: who can reach the records through it, and that signing stays in the app.
def api_sentence
integrations = ApiToken.integration.active.order(:name).pluck(:name)
return if integrations.empty? && !ApiToken.personal.active.exists?
t(:api, integrations: integrations.any? ? t(:api_integrations, names: integrations.to_sentence) : t(:api_no_integrations))
end
def docker? = File.exist?("/.dockerenv")
def t(key, **opts) = I18n.t(key, scope: "services.procedures_templates", **opts)
end