sharon8811/newsread

NewsRead README デモ動画

1つのコマンドで正式なデモmp4を生成します：

.claude/skills/demo-video/scripts/run_demo.sh [output.mp4]
# デフォルト出力先: docs/assets/newsread-demo.mp4

パイプラインの流れ：隔離されたバックエンド（:8010、newsread_test DB）を起動 → デモコンテンツをシード → フロントエンド（:3010、開発モード）を起動 → システムChromeを使用してスクリプト化されたPlaywrightツアーを録画（ヘッドレス、アニメーションカーソル＋キャプションを注入）→ ffmpegでH.264 mp4に変換。サーバーは停止され、テストDBのみが操作されます。ユーザーの実際のdocker-composeスタック（:3000/:8000）には一切影響を与えません。

調整可能なパラメータ：DEMO_SCHEME=dark|light（デフォルトはdark）、DEMO_SPEED=1.15（mp4内の再生速度）、CHROME_PATH（代替ブラウザバイナリ）。

前提条件（このマシンでは通常すでに満たされているもの）

• docker-compose Postgresが:5433で起動していること（newsread_test DBのみ使用）
• backend/.venvが同期されていること（uv sync済み）、frontend/node_modulesがインストールされていること
• ffmpegがPATHに含まれていること、Google Chromeがインストールされていること
• インターネット接続が可能であること — ツアーはライブのHNコメント、カタログフィードプレビュー、picsumサムネイルを取得します。オフラインでも録画は行われますが、それらのセクションは品質が低下します。
• ポート8010/3010が空いていること；arqワーカーがテストDBに対して実行されていないこと（フェイクのデモフィードを更新しようとします — 無害ですがノイズになります）。

標準ツアーで表示される内容（速度調整前で約80秒）

1. ローディング中の受信トレイ上のタイトルカード
2. 受信トレイのスクロール — 記事が通過すると自動既読；未読ピルが減っていく
3. フラッグシップ記事（