mirror of
https://github.com/rickbarrette/simple-aircraft-manager-rails.git
synced 2026-11-17 23:50:36 -05:00
Calendar feed: due items (inspections, ADs, component limits, documents) as a private iCalendar link, hour-based dates projected from the past year's flying
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
87e30946fe
commit
98e943cf0a
14 files changed
+266
-7
No files matched your search
@@ -141,6 +141,7 @@ To back up or move a single aircraft with all its files, use **Access & Sharing
|
|||||||
| Major repairs and alterations | Form 337, STC, and ICA tracking; an STC's ICA can become a tracked recurring inspection. |
|
| Major repairs and alterations | Form 337, STC, and ICA tracking; an STC's ICA can become a tracked recurring inspection. |
|
||||||
| Weight & balance | History of empty weight and CG (linked to the alteration that changed them) and a loading calculator: takeoff and landing weight and CG against max gross and the CG envelope. The envelope can be entered as CG (inches) or as moment (lb-in/1000, as in POH moment charts and Garmin Pilot). |
|
| Weight & balance | History of empty weight and CG (linked to the alteration that changed them) and a loading calculator: takeoff and landing weight and CG against max gross and the CG envelope. The envelope can be entered as CG (inches) or as moment (lb-in/1000, as in POH moment charts and Garmin Pilot). |
|
||||||
| Status report | A printable maintenance status (91.417(a)(2)): total times, life-limited parts, time since overhaul, inspections, ADs with method and revision, major alterations, open discrepancies. Also on maintenance share links. |
|
| Status report | A printable maintenance status (91.417(a)(2)): total times, life-limited parts, time since overhaul, inspections, ADs with method and revision, major alterations, open discrepancies. Also on maintenance share links. |
|
||||||
|
| Calendar feed | A private iCalendar link (Profile) with everything coming due on your aircraft as all-day events; hour-based items get a date projected from the past year's flying. |
|
||||||
| Reminders | A Monday email to owners when something is overdue or coming due, and to anyone whose certificate (e.g. an IA) is about to expire; admins also get the records audit due date (needs SMTP; users can turn it off). |
|
| Reminders | A Monday email to owners when something is overdue or coming due, and to anyone whose certificate (e.g. an IA) is about to expire; admins also get the records audit due date (needs SMTP; users can turn it off). |
|
||||||
| Oil and fuel | Records, trend charts, and averages (last 20 intervals, IQR outlier filtering, manual exclusion). |
|
| Oil and fuel | Records, trend charts, and averages (last 20 intervals, IQR outlier filtering, manual exclusion). |
|
||||||
| Activity log | Every write is recorded as an `AircraftEvent`. |
|
| Activity log | Every write is recorded as an `AircraftEvent`. |
|
||||||
|
|||||||
@@ -0,0 +1,23 @@
|
|||||||
|
# The calendar feed: what's coming due on every aircraft the user can see,
|
||||||
|
# as all-day events (dates for hour-based items are projected from the past
|
||||||
|
# year's flying). Calendar apps fetch it with the secret link from Profile.
|
||||||
|
class CalendarFeedsController < ApplicationController
|
||||||
|
allow_unauthenticated_access
|
||||||
|
skip_before_action :redirect_to_setup
|
||||||
|
rate_limit to: 60, within: 1.hour, with: -> { head :too_many_requests }
|
||||||
|
|
||||||
|
def show
|
||||||
|
user = User.active.find_by(calendar_token: params[:token].to_s) or return head(:not_found)
|
||||||
|
cal = Ical.new("Aircraft maintenance")
|
||||||
|
host = Sso.app_url
|
||||||
|
user.accessible_aircraft.ordered.each do |aircraft|
|
||||||
|
DueList.new(aircraft).items.each do |i|
|
||||||
|
when_text = [ ("projected from recent flying" if i.projected), ("at #{i.due_hours} hrs" if i.due_hours) ].compact.join(", ")
|
||||||
|
cal.add(uid: "#{aircraft.id}-#{i.key}@simple-aircraft-manager", date: i.date,
|
||||||
|
summary: "#{aircraft.tail_number}: #{i.title}#{' (overdue)' if i.overdue?}",
|
||||||
|
description: [ "#{aircraft.tail_number}: #{i.title}", when_text.presence ].compact.join("\n"), url: "#{host}#{i.path}")
|
||||||
|
end
|
||||||
|
end
|
||||||
|
send_data cal.to_s, type: "text/calendar; charset=utf-8", disposition: "inline", filename: "aircraft-maintenance.ics"
|
||||||
|
end
|
||||||
|
end
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
# Profile: create (or replace) the secret calendar feed link.
|
||||||
|
class CalendarTokensController < ApplicationController
|
||||||
|
def create
|
||||||
|
current_user.regenerate_calendar_token
|
||||||
|
redirect_to edit_profile_path(anchor: "calendar"), notice: "Calendar link ready. Any earlier link no longer works."
|
||||||
|
end
|
||||||
|
end
|
||||||
@@ -3,7 +3,7 @@ class RecordVersionsController < ApplicationController
|
|||||||
include AircraftScoped
|
include AircraftScoped
|
||||||
before_action :require_owner!, only: :restore
|
before_action :require_owner!, only: :restore
|
||||||
|
|
||||||
SHARED = %w[AirworthinessDirective InspectionType].freeze
|
SHARED = { "AirworthinessDirective" => AirworthinessDirective, "InspectionType" => InspectionType }.freeze
|
||||||
|
|
||||||
def index
|
def index
|
||||||
@type = params[:type].presence_in(RecordVersion.where(aircraft_id: @aircraft.id).distinct.pluck(:item_type))
|
@type = params[:type].presence_in(RecordVersion.where(aircraft_id: @aircraft.id).distinct.pluck(:item_type))
|
||||||
@@ -16,8 +16,8 @@ class RecordVersionsController < ApplicationController
|
|||||||
# Puts back an AD or inspection type link that was removed (the removal
|
# Puts back an AD or inspection type link that was removed (the removal
|
||||||
# stays in the history, and the restore is recorded as a new link).
|
# stays in the history, and the restore is recorded as a new link).
|
||||||
def restore
|
def restore
|
||||||
version = RecordVersion.where(aircraft_id: @aircraft.id, event: "unlink", item_type: SHARED).find(params[:id])
|
version = RecordVersion.where(aircraft_id: @aircraft.id, event: "unlink", item_type: SHARED.keys).find(params[:id])
|
||||||
record = version.item_type.constantize.find_by(id: version.item_id)
|
record = SHARED.fetch(version.item_type).find_by(id: version.item_id)
|
||||||
return redirect_to(aircraft_record_versions_path(@aircraft), alert: "That record no longer exists.") unless record
|
return redirect_to(aircraft_record_versions_path(@aircraft), alert: "That record no longer exists.") unless record
|
||||||
c = version.changes_hash
|
c = version.changes_hash
|
||||||
if c["applies_to"] == "component"
|
if c["applies_to"] == "component"
|
||||||
@@ -33,8 +33,8 @@ class RecordVersionsController < ApplicationController
|
|||||||
|
|
||||||
# Whether an unlink can still be undone (the record exists and isn't linked that way now).
|
# Whether an unlink can still be undone (the record exists and isn't linked that way now).
|
||||||
def self.restorable?(version, aircraft)
|
def self.restorable?(version, aircraft)
|
||||||
return false unless version.event == "unlink" && SHARED.include?(version.item_type)
|
return false unless version.event == "unlink" && SHARED.key?(version.item_type)
|
||||||
record = version.item_type.constantize.find_by(id: version.item_id) or return false
|
record = SHARED[version.item_type].find_by(id: version.item_id) or return false
|
||||||
c = version.changes_hash
|
c = version.changes_hash
|
||||||
if c["applies_to"] == "component"
|
if c["applies_to"] == "component"
|
||||||
record.component_ids.exclude?(c["component_id"]) && aircraft.components.exists?(id: c["component_id"])
|
record.component_ids.exclude?(c["component_id"]) && aircraft.components.exists?(id: c["component_id"])
|
||||||
|
|||||||
@@ -6,6 +6,7 @@ class User < ApplicationRecord
|
|||||||
has_one :air_trail_connection, dependent: :destroy
|
has_one :air_trail_connection, dependent: :destroy
|
||||||
has_many :certificates, -> { ordered }, class_name: "UserCertificate", dependent: :destroy
|
has_many :certificates, -> { ordered }, class_name: "UserCertificate", dependent: :destroy
|
||||||
has_many :entry_signatures, dependent: :nullify
|
has_many :entry_signatures, dependent: :nullify
|
||||||
|
has_secure_token :calendar_token, length: 32
|
||||||
|
|
||||||
scope :active, -> { where(disabled_at: nil) }
|
scope :active, -> { where(disabled_at: nil) }
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,82 @@
|
|||||||
|
# Everything coming due on an aircraft, with a date: inspections, ADs,
|
||||||
|
# component replacement / TBO / inspection / expiry, and expiring documents.
|
||||||
|
# Items due by hours get a projected date from the aircraft's flying over
|
||||||
|
# the past year. Used by the calendar feed.
|
||||||
|
class DueList
|
||||||
|
Item = Data.define(:key, :title, :date, :projected, :due_hours, :kind, :path) do
|
||||||
|
def overdue?(today = Date.current) = date < today
|
||||||
|
end
|
||||||
|
|
||||||
|
# Hours flown per day over the past year (nil when it hasn't flown).
|
||||||
|
def self.daily_rate(aircraft, today: Date.current)
|
||||||
|
hours = aircraft.flight_logs.where(date: (today - 365)..today).sum(:tach_time).to_f
|
||||||
|
hours.positive? ? hours / 365.0 : nil
|
||||||
|
end
|
||||||
|
|
||||||
|
def initialize(aircraft, today: Date.current)
|
||||||
|
@aircraft = aircraft
|
||||||
|
@today = today
|
||||||
|
@rate = self.class.daily_rate(aircraft, today: today)
|
||||||
|
@now_hours = aircraft.current_hours.to_d
|
||||||
|
@urls = Rails.application.routes.url_helpers
|
||||||
|
end
|
||||||
|
|
||||||
|
def items
|
||||||
|
(inspections + ads + components + documents).compact.sort_by { [ _1.date, _1.title ] }
|
||||||
|
end
|
||||||
|
|
||||||
|
private
|
||||||
|
|
||||||
|
# The date it's due: the calendar date, or when the hours run out at the
|
||||||
|
# current rate, whichever comes first.
|
||||||
|
def item(key, title, kind, path, date: nil, hours_left: nil)
|
||||||
|
projected = hours_left && @rate ? @today + (hours_left.to_f / @rate).floor : nil
|
||||||
|
projected = @today if projected && projected < @today
|
||||||
|
use = [ date, projected ].compact.min
|
||||||
|
return unless use
|
||||||
|
Item.new(key: key, title: title, date: use, projected: use == projected && projected != date, kind: kind, path: path,
|
||||||
|
due_hours: hours_left ? (@now_hours + hours_left.to_d).round(1) : nil)
|
||||||
|
end
|
||||||
|
|
||||||
|
def hours_left(due_hours) = due_hours ? due_hours.to_d - @now_hours : nil
|
||||||
|
|
||||||
|
def inspections
|
||||||
|
Compliance.inspection_rows(@aircraft).map do |r|
|
||||||
|
item("inspection-#{r.type.id}", "#{r.type.name} due", "inspection", @urls.aircraft_inspections_path(@aircraft),
|
||||||
|
date: r.next_due_date, hours_left: hours_left(r.next_due_hours))
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
def ads
|
||||||
|
Compliance.ad_rows(@aircraft).map do |r|
|
||||||
|
next if r.status.to_s.in?(%w[not_applicable na conditional])
|
||||||
|
item("ad-#{r.ad.id}", "AD #{r.ad.name} due", "ad", @urls.aircraft_airworthiness_directives_path(@aircraft),
|
||||||
|
date: r.next_due_date, hours_left: hours_left(r.next_due_hours))
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
def components
|
||||||
|
@aircraft.components.in_use.includes(:component_type).flat_map do |c|
|
||||||
|
label = "#{c} #{c.model}".strip
|
||||||
|
path = @urls.aircraft_component_path(@aircraft, c)
|
||||||
|
since_service = c.hours_since_overhaul.to_d
|
||||||
|
[
|
||||||
|
(item("replace-#{c.id}", "Replace #{label}", "component", path, date: c.next_replacement_date,
|
||||||
|
hours_left: c.replacement_hours && c.replacement_hours - since_service) if c.replacement_hours || c.replacement_days),
|
||||||
|
(item("tbo-#{c.id}", "#{label} reaches TBO", "component", path,
|
||||||
|
date: c.tbo_days && c.overhaul_date ? c.overhaul_date + c.tbo_days : nil,
|
||||||
|
hours_left: c.tbo_hours && c.tbo_hours - since_service) if (c.tbo_hours || c.tbo_days) && !c.on_condition?),
|
||||||
|
(item("inspect-#{c.id}", "Inspect #{label}", "component", path,
|
||||||
|
date: c.inspection_days && c.overhaul_date ? c.overhaul_date + c.inspection_days : nil,
|
||||||
|
hours_left: c.inspection_hours && c.inspection_hours - since_service) if c.inspection_hours || c.inspection_days),
|
||||||
|
(item("expires-#{c.id}", "#{label} expires", "component", path, date: c.expires_on) if c.expires_on)
|
||||||
|
]
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
def documents
|
||||||
|
@aircraft.documents.expiring.map do |d|
|
||||||
|
item("document-#{d.id}", "#{d.name} expires", "document", @urls.aircraft_document_path(@aircraft, d), date: d.expires_on)
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
@@ -0,0 +1,46 @@
|
|||||||
|
# A minimal iCalendar (RFC 5545) writer for all-day events.
|
||||||
|
class Ical
|
||||||
|
def initialize(name)
|
||||||
|
@name = name
|
||||||
|
@events = []
|
||||||
|
end
|
||||||
|
|
||||||
|
def add(uid:, date:, summary:, description: nil, url: nil)
|
||||||
|
@events << { uid: uid, date: date, summary: summary, description: description, url: url }
|
||||||
|
end
|
||||||
|
|
||||||
|
def to_s
|
||||||
|
lines = [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Simple Aircraft Manager//EN", "CALSCALE:GREGORIAN",
|
||||||
|
"METHOD:PUBLISH", "X-WR-CALNAME:#{escape(@name)}", "REFRESH-INTERVAL;VALUE=DURATION:PT6H", "X-PUBLISHED-TTL:PT6H" ]
|
||||||
|
stamp = Time.current.utc.strftime("%Y%m%dT%H%M%SZ")
|
||||||
|
@events.each do |e|
|
||||||
|
lines += [ "BEGIN:VEVENT", "UID:#{e[:uid]}", "DTSTAMP:#{stamp}", "DTSTART;VALUE=DATE:#{e[:date].strftime('%Y%m%d')}",
|
||||||
|
"DTEND;VALUE=DATE:#{(e[:date] + 1).strftime('%Y%m%d')}", "SUMMARY:#{escape(e[:summary])}", "TRANSP:TRANSPARENT" ]
|
||||||
|
lines << "DESCRIPTION:#{escape(e[:description])}" if e[:description].present?
|
||||||
|
lines << "URL:#{e[:url]}" if e[:url].present?
|
||||||
|
lines << "END:VEVENT"
|
||||||
|
end
|
||||||
|
lines << "END:VCALENDAR"
|
||||||
|
lines.map { fold(_1) }.join("\r\n") + "\r\n"
|
||||||
|
end
|
||||||
|
|
||||||
|
private
|
||||||
|
|
||||||
|
def escape(text) = text.to_s.gsub("\\", "\\\\\\\\").gsub(";", "\;").gsub(",", "\\,").gsub(/\r?\n/, "\\n")
|
||||||
|
|
||||||
|
# Lines over 75 octets continue on the next line after a space.
|
||||||
|
def fold(line)
|
||||||
|
return line if line.bytesize <= 75
|
||||||
|
parts = []
|
||||||
|
current = +""
|
||||||
|
line.each_char do |ch|
|
||||||
|
if (current + ch).bytesize > (parts.empty? ? 75 : 74)
|
||||||
|
parts << current
|
||||||
|
current = +""
|
||||||
|
end
|
||||||
|
current << ch
|
||||||
|
end
|
||||||
|
parts << current
|
||||||
|
parts.first + parts.drop(1).map { "\r\n #{_1}" }.join
|
||||||
|
end
|
||||||
|
end
|
||||||
@@ -46,6 +46,23 @@
|
|||||||
<% end %>
|
<% end %>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
<section class="card card-body mt-5 max-w-md" id="calendar">
|
||||||
|
<h2 class="card-title">Calendar feed</h2>
|
||||||
|
<p class="mt-1 text-sm text-slate-600">What's coming due on your aircraft (inspections, ADs, part replacements and limits, expiring documents) in your calendar app. Items due by hours get a date projected from the past year's flying; it updates on its own.</p>
|
||||||
|
<% if @user.calendar_token.present? %>
|
||||||
|
<% feed = "#{Sso.app_url}#{calendar_feed_path(@user.calendar_token)}" %>
|
||||||
|
<input class="input mt-3 font-mono text-xs" value="<%= feed %>" readonly aria-label="Calendar feed address">
|
||||||
|
<div class="mt-2 flex flex-wrap gap-2">
|
||||||
|
<%= link_to "Subscribe", feed.sub(%r{\Ahttps?://}, "webcal://"), class: "btn-secondary btn-sm" %>
|
||||||
|
<%= button_to "Make a new link", calendar_token_path, class: "btn-secondary btn-sm",
|
||||||
|
form: { data: { turbo_confirm: "Replace the calendar link? Calendars using the old one stop updating." } } %>
|
||||||
|
</div>
|
||||||
|
<p class="hint">Anyone with this link can see the due list, so keep it private. In Google Calendar: Other calendars → From URL. On an iPhone: tap Subscribe.</p>
|
||||||
|
<% else %>
|
||||||
|
<div class="mt-3"><%= button_to "Create calendar link", calendar_token_path, class: "btn-secondary btn-sm" %></div>
|
||||||
|
<% end %>
|
||||||
|
</section>
|
||||||
|
|
||||||
<section class="card card-body mt-5 max-w-md" id="certificates">
|
<section class="card card-body mt-5 max-w-md" id="certificates">
|
||||||
<h2 class="card-title">Certificates</h2>
|
<h2 class="card-title">Certificates</h2>
|
||||||
<p class="mt-1 text-sm text-slate-600">Your FAA certificates, for signing logbook entries: “Sign as” fills in your name, the kind of certificate and its number.</p>
|
<p class="mt-1 text-sm text-slate-600">Your FAA certificates, for signing logbook entries: “Sign as” fills in your name, the kind of certificate and its number.</p>
|
||||||
|
|||||||
@@ -126,6 +126,11 @@ Rails.application.routes.draw do
|
|||||||
post "sign/:token", to: "invited_signings#create"
|
post "sign/:token", to: "invited_signings#create"
|
||||||
post "sign/:token/account", to: "invited_signings#account", as: :account_invited_signing
|
post "sign/:token/account", to: "invited_signings#account", as: :account_invited_signing
|
||||||
|
|
||||||
|
# Calendar feed of what's coming due (secret link; calendar apps can't sign in).
|
||||||
|
get "calendar/:token.ics", to: "calendar_feeds#show", as: :calendar_feed, constraints: { token: /[A-Za-z0-9]{32}/ },
|
||||||
|
format: false, defaults: { format: "ics" }
|
||||||
|
resource :calendar_token, path: "profile/calendar", only: :create
|
||||||
|
|
||||||
get "shared/:token", to: "shared#show", as: :shared
|
get "shared/:token", to: "shared#show", as: :shared
|
||||||
get "shared/:token/report", to: "shared#report", as: :shared_report
|
get "shared/:token/report", to: "shared#report", as: :shared_report
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,7 @@
|
|||||||
|
class AddCalendarTokenToUsers < ActiveRecord::Migration[8.1]
|
||||||
|
def change
|
||||||
|
# Secret for the user's calendar feed URL (calendar apps can't sign in).
|
||||||
|
add_column :users, :calendar_token, :string
|
||||||
|
add_index :users, :calendar_token, unique: true
|
||||||
|
end
|
||||||
|
end
|
||||||
Generated
+3
-1
@@ -10,7 +10,7 @@
|
|||||||
#
|
#
|
||||||
# It's strongly recommended that you check this file into your version control system.
|
# It's strongly recommended that you check this file into your version control system.
|
||||||
|
|
||||||
ActiveRecord::Schema[8.1].define(version: 2026_11_11_010000) do
|
ActiveRecord::Schema[8.1].define(version: 2026_11_11_020000) do
|
||||||
create_table "active_storage_attachments", force: :cascade do |t|
|
create_table "active_storage_attachments", force: :cascade do |t|
|
||||||
t.string "name", null: false
|
t.string "name", null: false
|
||||||
t.string "record_type", null: false
|
t.string "record_type", null: false
|
||||||
@@ -814,6 +814,8 @@ ActiveRecord::Schema[8.1].define(version: 2026_11_11_010000) do
|
|||||||
t.datetime "otp_enabled_at"
|
t.datetime "otp_enabled_at"
|
||||||
t.integer "otp_last_used_at"
|
t.integer "otp_last_used_at"
|
||||||
t.json "otp_recovery_codes"
|
t.json "otp_recovery_codes"
|
||||||
|
t.string "calendar_token"
|
||||||
|
t.index ["calendar_token"], name: "index_users_on_calendar_token", unique: true
|
||||||
t.index ["email_address"], name: "index_users_on_email_address", unique: true
|
t.index ["email_address"], name: "index_users_on_email_address", unique: true
|
||||||
t.index ["sso_uid"], name: "index_users_on_sso_uid", unique: true
|
t.index ["sso_uid"], name: "index_users_on_sso_uid", unique: true
|
||||||
end
|
end
|
||||||
|
|||||||
+3
-1
@@ -82,6 +82,7 @@ For domain-level forward auth, Authentik matches each line as a regular expressi
|
|||||||
^https://aircraft\.example\.com/profile/certificates(\?.*)?$
|
^https://aircraft\.example\.com/profile/certificates(\?.*)?$
|
||||||
^https://aircraft\.example\.com/profile/two_factor(/new|/recovery_codes)?(\?.*)?$
|
^https://aircraft\.example\.com/profile/two_factor(/new|/recovery_codes)?(\?.*)?$
|
||||||
^https://aircraft\.example\.com/help/records$
|
^https://aircraft\.example\.com/help/records$
|
||||||
|
^https://aircraft\.example\.com/calendar/[A-Za-z0-9]{32}\.ics$
|
||||||
```
|
```
|
||||||
|
|
||||||
What each group is for:
|
What each group is for:
|
||||||
@@ -97,8 +98,9 @@ What each group is for:
|
|||||||
| `/profile/certificates` | Invited mechanics adding their certificate before signing | Adding a certificate to their own account; it only returns to a `/sign/…` page |
|
| `/profile/certificates` | Invited mechanics adding their certificate before signing | Adding a certificate to their own account; it only returns to a `/sign/…` page |
|
||||||
| `/profile/two_factor…` | Invited mechanics setting up an authenticator app | Their own two-factor setup |
|
| `/profile/two_factor…` | Invited mechanics setting up an authenticator app | Their own two-factor setup |
|
||||||
| `/help/records` | The "How signing works" link on the signing form | The signing instructions, for signed-in accounts |
|
| `/help/records` | The "How signing works" link on the signing form | The signing instructions, for signed-in accounts |
|
||||||
|
| `/calendar/<token>.ics` | Calendar apps fetching the due-items feed (Profile → Calendar feed) | The due list of that user's aircraft, only with their secret 32-character token; making a new link retires the old one |
|
||||||
|
|
||||||
Leave out lines for features you don't use: without share links drop `/shared` and Active Storage; if mechanics never sign through invitations drop `/sign`, `/session`, `/profile/…` and `/help/records`.
|
Leave out lines for features you don't use: without share links drop `/shared` and Active Storage; without calendar feeds drop `/calendar`; if mechanics never sign through invitations drop `/sign`, `/session`, `/profile/…` and `/help/records`.
|
||||||
|
|
||||||
Everything else stays behind Authentik: the fleet, records, admin pages, the emailed sign-in links and password resets (an invited mechanic who forgets their password asks the administrator, who resets it under Admin → Users or sends a new invitation), and the Google Drive callback (`/admin/offsite_backup/callback`), which comes back to the administrator's own signed-in browser.
|
Everything else stays behind Authentik: the fleet, records, admin pages, the emailed sign-in links and password resets (an invited mechanic who forgets their password asks the administrator, who resets it under Admin → Users or sends a new invitation), and the Google Drive callback (`/admin/offsite_backup/callback`), which comes back to the administrator's own signed-in browser.
|
||||||
|
|
||||||
|
|||||||
@@ -20,6 +20,12 @@ To make new recovery codes or turn it off, enter a current code (or a recovery c
|
|||||||
|
|
||||||
Signing in with single sign-on doesn't ask for this code: the sign-on provider handles its own second factor.
|
Signing in with single sign-on doesn't ask for this code: the sign-on provider handles its own second factor.
|
||||||
|
|
||||||
|
## Calendar feed
|
||||||
|
|
||||||
|
**Create calendar link** gives a private address for your calendar app (Google Calendar: Other calendars → From URL; iPhone: tap **Subscribe**). It shows what's coming due on your aircraft as all-day events: inspections, ADs, part replacements, TBO and inspection limits, and expiring documents. Items due by hours get a date projected from the aircraft's flying over the past year, marked "projected". Calendar apps refresh it every few hours.
|
||||||
|
|
||||||
|
Anyone with the link can see the list, so keep it private; **Make a new link** retires the old one.
|
||||||
|
|
||||||
## Certificates
|
## Certificates
|
||||||
|
|
||||||
Add each certificate you sign maintenance records with: its kind (A&P, IA, airframe, powerplant, repairman, repair station, pilot…), its number, and for an IA, its expiry. You need one to sign a logbook entry, and the entry records which one you used. An IA expires on March 31 of each odd-numbered year unless renewed; you're reminded 60 days ahead.
|
Add each certificate you sign maintenance records with: its kind (A&P, IA, airframe, powerplant, repairman, repair station, pilot…), its number, and for an IA, its expiry. You need one to sign a logbook entry, and the entry records which one you used. An IA expires on March 31 of each odd-numbered year unless renewed; you're reminded 60 days ahead.
|
||||||
|
|||||||
@@ -0,0 +1,60 @@
|
|||||||
|
require "test_helper"
|
||||||
|
|
||||||
|
# Calendar feed of what's coming due, with projected dates for hour-based items.
|
||||||
|
class CalendarFeedTest < ActionDispatch::IntegrationTest
|
||||||
|
setup do
|
||||||
|
@owner = create_user("owner@example.com")
|
||||||
|
@a = create_aircraft(owner: @owner, tail_number: "N12345", tach_time: 1000)
|
||||||
|
# 36.5 hours flown in the past year: 0.1 hour a day
|
||||||
|
@a.flight_logs.create!(date: Date.current - 100, tach_time: 36.5)
|
||||||
|
@oil = create_component(@a, component_type: component_type("Oil"), manufacturer: "Phillips", model: "20W50",
|
||||||
|
replacement_hours: 50, replacement_days: 120, hours_since_overhaul: 45, overhaul_date: Date.current - 30)
|
||||||
|
@mag = create_component(@a, component_type: component_type("Magneto"), manufacturer: "Bendix", model: "S4LN-21",
|
||||||
|
inspection_hours: 500, hours_since_overhaul: 450, overhaul_date: Date.current - 400)
|
||||||
|
@a.documents.create!(name: "Registration", doc_type: "REGISTRATION", expires_on: Date.current + 200)
|
||||||
|
end
|
||||||
|
|
||||||
|
test "the due list dates calendar items and projects hour-based ones" do
|
||||||
|
items = DueList.new(@a).items.index_by(&:key)
|
||||||
|
oil = items["replace-#{@oil.id}"]
|
||||||
|
assert_equal Date.current + 50, oil.date # 5 hrs at 0.1/day, before the 120-day limit (90 days left)
|
||||||
|
assert oil.projected
|
||||||
|
assert_equal 1005.0, oil.due_hours.to_f
|
||||||
|
assert_equal Date.current + 500, items["inspect-#{@mag.id}"].date # 50 hrs / 0.1 a day
|
||||||
|
assert_equal Date.current + 200, items["document-#{@a.documents.first.id}"].date
|
||||||
|
refute items["document-#{@a.documents.first.id}"].projected
|
||||||
|
end
|
||||||
|
|
||||||
|
test "the profile makes a secret link; the feed is iCalendar without signing in; a new link retires the old" do
|
||||||
|
@owner.update_column(:calendar_token, nil) # an account from before calendar links
|
||||||
|
sign_in @owner
|
||||||
|
get edit_profile_path
|
||||||
|
assert_select "button", text: "Create calendar link"
|
||||||
|
post calendar_token_path
|
||||||
|
token = @owner.reload.calendar_token
|
||||||
|
assert_equal 32, token.size
|
||||||
|
get edit_profile_path
|
||||||
|
assert_select "input[value*='/calendar/#{token}.ics']"
|
||||||
|
assert_select "a[href^='webcal://']", text: "Subscribe"
|
||||||
|
|
||||||
|
delete session_path
|
||||||
|
get calendar_feed_path(token)
|
||||||
|
assert_response :success
|
||||||
|
assert_equal "text/calendar", response.media_type
|
||||||
|
body = response.body
|
||||||
|
unfolded = body.gsub("\r\n ", "")
|
||||||
|
assert body.start_with?("BEGIN:VCALENDAR\r\n")
|
||||||
|
assert_includes body, "SUMMARY:N12345: Replace Oil 20W50"
|
||||||
|
assert_includes body, "DTSTART;VALUE=DATE:#{(Date.current + 50).strftime('%Y%m%d')}"
|
||||||
|
assert_includes unfolded, "projected from recent flying\\, at 1005.0 hrs"
|
||||||
|
assert body.lines.all? { _1.chomp.bytesize <= 75 } # folded
|
||||||
|
|
||||||
|
sign_in @owner
|
||||||
|
post calendar_token_path
|
||||||
|
get calendar_feed_path(token)
|
||||||
|
assert_response :not_found
|
||||||
|
@owner.reload.update!(disabled_at: Time.current)
|
||||||
|
get calendar_feed_path(@owner.calendar_token)
|
||||||
|
assert_response :not_found
|
||||||
|
end
|
||||||
|
end
|
||||||
Reference in new issue
Block a user