コンテンツにスキップ

Telemetry

テレメトリに関するフォローアップ事項を置く。設計ドキュメントは他ドメインの所有物のため、ここには他ドメイン合意・出典不一致が中心に集まる。 追加・更新の手順は .claude/rules/followups.md に従う。項目は末尾へ追記し、並べ替えない。

[309-01][未対応] 取り込みが飛行計画のリビジョンを書くようになったら相関を両方向で縛る

Section titled “[309-01][未対応] 取り込みが飛行計画のリビジョンを書くようになったら相関を両方向で縛る”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-24
  • 由来: docs/data-model/telemetry-er.md「リビジョンも持つ」

取り込み(telemetry-service-protoのFlightPlanDao・TelemetryDAO)は、履歴(telemetry)へ flight_plan_idと組でflight_plan_revision_idを書くようになった。ck_telemetry_flight_plan_pairは今も 「リビジョン単独を禁止する」片方向にとどめているため、組が全NULLか全非NULLかの両方向へ締められる。 締める前に、取り込みがリビジョンを書く前に入った行のバックフィルが要るかを決める。

[309-02][未対応] ASTM F3411のEU分類の相関をDB制約で縛るか決める

Section titled “[309-02][未対応] ASTM F3411のEU分類の相関をDB制約で縛るか決める”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-24
  • 由来: docs/data-model/telemetry-er.md「図1 カラム補足」(TELEMETRY.classification_typeの行)

category_eu・class_euはclassification_typeがEUのときだけ意味を持つが、取り込み (telemetry-service-protoのInvalidRangeCheck)はそれぞれの値域を単独で検査するだけで、この相関は 検査していない。このままCHECKで縛ると、TELEMETRY_DEAD_LETTERへ回るべき受信が取り込みの 制約違反になる。取り込みに相関の検査を足したうえでDB制約で縛るか、取り込みの検査に委ねるかを決める。

[309-03][対応済み] uas_idに一致する機体の解決がkind=UAS以外を拾わないか確認する

Section titled “[309-03][対応済み] uas_idに一致する機体の解決がkind=UAS以外を拾わないか確認する”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/data-model/telemetry-er.md「図1 カラム補足」(TELEMETRY.aircraft_idの行)

aircraft_idのFKをasset.asset_uas_attrsへ向けたことで、DB上はkind=UASの機体しか 入らなくなった。一方で取り込みがuas_idから機体を解決する経路がkindで絞っているかは 確認できていない。絞っていない場合、これまで通っていた受信がFK違反で落ちうる。 取り込み側の照会条件を確認する。

取り込みの照会(telemetry-service-protoのAircraftDao)はkind = 'UAS'で絞っていることを確認した。 由来のaircraft_idの行へ反映済み。

[310-01][未対応] iamスキーマができたらorganization_idにFK制約を張る

Section titled “[310-01][未対応] iamスキーマができたらorganization_idにFK制約を張る”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-24
  • 由来: docs/data-model/telemetry-er.md「図1 カラム補足」(*.organization_idの行)

IAMドメインの実体がこのリポジトリに無いため、organization_idにFK制約を張れていない。 当面は解決済みの機体のasset.asset.organization_idを複写することで実在を担保している。 同じ状態がasset.sql・flight_planning.sqlにもあるため、張るときはまとめて扱う。

[312-01][対応済み] 取り込みのINSERT列から旧USS由来の4列を外す

Section titled “[312-01][対応済み] 取り込みのINSERT列から旧USS由来の4列を外す”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-24
  • 由来: docs/data-model/telemetry-er.md「旧USSスキーマとの対応」

created_user・updated_user・updated_at・is_deleteはdb/schema/telemetry.sqlに無い。 対応表を「落とす(移植時にINSERT列から外す)」へ直したため、取り込み (telemetry-service-proto)のINSERT列からこの4列を外す改修が要る。 同節の冒頭は「構造を変える変更は加えない」としており、この1点だけが例外になる。

取り込み(telemetry-service-protoのTelemetryDAO)のINSERT列にこの4列が無いことを確認した。

[312-02][未対応] aircraft_idのNOT NULL化にJava側を追随させる

Section titled “[312-02][未対応] aircraft_idのNOT NULL化にJava側を追随させる”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/data-model/telemetry-er.md「図1 カラム補足」(TELEMETRY.aircraft_idの行)

aircraft_idをNOT NULLにしたが、TelemetryObservation.aircraftIdはOptional<AssetId>の ままである。値が常に入るようになったため、AssetIdへ変えて空の分岐を落とせる。 CurrentTelemetryViewは既にAssetIdで持つ。

[294-01][未対応] TelemetryObservationがspeedの値域(負値)を検証していない

Section titled “[294-01][未対応] TelemetryObservationがspeedの値域(負値)を検証していない”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/issues/issue-294-telemetry-trajectory/detailed-design.md「3-2. 速度と方位は素の数値である」

.claude/rules/java/main.mdの「値オブジェクト」が検証を求める対象だが、コンパクトコンストラクタは nullしか見ておらず、負値が飛行軌跡取得の応答まで素通りする。有限性(NaN・無限)は docs/data-model/followups.mdのdouble precisionの列の行が扱う。directionはDDLの ck_telemetry_directionが保証するため対象外。

[294-04][未対応] 1つの飛行計画に複数の機体が割り当たると飛行軌跡が混ざる

Section titled “[294-04][未対応] 1つの飛行計画に複数の機体が割り当たると飛行軌跡が混ざる”
  • 種別: 実体未作成
  • 登録日: 2026-09-24
  • 由来: docs/issues/issue-294-telemetry-trajectory/detailed-design.md「15-1. 1つの飛行計画に複数の機体が割り当たると軌跡が混ざる」

findTrackByFlightPlanはflight_plan_idでしか絞らないため、2機分の観測が1本の軌跡に混ざり、200で返る (uasId・uasEntityIdは最新1件の値)。uq_telemetry_aircraft_observedの一意性は機体単位のため、 機体をまたいで観測時刻が重なった場合だけはFlightTrajectoryの狭義単調増加が破れて500になる。 解決には機体で絞る条件が要り、Portのシグネチャと、機体を指定するパラメータを持たないOASの両方が変わる。

[315-01][未対応] 製品版の現在位置SSEの更新検知方式を決める

Section titled “[315-01][未対応] 製品版の現在位置SSEの更新検知方式を決める”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-25
  • 由来: docs/geospatial/design/telemetry-sse-change-detection.md「6. 製品版で決めること」

10月デモは飛行中の全機体を毎秒読むポーリングで、読む件数は過去に一度でも報告した全機体の数に比例する。 製品版の方式は、取り込み側を含むテレメトリのアーキテクチャの再検討の中で決める。由来の比較(A〜D)は材料で、 候補はこれに限らない。論理レプリケーション(CDC)はADR-009のBlue/Greenデプロイの運用と衝突する。

[315-03][未対応] テレメトリの欠損が60秒を超えた機体を表示から外してよいか決める

Section titled “[315-03][未対応] テレメトリの欠損が60秒を超えた機体を表示から外してよいか決める”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-26
  • 由来: docs/geospatial/BusinessLogicSpecifications.md「5.6. 現在位置のリアルタイム購読」の2-2-2

機能要件9.1.3.3.1は欠損時に最後の既知位置と経過時間を表示するとしているが、表示を続ける期間の定めが無い。 現在位置の一覧検索と購読は、旧USSを引き継いで60秒を超えた機体を返さない。60秒で外すか、飛行終了まで 残すか(残すなら購読のtelemetry.removeに鮮度切れと範囲外を区別する理由を持たせる)を上流の要件と合わせて決める。 購読の読み出しが失敗し続ける間は鮮度を判定できず、途絶えた機体が残る(同5.6節の2-3)。この扱いも合わせて決める。

[307-01][未対応] ASSETに無い機体のテレメトリを表示する経路が無い

Section titled “[307-01][未対応] ASSETに無い機体のテレメトリを表示する経路が無い”
  • 種別: 実体未作成
  • 登録日: 2026-09-26
  • 由来: docs/data-model/telemetry-er.md「未登録機体も却下記録に残す」

Broadcast Remote IDの受信機は付近の飛行中の機体を送信元によらず拾うが、uas_idに一致する機体が ASSETに無い受信はテレメトリとして記録せず、TELEMETRY_DEAD_LETTERへUNKNOWN_AIRCRAFTとして 却下する。TELEMETRY・CURRENT_TELEMETRYがorganization_idをNOT NULLで要求し、受信しただけの 機体では組織スコープを決められないためである。

このため現在位置一覧検索が返せるのはASSETに登録済みの機体に限られる。10月デモは他UTMが管理する 機体も自組織のASSETとして登録する回避策で成立するが、受信したものをそのまま表示する形にするには 受信しただけの機体の組織スコープをどう置くか(受信した組織に属させる/Nullableにする/未所属を表す 組織を設ける)を決める必要がある。APIの組織による絞り込みを外しても解決しない。

[315-05][未対応] 組織が複数になったときの購読の読み出しと接続の組織を決める

Section titled “[315-05][未対応] 組織が複数になったときの購読の読み出しと接続の組織を決める”
  • 種別: 実体未作成
  • 登録日: 2026-09-26
  • 由来: docs/geospatial/BusinessLogicSpecifications.md「5.6. 現在位置のリアルタイム購読」の2-1

購読は毎秒1回、自組織の全機体を読んで接続ごとに振り分ける。forDemoは組織が1つのため1回で足りるが、 認証を入れて組織が複数になると、読み出しは組織ごとに行い、接続は自分の組織を持つ必要がある。 RLSへ寄せる場合(同4.1)、リクエストの文脈を持たない定期実行のスレッドからどう組織を渡すかも決める。

[315-06][未対応] 購読の初期状態の件数に上限を設けるか決める

Section titled “[315-06][未対応] 購読の初期状態の件数に上限を設けるか決める”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-28
  • 由来: docs/geospatial/BusinessLogicSpecifications.md「5.6. 現在位置のリアルタイム購読」の1-2-1

telemetry.snapshotは全機体を1件のイベントで送るが、フロントの受信処理(utm-gui-protoの src/lib/api/sseStream.tsのMAX_BUFFER_CHARS)は上限を超えたイベントを捨てる。機体数の見込みと合わせて、 上限と超えたときの扱い(分割して送る・切り詰めて知らせる)をフロントと決める。

[315-07][未対応] フロントの現在位置SSEの受信処理をOASの契約に追随させる

Section titled “[315-07][未対応] フロントの現在位置SSEの受信処理をOASの契約に追随させる”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-28
  • 由来: docs/geospatial/BusinessLogicSpecifications.md「5.6. 現在位置のリアルタイム購読」の2-2-2

初期状態(telemetry.snapshot)が届かないまま待つ間(読み出しの失敗中)の表示が、フロントと決まっていない。 utm-gui-proto(develop)の受信処理はイベントの種別・途絶時の張り直し・422での停止についてOASへ追随した (utm-gui-proto PR #166)が、待つ間の表示は実装も無い(useTelemetryControllerのisLoadingを画面が使っていない)。 表示の仕方をフロントと決める。

[307-03][対応済み] 取り込みがTELEMETRY_DISPLAY_DEFAULTから複写しているか未確認

Section titled “[307-03][対応済み] 取り込みがTELEMETRY_DISPLAY_DEFAULTから複写しているか未確認”
  • 種別: 他ドメイン合意
  • 登録日: 2026-09-28
  • 由来: docs/data-model/telemetry-er.md「表示用の値は機体ごとの既定値で埋める」

複写を行うのは別リポジトリのtelemetry-service-protoで、utm-backend側からは実装の有無を確認 できていない。同表は10月デモ限りの新設テーブルのため、取り込みに新規の参照処理が要る。未実装なら 既定値の行があってもoperator_name・operator_id・statusはNULLのまま届く。同じ複写元を持つ uas_nicknameはdocs/data-model/followups.mdで実装状況を追跡しているので、同様に確認して記録する。

取り込み(telemetry-service-protoのTelemetryContextResolver)が由来の節のとおりに複写していることを確認した。 operator_nameは常に既定値から引き、operator_id・statusは飛行計画を解決できない場合だけ既定値で埋める。