コンテンツにスキップ

FlightPlan

飛行計画、DIPS通報・収集に関するフォローアップ事項を置く。Asset(機体・操縦者)は Asset へ置く。 追加・更新の手順は .claude/rules/followups.md に従う。項目は末尾へ追記し、並べ替えない。

[290-01][Issue #132] 飛行開始・飛行終了のIdempotency-Key再送契約を支える機構がない

Section titled “[290-01][Issue #132] 飛行開始・飛行終了のIdempotency-Key再送契約を支える機構がない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/flight-planning/BusinessLogicSpecifications.md「UC-MON-01 飛行を開始する」手順1-5、 「UC-MON-02 飛行を終了する」手順1-6

キーの保存先・保存内容が未決である点は削除・キャンセルの項目と同じだが、飛行開始はACCEPTED、 飛行終了はACTIVATEDに事前条件を限り再実行を許さないため、機構が入るまでは冪等キー付きの再送も、 契約が定める「最初の実行結果を返す」ではなく状態遷移違反になる (FlightPlanningHandler#activateFlightPlan・#completeFlightPlan)。そのまま運用するか、 遷移後の状態かつ同一キーの再送に限り現在の状態を返すかを、両APIまとめて決める必要がある。

[290-02][未対応] 操縦者・機体がリクエストしたユーザと同一組織に属することを検証する実体がない

Section titled “[290-02][未対応] 操縦者・機体がリクエストしたユーザと同一組織に属することを検証する実体がない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/openapi/frontend/flight-planning.yamlのPilotAssignmentInputのdescription

OASは他組織の操縦者・機体を指定した場合の応答を定めているが、FLIGHT_PLAN_PILOT_ASSIGNMENTのFKは 参照先の存在しか見ず、UseCase層にも検証がない。認証方式が未確定で「リクエストしたユーザの組織」を NoAuthActorの固定値でしか解決できないため、検証を足しても担保にならない。認証方式の確定とあわせて 実装する。

[290-03][未対応] report_exemption_reasonの値域を保証する実体がない

Section titled “[290-03][未対応] report_exemption_reasonの値域を保証する実体がない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/data-model/flight-plan-er.md「図2 カラム補足」のreport_exemption_reason

DB側はCHECK制約のないVARCHAR、ドメイン側もDipsReportRequirementのexemptionReasonが Optional<String>で、判定が設定する値は同クラスの定数として宣言されているだけのため、型としては 任意の文字列を受け付ける。.claude/rules/java/main.md「値オブジェクト」が挙げる「決まった選択肢を 表すコード値」からの逸脱にあたる。取りうる値の全体が確定した時点でenum化する。

[290-04][未対応] アプリ層だけが守っている不変条件にDB制約がない

Section titled “[290-04][未対応] アプリ層だけが守っている不変条件にDB制約がない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/data-model/flight-plan-er.md「図1 カラム補足」(revision_no・FLIGHT_RECORD・ radius_m)と「図2 カラム補足」(report_exemption_reason)

report_requiredとreport_exemption_reasonの相関、revision_noと初版の相関、FLIGHT_RECORDの 実開始・実終了の前後関係、FLIGHT_PLAN_AREA_CIRCLE.radius_mの正値性(DIPS_FLIGHT_PLAN.radius_m にはCHECKがあり非対称)、テキスト列が空白のみでないことを、ドメインのコンパクトコンストラクタだけが 守っている。直接投入・他プロセスの書き込みではすり抜け、読み出し側はFlightPlanRepositoryImplの findCurrentRevisionがデータ不整合として詰め替えるにとどまる。CHECKを足す際は、矛盾した行を直接SQLで 作って読み出し側のふるまいを固定している既存テスト(FlightPlanAreaRepositoryImplIntegrationTest・ FlightPlanRepositoryImplIntegrationTest)の扱いと、既存環境に違反行が無いかの確認が要る。 CHECK違反はアプリ側の不変条件違反と同じ500になるため(GlobalExceptionHandler#handleRepository)、 役割が重ならないことを前提に最後の砦として入れるかを判断する。

[294-05][未対応] ドメインのFlightPlanStatusの値が、生成DTOのenumおよびDDLのflight_plan_status_typeと一致しない

Section titled “[294-05][未対応] ドメインのFlightPlanStatusの値が、生成DTOのenumおよびDDLのflight_plan_status_typeと一致しない”
  • 種別: OAS反映
  • 登録日: 2026-09-24
  • 由来: docs/issues/issue-294-telemetry-trajectory/detailed-design.md「15. 積み残し」

どちらを正とするかが未決。飛行軌跡取得は、応答の列挙に無い値をInternalStateExceptionへ詰め替えて500にしている。

[298-01][未対応] 状態遷移ユースケースの「ロック付き取得 → 404」の重複を集約するヘルパーがない

Section titled “[298-01][未対応] 状態遷移ユースケースの「ロック付き取得 → 404」の重複を集約するヘルパーがない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: utm-design-docs docs/adr/ADR-019-pessimistic-lock-state-transition.md「方針」節。 重複箇所の実測はPR #223のレビュー

ADRは「取得 → 検証 → 保存」の集約を求めるが、usecaseパッケージの9箇所(8クラス。ReportFlightPlanUseCaseは 2箇所)で一致するのは取得だけで(RegisterFlightPlanUseCase#doRegisterほか。例外メッセージまで同じ)、検証と保存はユースケースごとに 異なるため、束ねると呼び出し側が抽象と戦う形になる。ADRが挙げる「ロックの取り忘れ」の防止はヘルパーでは 達成されない。トランザクション外からの呼び出しはFlightPlanRepository#findByIdForUpdate自体が弾くため、 残るのは状態遷移ユースケースがfindByIdを使う誤りだけで、これにはArchUnitルールが要る(別に検討する)。 requireCurrentRevisionの重複(ActivateFlightPlanUseCase・CompleteFlightPlanUseCase・ CancelFlightPlanUseCase・ReportFlightPlanUseCaseの4箇所)も同じ宛先で扱う。着手の条件としていた飛行計画削除・ 通報・周辺計画収集の各PR(#223・#225・#229)はマージ済みで、着手できる。

[298-02][未対応] 運航状態の遷移をDIPSへ知らせる手段がない

Section titled “[298-02][未対応] 運航状態の遷移をDIPSへ知らせる手段がない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/flight-planning/BusinessLogicSpecifications.md「UC-MON-02 飛行を終了する」手順1-2

飛行開始・飛行終了はDIPSを呼ばずUTM内の状態だけを進めるため、DIPS側の飛行計画ステータスは通報時の値の まま残る。DIPSは飛行状態を受け取るAPIを持つが、模擬DIPSが提供するのは飛行計画通報・参照だけで呼び出し先が 存在せず、Portも無い(tests/mocks/mock-dips/flightplan-spec.md)。飛行状態の通報を10月デモの範囲に含めるかを 決め、含めるなら模擬DIPSへの追加(他社が運用する検証環境のため合意が要る)とあわせて実装する。UTM側の 運航状態はFLIGHT_PLAN_STATE_EVENTに残るため、後から通報を足しても履歴は失われない。

[298-03][未対応] DIPS_REPORTの変換失敗の扱いが読み出し経路で揃っていない

Section titled “[298-03][未対応] DIPS_REPORTの変換失敗の扱いが読み出し経路で揃っていない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: src/main/java/com/intent_exchange/utm/infrastructure/persistence/postgres/FlightPlanRepositoryImpl.javaの findDipsReportsByFlightPlanId

resolveDipsReceiptNos・findOwnReportedDipsFlightPlanIds・findDipsFlightPlanIdは変換失敗を RepositoryException(データ不整合として500)へ詰め替えるが、findDipsReportsByFlightPlanIdだけは toDipsReportが投げるIllegalArgumentExceptionを素通しする。同メソッドは本番コードから呼ばれていない (呼び出し元はテストのみ)ため、400として返る経路は今は無い。詰め替えを揃えるか、メソッドを削除するかを決める。 dips_receipt_noが空白のみでないことをDDLで保証する話は[290-04]で扱う。

[298-04][未対応] 実飛行を伴わずに終わった飛行計画をENDEDにする経路がない

Section titled “[298-04][未対応] 実飛行を伴わずに終わった飛行計画をENDEDにする経路がない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/flight-planning/design/statemachine/flight-plan-statemachine.md「飛行計画ステータス (status)の遷移」。契機はPR #298のレビュー(@t-kuri の指摘)

ENDEDへの遷移をACTIVATEDからに限ったため、本登録後に天候都合などで飛ばずに終わった計画は ACCEPTEDのまま残り、CANCELLED(中止・取消)と区別して終わらせられない。ASTMの状態遷移は ACCEPTEDからENDEDへ直接遷移できる。ACCEPTEDからの終了を許すかを決め、許すなら遷移図・ 飛行終了APIの事前条件(BusinessLogicSpecifications.md「UC-MON-02 飛行を終了する」手順1-1)・OASの descriptionを揃え、実飛行(FLIGHT_RECORD)の行が無いままENDEDになる場合の扱いも決める。 10月デモ以降で構わない、というのが指摘時の合意である。

[299-01][未対応] 通報実行中(REPORTING)にキャンセルされた飛行計画を、取り下げが可能になったときに取り下げる主体がいない

Section titled “[299-01][未対応] 通報実行中(REPORTING)にキャンセルされた飛行計画を、取り下げが可能になったときに取り下げる主体がいない”

通報実行中(REPORTING)にキャンセルされた飛行計画を、取り下げが可能になったときに取り下げる主体がいない。キャンセルは通報状態を動かさずに応答を返して終わり(CancelFlightPlanUseCaseのcancelAcceptedが直前の値をそのまま複写する)、実行中の通報はその後に確定してREPORTEDになる(ReportFlightPlanUseCaseのrequireStillReportingは運航状態を見ない)。ここまでは手順1-3が定める仕様どおりであり、受付番号(DIPS_REPORT.dips_receipt_no)が残るため取り下げの対象を指すことはできる。欠けているのは取り下げを実行する契機である。 同手順はキャンセル処理の中でのみ取り下げを行うと定めるが、キャンセルの時点ではREPORTINGで受付番号がまだ無く取り下げられず、キャンセルAPIはその後この飛行計画を再訪しない。候補は2つある。(a)通報の確定側で運航状態がCANCELLEDなら続けて取り下げる。取り下げの実装箇所がキャンセル側と2つになり、外部呼び出しを伴う状態遷移がもう1組増える(ADR-022の3段構成が2組)。取り下げ自体が失敗した場合は解消しない(成否が確定した失敗はREPORTEDへ戻し、成否不明はWITHDRAWINGのまま滞留する)。(b)滞留した状態の突き合わせ・再試行で拾う(ADR-022の残課題である滞留からの復帰と同じ枠組み)。REPORTING中に削除された飛行計画は受付番号すら残らず対象を指せない(docs/data-model/followups.mdの「飛行計画削除の手順1-2・飛行計画キャンセルの手順1-3が定めるDIPS取り下げ」の行)ため、どちらを採るかは削除側とあわせて決める

[299-02][対応済み] 飛行計画キャンセルを10月デモで実装することが上流設計と食い違う

Section titled “[299-02][対応済み] 飛行計画キャンセルを10月デモで実装することが上流設計と食い違う”

飛行計画キャンセルを10月デモで実装することが上流設計と食い違う。utm-design-docsのdocs/usecase/flight-plan/flight-plan-usecase.mdは、実装範囲の節・ユースケース図のTODO・ユースケース一覧の3箇所でキャンセルを10月デモの実装対象外としている。一方で本リポジトリはキャンセルAPI(cancelFlightPlan)を飛行開始・終了とあわせてAPIを分離した時点からOASに定義しており、forDemoの3ポリシーも対象APIに含め、PR #299が実装と5.8節を入れた。

上流資料は対象外のままとし、実装はそのまま残す。 資料の所有者へ照会し(ix-reamo/utm-design-docs#67)、10月デモの要求としてキャンセルが必須でないことを確認したうえでの判断である。OASから削除する案も出たが、10月以降に使えること、フロントエンドが既定でmockに向きAPI単位でバックエンドへ切り替える構成のため使わないoperationがあっても実害がないことから採らない。上流資料と実装の食い違いは承知のうえで残す。

[324-01][未対応] 飛行計画に紐づかず、表示範囲を指定して他の飛行計画を集める手段がない

Section titled “[324-01][未対応] 飛行計画に紐づかず、表示範囲を指定して他の飛行計画を集める手段がない”

周辺データ更新は自組織の飛行計画を起点に集めるため、自計画が近くにない場所(テレメトリ画面の表示範囲など)では何も集まらず、デモでは周辺距離を広げて補っている。表示範囲を指定して集める手段はUC-PLAN-06として周辺データ更新とは別に追加する(周辺データ更新は残す)が、APIも収集結果の保持方法(周辺データ更新は起点リビジョンへのリンクで持つ)も未設計である。