kuzu-log システム機能改善要望書

kuzu-log システム機能改善要望書
1. 概要
本ドキュメントは、PHP/SQLベースのWebアプリケーション「kuzu-log」の完成度を引き上げ、現代のSNS疲れにアプローチするエンタメ性を強化するための機能改善・追加仕様書である。既存のCRUD基盤（chat.php, lib.php, schema.sql 等）をベースに、「ショート動画のような視聴体験・UI」を新たに導入する。

2. 新規追加機能：『kuzu-Shorts（縦型ショートUI）』
【機能概要】
従来のテキスト掲示板形式のタイムラインとは異なり、スマホの画面いっぱいに1件の投稿（動画・画像、またはインパクトのある巨大テロップテキスト）が表示され、上下のスワイプ操作で次々に他人の泥臭い日常（クズエピソード）をテンポよく消費できる機能。

【具体的な画面仕様（pages/shorts.php の新規作成）】
全画面（モバイルファースト）UI: * 1画面に1投稿のみをジャストサイズで表示。背景は黒基調、テキストや動画は中央に配置。

右側固定のリアクション（操作）レイアウトルート:

画面右側に、ショート動画アプリ（TikTokやYouTube Shorts）でお馴染みの「縦並びボタン」を配置。

お疲れボタン（最重要）: 従来の「いいね」の代わりとなる、同情と肯定のリアクションカウンター。

クズ度評価ボタン: 閲覧者がその投稿に対して「軽度・中度・重度」の判定を下せるボタン。

コメントアイコン: 該当のクズ投稿に対するツッコミや慰めのチャット（chat.phpへ連動）を開く。

非同期スワイプ（JavaScript / Fetch API）:

画面を上下にスワイプ（または次へボタンをタップ）すると、ページ遷移（リロード）なしで次のクズ投稿がバックエンド（lib.php経由でSQLから取得）から自動で読み込まれる仕様。

【データ構造の拡張（schema.sql への追加仕様）】
メディア対応: posts テーブルに、ショート動画（mp4形式等）や画像（jpg/png）のファイルパスを保存する media_path カラム（VARCHAR）を追加。

テキストのテロップ化: 動画がない投稿でもショート動画風に見せるため、投稿テキストを自動で巨大な「謝罪風テロップ」や「文字装飾」に変換して画面中央に表示させる。

3. バックエンドおよびデータ連携の改善
ランダム・レコメンド抽出（lib.php へのクエリ追加）:

ranking.php のような単純な順序ではなく、「まだ見ていない投稿」「直近でお疲れボタンが急増している投稿」を優先的に、または完全にランダム（ORDER BY RAND()）で1件ずつフロントエンドに返すAPIロジックを実装。

非同期処理の徹底:

お疲れボタンが押された際、動画の再生やスワイプの手を止めないよう、データベースへのカウントアップ処理はすべて非同期（Fetch API / POST送信）で行う。

🤖 【AI（Claude / ChatGPT）への実装指示用プロンプト】
既存のソースコードをAIに修正・生成させる際は、以下のテキストをそのままコピペして使用すること。

【AIへの指示】
私はPHPとSQL（AppsJPベース）で「kuzu-log」というアプリを作っています。
上記の「kuzu-log システム機能改善要望書」に基づき、新規画面となる pages/shorts.php のソースコード（HTML/CSS/JavaScript） を作成してください。

【満たすべき条件】

スマホ全画面でショート動画や巨大テキストテロップが1件ずつ表示されるUIにすること。

画面右側に、ページリロードなし（非同期）で動作する「お疲れボタン」と「クズ度判定ボタン」を設置すること。

次の投稿を非同期で読み込むためのJavaScript（Fetch API）のベースコードも含めること。

これに伴い、動画パスを保存するために schema.sql に追加すべき ALTER TABLE 文も出力してください。