Sentry Check（仮）

セントリー映像、全部見なくていい。

TeslaCamフォルダを選ぶだけで、数百本のセントリー映像から確認すべき場面を絞り込むWebサービスです。

現在地

ブラウザ内の事前検査、開発環境R2への明示的なアップロード縦切り、1イベント単位のFFmpeg前処理Containerが動作します。

Model Y向けの純粋な型付きカメラ幾何V2も実装済みです。

この契約は、左右repeaterを2方向の直接幾何として扱い、front、back、左右pillarを4方向の文脈役割として扱います。

ただし、実動画から固定アンカー、物体mask、track、文脈関連付け、カバレッジ証拠を作るproducerとpipelineは未実装です。

1. デスクトップChromeでTeslaCamフォルダを選択する
2. SentryClipsをイベントとカメラ単位にローカル整理する
3. 対象MP4の時間、コーデック、解像度、暗号化と破損候補をブラウザ内で確認する
4. 件数、容量、除外対象、未識別ファイル、要確認クリップを表示する
5. 明示操作後だけ、eligible動画を開発用Worker経由でローカルR2へ保存・再検証する
6. 検証済みの1イベントをFFprobeで再検証し、相対timelineと6方向の代表JPEGを生成する

ローカルのアップロード可否契約v1は、manifestと事前検査recordを次の三状態へ分類します。

• eligible：一意で整合したreadyの送信候補
• pending：事前検査結果がない保留clip
• blocked：重複、非ready、または矛盾したreadyにより自動送信しないclip

4方向の基本カメラに加え、AI4/HW4の左右ピラーカメラと旧rear_view接尾辞を認識します。 未知のカメラ接尾辞も動画を捨てず、要確認として残します。 実車で確認したSentryClips/<event>/event.mp4はTesla生成の補助プレビューとして明示除外し、件数を表示します。

MP4事前検査はファイル全体を一括読込せず、1 MiB単位で必要なboxへseekします。 実際に読み込む上限は1ファイルあたり8 MiBです。 この検査はコンテナのメタデータを確認するものであり、全フレームの復号や完全性を保証しません。

フォルダ選択と事前検査だけでは、動画も結果も外部へ送信しません。 eligible動画は、開発環境アップロードを明示的に押した場合だけ、ローカルWorker/R2へ送信します。本番ストレージには接続しません。 実TeslaCamの初回互換性確認、アップロード可否契約v1、開発用の1ファイル単位PUT、複数ジョブ分割、サーバー側再検証、FFmpeg前処理、型付きカメラ幾何V2を実装済みです。

次の実装境界は、raw-videoからカメラ幾何V2が受理するdescriptorと候補証拠を生成するproducerであり、本番向けmultipartと中断再開は別の未実装境界です。

プロダクト原則

• Teslaアカウント連携なし
• 専用デバイスなし
• 見逃しを避けるため、高再現率で候補を残す
• 「接触していない」と断定しない
• 元動画は解析後に早期削除し、学習利用は別途明示同意
• 1TB無制限を約束しない

ドキュメント

• プロジェクトコンテキスト
• アップロード可否契約 v1
• イベント前処理契約 v1
• Model Yカメラ幾何V2
• 事業・MVP計画書（2026-08-03）
• エージェント向け開発ルール

開発

前提：Node.js 24 Active LTS（.nvmrc）、npm、Python 3.11以上、FFmpeg。

npm install
python3 -m venv .venv-analyzer
source .venv-analyzer/bin/activate
python3 -m pip install -r containers/analyzer/requirements-dev.txt
npm run dev

品質ゲート：

npm run check
npm run cf:dry-run
npm run analyzer:container-smoke

npm run checkはmanifestパーサー、MP4事前検査、アップロード可否契約、UI、FFmpeg前処理のテスト、TypeScript/Python型検査、Biome/Ruff、プロダクションビルドを実行します。 cf:dry-runはCloudflare Workers Static Assetsのバンドルだけを検証し、デプロイはしません。 analyzer:container-smokeは非root・networkなし・read-only root filesystemでimageをbuildし、実MP4 fixtureからJPEGとresult.jsonを生成します。

構成

apps/web/                    React UI + Cloudflare Static Assets
apps/api/                    開発用アップロードWorker + ローカルR2再検証
packages/teslacam-parser/   TeslaCamパス、イベント、カメラ整理
packages/video-preflight/   MP4ヘッダーの分割読込と事前判定
packages/upload-contract/   ローカルのアップロード可否契約v1
packages/upload-session/    開発用ジョブ・署名トークン・SHA-256
packages/camera-geometry/   Model Y向けの型付きカメラ幾何V2
containers/analyzer/        Python + FFmpegの1イベント前処理CLI/Container
docs/                        プロダクト判断と原計画