技術仕様書

AI駆動ストーリー生成システム

OpenAI APIを活用した動的なストーリー生成により、ユーザーのアクションに応じて無限に展開するゲームブックを実現します。

デュアルAPI構造

• メインストーリー生成API (GPT-4.1-nano)
• 概略生成API (文脈保持用、400文字制限)
• 1回のアクションで2回のAPI呼び出し
• 効率的なコスト管理とストーリー品質の両立

システムプロンプト最適化

• 2,450文字 → 1,000文字（60%削減）
• エルドリア王国の世界観保持
• ユーザーアクション重視の指示
• マークダウン記法の禁止

古書風デザインシステム

中世ファンタジーの世界観を表現する一貫したデザインシステムにより、没入感の高いユーザー体験を提供します。

カラーパレット

• プライマリ: #8B4513（茶色）- 古書の革装丁
• アクセント: #DAA520（金色）- 装飾と強調
• 背景: #F5DEB3（ベージュ）- 古い紙の色合い
• テキスト: #3a2a1a（ダークブラウン）- 可読性重視

タイポグラフィ

• 見出し: Cinzel（セリフ体、装飾的）
• 本文: Crimson Pro（読みやすいセリフ体）
• レターポーシング、テキストシャドウの活用
• 階層的なフォントサイズ設計

視覚効果

• グラデーション背景による質感表現
• ボックスシャドウによる立体感
• 装飾的なボーダーと角の装飾
• ホバー効果とスムーズなトランジション

統合ギャラリーシステム

ゲーム内の美麗なイラストを高品質で閲覧できる統合ギャラリー機能により、視覚的な魅力を向上します。

モーダルベース設計

• フルスクリーンギャラリーモーダル
• グリッドレイアウトによる整理された表示
• 個別画像の拡大表示機能
• キーボード・マウス操作対応

画像最適化

• PNG → WebP変換による93%サイズ削減
• 40MB → 2.6MB（全11画像）
• レスポンシブ画像表示
• 遅延読み込みによる初期表示高速化

ユーザビリティ

• サムネイル表示とホバー効果
• 画像タイトル管理
• モーダル外クリックでの閉じる操作
• 古書風スタイルでの統一感

高度な履歴管理システム

二重構造の履歴管理により、AI処理の効率化とユーザーの完全な履歴閲覧を両立します。

デュアル履歴構造

• 完全履歴（gb1_history）: 制限なし、表示用
• 概略版（gb1_over_view）: 400文字制限、API用
• セッション変数による高速アクセス
• 時系列での完全なアクション記録

表示制御

• デフォルト非表示でのパフォーマンス向上
• ワンクリックでの履歴表示切り替え
• スクロール可能な履歴エリア
• 古書風デザインでの統一表示

データ管理

• 初期化時の自動履歴リセット
• ユーザーアクションの完全保存
• AIレスポンスの文字数制限なし記録
• タイムスタンプ付きの時系列管理

パフォーマンス最適化

フロントエンド・バックエンド両面での最適化により、高速で快適なユーザー体験を実現します。

フロントエンド最適化

• CSS-in-HTML設計による外部ファイル削減
• WebP画像による読み込み時間短縮
• 非同期ローディング表示
• レスポンシブデザインによるモバイル対応

API効率化

• システムプロンプト60%削減（2,450→1,000文字）
• 概略による文脈圧縮（400文字制限）
• 適切なモデル選択（GPT-4.1-nano）
• エラーハンドリングとタイムアウト制御

ユーザビリティ向上

• ローディングアニメーションによる待機時間軽減
• インタラクティブなボタン配置
• 確認ダイアログによる誤操作防止
• キーボードショートカット対応

システム技術仕様

フロントエンド技術

• HTML5/CSS3 with CSS Grid・Flexbox
• Vanilla JavaScript ES6+（フレームワーク非依存）
• Google Fonts（Cinzel、Crimson Pro）
• Font Awesome アイコン
• レスポンシブデザイン（モバイルファースト）

バックエンド技術

• PHP 7.4+ with cURL extension
• セッション管理（PHPセッション）
• OpenAI API統合（GPT-4.1-nano）
• RESTful API設計
• セキュリティ対策（HTMLエスケープ、XSS対策）

インフラ・運用

• Webサーバー（Apache/Nginx）
• WebPサポート
• HTTPS推奨
• ファビコン・Apple Touch Icon対応
• SEO最適化（メタタグ、構造化データ）

今後の技術発展

無限ゲームブックの将来的な機能拡張計画と技術革新の検討事項。

予定機能拡張

• セーブ・ロード機能（複数スロット対応）
• マルチエンディング管理システム
• キャラクターステータス・インベントリ機能
• 音響効果・BGM統合
• マルチプレイヤー対応（共同ストーリー作成）

技術改良予定

• データベース統合による永続化
• WebSocket リアルタイム通信
• PWA（Progressive Web App）対応
• 音声入力・出力機能（Speech API）
• AI画像生成統合（DALL-E API）

拡張性設計

• 他のファンタジー世界観への展開
• ユーザー生成コンテンツ機能
• コミュニティ機能（ストーリー共有）
• モバイルアプリ化（React Native/Flutter）
• VR/ARへの展開可能性