mirror of
https://github.com/rickbarrette/simple-aircraft-manager-rails.git
synced 2026-11-17 15:50:36 -05:00
- Personal tokens (Profile → API tokens) act as their owner; integration tokens (Admin → Integrations) reach chosen aircraft and scopes, and their writes name the person they're for (SAM-On-Behalf-Of). Tokens are stored hashed, shown once, revocable, with last use recorded. - GET aircraft, components, due list, inspections, ADs, logbook entries and squawks; POST/PATCH squawks with external_ref links to the other system. - Idempotency-Key for safe retries, paging, JSON errors, rate limits. - Record history keeps the token with each change (in the hashed payload). - Webhooks (squawk created/updated/resolved, entry signed), HMAC-signed, retried, never sent to the server itself; deliveries listed for admins. - The outbound address check is shared by AirTrail and webhooks; reporting a squawk is announced the same way from the form and the API. - docs/guide/api.md: the API reference. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
67 lines
2.8 KiB
Ruby
67 lines
2.8 KiB
Ruby
module Api
|
|
module V1
|
|
# Squawks: list and report on an aircraft; find by external_ref; update.
|
|
# Resolving happens through a signed logbook entry, not here.
|
|
class SquawksController < BaseController
|
|
before_action -> { require_scope!(:read) }, only: %i[index show lookup]
|
|
before_action -> { require_scope!("squawks:write") }, :require_person!, only: %i[create update]
|
|
|
|
# GET /aircraft/:aircraft_id/squawks?status=open|resolved|all (default open)
|
|
def index
|
|
scope = find_aircraft.squawks.includes(:reported_by).with_attached_attachments
|
|
scope = case params.fetch(:status, "open")
|
|
when "open" then scope.active
|
|
when "resolved" then scope.resolved
|
|
else scope
|
|
end
|
|
render_page(scope) { ApiPresenter.squawk(_1) }
|
|
end
|
|
|
|
# GET /squawks?external_ref=redmine:issue:4512
|
|
def lookup
|
|
ref = params.require(:external_ref)
|
|
scope = Squawk.where(aircraft: aircraft_scope, external_ref: ref).includes(:reported_by).with_attached_attachments
|
|
render json: { data: scope.map { ApiPresenter.squawk(_1) } }
|
|
end
|
|
|
|
def show
|
|
render json: { data: ApiPresenter.squawk(find_squawk) }
|
|
end
|
|
|
|
# POST /aircraft/:aircraft_id/squawks
|
|
def create
|
|
aircraft = find_aircraft
|
|
squawk = aircraft.squawks.new(create_params.merge(reported_by: acting_user, resolved: false))
|
|
squawk.component_id = nil unless aircraft.components.exists?(id: squawk.component_id)
|
|
squawk.save!
|
|
SquawkReported.call(squawk, by: acting_user)
|
|
render json: { data: ApiPresenter.squawk(squawk) }, status: :created
|
|
end
|
|
|
|
# PATCH /squawks/:id: external_ref by anyone who may write; the rest
|
|
# (issue, priority, component, notes) by the aircraft's owners, as in the app.
|
|
def update
|
|
squawk = find_squawk
|
|
return render_error(:unprocessable_entity, "resolved", "A resolved squawk can't be changed.") if squawk.resolved?
|
|
attrs = params.require(:squawk).permit(:external_ref, :issue_reported, :priority, :component_id, :notes)
|
|
if (attrs.keys - %w[external_ref]).any? && !owner_of?(squawk.aircraft)
|
|
return render_error(:forbidden, "owners_only", "Only the aircraft's owners can change a squawk's details.")
|
|
end
|
|
attrs[:component_id] = nil if attrs.key?(:component_id) && !squawk.aircraft.components.exists?(id: attrs[:component_id])
|
|
squawk.update!(attrs)
|
|
render json: { data: ApiPresenter.squawk(squawk) }
|
|
end
|
|
|
|
private
|
|
|
|
def find_squawk = Squawk.where(aircraft: aircraft_scope).find(params[:id])
|
|
|
|
def create_params
|
|
params.require(:squawk).permit(:issue_reported, :priority, :component_id, :external_ref).tap do |p|
|
|
p[:priority] = p.fetch(:priority, 2).to_i
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|