リアルタイム自動更新の仕組み

注文管理画面を開いている間、バックグラウンドで自動的に最新の注文情報を取得してマージします。毎回ボタンを押す必要はありません。

※ タイムライン例:
10:00 初回同期 → 09:28〜10:00 を取得
10:02 2回目 → 09:30〜10:02 を取得
10:04 3回目 → 09:32〜10:04 を取得

なぜ「過去30分バッファ」が必要か

発送済みへのステータス変更や管理画面でのキャンセルは 注文日時そのものが変わらない ため、注文日時だけで差分を見ると変更を取りこぼします。

そこで毎回「最近30分以内に更新されたかもしれない注文」を保険として再取得しています。これによりステータス変更も最大2分遅れで反映されます。

リアルタイム性のまとめ

• 新規注文：最大 2分 遅れで表示
• 発送済 / キャンセル等のステータス変更：最大 2分 遅れで反映（直近30分以内の変更は確実にキャッチ）
• 30分より前の古い注文への変更：自動では拾えません（手動でボタンから再取得が必要）

初回取得（過去1年分）

注文キャッシュが空の状態で画面を開くと、初回のみ過去1年分の注文を全プラットフォームから自動取得します。2回目以降は差分同期のみなので軽量です。キャッシュを削除した場合のみ、再度1年分取得が走ります。

軽量化の比較

※ 1年分と比べると約 1/16,000 のデータ量。APIレート制限にも優しく、サーバー負荷もほぼゼロです。

自動更新バッジの見方（ヘッダー右上）

• 自動更新ON (2分毎)：正常に動作中。クリックでOFFに切替可能
• 自動更新中...：今まさに取得している最中
• 自動更新OFF：一時停止中。クリックで再開

プラットフォーム毎のステータスバッジ（楽天 / Yahoo! / auPAY）：

• 🟢 緑ドット：正常（マウスオーバーで最終取得時刻）
• 🔴 赤ドット + ⚠ マーク：取得エラー（ツールチップでエラー内容）
• ⚪ グレー：未取得（認証未設定など）

パラメータの調整

同期の頻度やバッファ時間は templates/orders.html 冒頭の以下の定数で変更できます:

AUTO_REFRESH_INTERVAL_MS = 120000  // 同期間隔（ミリ秒、既定: 2分）
AUTO_REFRESH_OVERLAP_MIN  = 30     // オーバーラップ（分、既定: 30分）
AUTO_REFRESH_MAX_WINDOW_DAYS = 7   // 長時間放置時の最大フォールバック