運航調整機能 処理の流れ詳細 運航調整コンテキストのスイープ(定期実行) デモ向け版
デモ向け版(forDemo)の、運航調整コンテキストの時間経過に伴う状態遷移をポーリングで反映する定期処理(以下「スイープ処理」)の処理の流れを示す。
外部からのAPI呼び出しに応じて実行される他の処理と異なり、本処理はアプリケーション内部のスケジューラ(CoordinationSweepScheduler)が一定間隔で起動する。
1. 参照資料
Section titled “1. 参照資料”- 業務ロジック仕様
- docs/coordination/BusinessLogicSpecifications.md 6.2節
- 状態遷移
- docs/coordination/state/forDemo/StateTransition_Coordination_Context_SimpleVerForDemo.pu
2. 起動契機・間隔
Section titled “2. 起動契機・間隔”- Springのスケジューラ(
@Scheduled)により、一定間隔で自動的に起動する - ポーリング間隔は
coordination.sweep.interval-secondsで設定する(既定60秒、forDemo環境向け) - 1回の起動で例外が発生しても、以降の定期実行は継続する(ログ出力のみでスケジューラスレッドを落とさない)
3. 処理の流れ
Section titled “3. 処理の流れ”デモ向け版(forDemo)では、下記のBlocked→Negotiableの遷移のみを対象とする。期限切れ判定(context_timeout等経過時のNotCoordinated遷移、docs/coordination/state/future/StateTransition_Coordination_Context.pu参照)は今後追加予定で、本処理に手順を追加していく想定(スケジューラ自体の変更は不要)。
-
- コンテキストごとの最新の運航調整情報レコードのうち、下記両方に該当するものを一覧取得
- コンテキスト状態が
Blocked - インターバル解除時刻(
interval_cancellation_time)を現在時刻が経過している
-
- 対象レコードそれぞれについて、以下を実行
- 2-1. コンテキスト状態を
Negotiableへ更新 - 2-2. 画面表示用情報(display_status・request_possible_flag・response_possible_flag)を、更新後のコンテキスト状態から算出し直して保存する(
CoordinationStatus_MappingTable_forDisplay.md準拠。フロントエンドの「調整依頼実行」ボタンの活性判定に使用)
- 「調整依頼の実行」処理(
Coordination_SequenceDetail_Requests_forDemo.md4節)は、本スイープ処理の実行タイミングを待たずに、コンテキスト状態がBlockedかつインターバル解除時刻を経過している場合はその場でNegotiableと読み替えて判定する(DB更新はしない、その場限りの判定)。そのため、再依頼の受理可否自体は本スイープ処理の間隔に依存しない。 - 本スイープ処理は、GET系API(
GET /api/v1/coordination/coordinations)で参照するcontext_status・display_status・request_possible_flagを実態に追従させるためのものであり、最大でポーリング間隔分の反映遅延が生じ得る。