
News Observation Lab for Future
YouTube タイムスタンプを活用したクロスデバイスワークアウトフローの設計

目的と課題
YouTube に保存されたワークアウトと、再利用可能なトレーニングシステムでは解決すべき問題が異なる。ブックマークは URL を保持するだけだが、トレーニングワークフローは「どの動作が重要か」「開始位置はどこか」「ルーチン内での役割は何か」「次に取るべきアクション」は何かを保存しなければならない。
動画の瞬間をモデル化
YouTube の URL は参照先であり、エクササイズの定義ではない。一つの動画にウォームアップ、複数のデモ、プログレッション、クールダウンが混在することが多い。そのため、再利用できる単位は動画内部の特定の瞬間になる。タイムスタンプは文字列ではなく数値として保存し、検証・ソート・時間計算・プレイヤー連携を容易にする。また、元の URL は帰属表示とコンテキスト復帰のために残す。
YouTube URL の正規化
標準の watch URL、短縮リンク、モバイル共有リンク、既に t パラメータを含むリンクなど、様々な形態が存在する。各コンポーネントが独自に解釈しないよう、ユーザーがアクションを作成するときに一度だけ正規化を行う。正規化関数は URL をプラットフォームの API で解析し、サポート対象のホストのみ受け付け、動画 ID を抽出し、90 秒や 1m30s といった形式を秒数へ変換し、負の値や非有限値は除外する。結果として保存されるのは正規化された動画 ID と数値のタイムスタンプだけになる。
執筆と実行の分離
TrainFlow は Next.js の App Router を使用し、デスクトップ向けダッシュボードとモバイル向け PWA の二つのインターフェイスを提供する。デスクトップはアクションやルーチンの構築に特化し、ソース比較やノート編集、並び替え、全体像の把握が可能。一方モバイルは実行に集中し、現在のアクション、該当動画瞬間、少数のコントロール、次の手順だけを表示する。両者は同一のドメインモデルを共有しながら、異なる操作モデルを提供する。
ルーティンの順序付け
再利用可能なアクションを組み合わせることで、ルーティンはコピーされたメタデータの集合ではなく、明示的に順序付けられた構成になる。アクションへの参照は URL とタイムスタンプの重複を防ぎ、必要に応じてセッション固有の上書きを行える。順序は明示的に設定し、作成日時や DB の返却順に依存しないようにする。
状態機械としてのワークアウト実行
セッションは状態遷移で管理する方が理解しやすい。例として、ready → playing(START)、playing → resting または 次のアクション(COMPLETE_ACTION)、resting/paused → playing(RESUME)、playing → completed(FINISH)という遷移がある。これにより、バックグラウンド時の挙動や完了セッションの再開、次クリップの事前読み込みといったケースを遷移規則として扱える。永続化すべき最低限の状態は、ルーティンのバージョン、現在の項目、ステータス、関連タイムスタンプである。
AI 出力の編集可能性
AI は長尺動画から構造化されたアクションを生成するコストを削減できるが、生成されたタイトル、タイムスタンプ、キュー、初稿のルーチンはユーザーが確認・編集できる必要がある。トランスクリプトの不完全さや運動名の標準化不足、個別適合性の判断は人間が行う。AI が作成したドラフトはレビュー後に正式なアクションとして登録し、プロビナンス情報は必要に応じて保持するが、監査ログのように見せない。
最小限のログ記録
過剰なイベントスキーマを避け、まずはルーティン ID とバージョン、開始・終了タイムスタンプ、完了したアクション数、簡易ユーザーノート、任意で感じた難易度程度を記録する。これだけで「ユーザーは完了したか」「所要時間は?」といった実務的質問に答えられる。追加指標は将来の意思決定に有益であることが確認できた段階で導入する。
リンク耐久性の設計
外部動画は削除や編集、再生制限が起こり得る。アプリは以下の対応を取る:アクションタイトルとユーザーノートは保持し、ソースが利用不可の場合は明確な「ソース未取得」状態を表示、URL やタイムスタンプの修正を許可し、決して自動的に代替コンテンツに置き換えない。所有権を主張しない形で、ユーザー構造が外部依存に左右されても機能し続けるようにする。
汎用パターン
このアーキテクチャはワークアウト以外の長尺メディアベースのワークフローにも応用できる。共通の流れは「ソース正規化 → 正確な瞬間捕捉 → 再利用可能オブジェクト化 → 順序付き計画への組み立て → フォーカスドな状態機械で実行 → 必要最小限の結果記録」である。ブックマークは作業開始点に過ぎず、そこから本格的なワークフローへと展開することが鍵となる。
元記事: https://dev.to/fenglq02/designing-a-cross-device-workout-workflow-around-youtube-timestamps-51f