Merge branch 'develop' into bearl27-patch-1

Author: yone-al

README.md

@@ -1,13 +1,17 @@
-# プロダクト名 
+# プロダクト名
+
 <!-- プロダクト名に変更してください -->
 
 ![プロダクト名](https://kc3.me/cms/wp-content/uploads/2026/02/444e7120d5cdd74aa75f7a94bf8821a5-scaled.png)
-<!-- プロダクト名・イメージ画像を差し変えてください -->
 
+<!-- プロダクト名・イメージ画像を差し変えてください -->
 
 ## チーム名
+
 チーム10 XXXX
+
 <!-- チームIDとチーム名を入力してください -->
+
 # プロダクト名
 
 > キャッチコピー(1行で「何を誰のために解決するか」)
@@ -16,32 +20,34 @@
 
 ## どんな「本当に欲しい」に着目したか
 
-<!-- 
+<!--
   誰の、どんな "欲しい" に焦点を当てたかおしえてください。
 -->
-  関東から関西に来る人におすすめor関西から関東に行く人におすすめ
-  関西人の関西ノリは他の人に
+
+関東から関西に来る人におすすめor関西から関東に行く人におすすめ
+関西人の関西ノリは他の人に
 
 ## どんなアプローチで「本当に欲しい」を実現しましたか？
 
 <!--
   プロダクトが実現したアプローチや価値についておしえてください。
 -->
-  関西人ノリをクイズで体験し、関西人を理解
+
+関西人ノリをクイズで体験し、関西人を理解
 
 ---
 
 # 2. プロダクトの機能
 
 <!--
-  このプロダクトが持つ機能について、できるだけ詳しくおしえてください。  
+  このプロダクトが持つ機能について、できるだけ詳しくおしえてください。
 -->
-  関西人がチャット形式で関西ノリであるお題について説明する
-  
-  ユーザはお題を推測し、解答を送信して正誤判定を行う
 
-  過去の面白かったチャットを見ることができるので、クイズに参加しなくても、関西人ノリを体験することができる
----
+関西人がチャット形式で関西ノリであるお題について説明する
+
+ユーザはお題を推測し、解答を送信して正誤判定を行う
+
+## 過去の面白かったチャットを見ることができるので、クイズに参加しなくても、関西人ノリを体験することができる
 
 # 3. 使い方・デモ
 
@@ -61,8 +67,6 @@
 正解なら、お気に入り登録をするのか、もう一度遊ぶかを選択することができる
 不正解なら関西人の会話がそのまま続くので、お題が何かユーザが考え続ける
 
-
-
 ---
 
 # 4. 技術面でのこだわり
@@ -72,9 +76,37 @@
   技術面でのこだわりや挑戦の内容をおしえてください。
   名前は最後に消した方がいいかも
 -->
-  Geminiのプロンプト調整(久保田)
-  クイズとしても面白くなるために難易度の調整を行った
-  関西人(京都人と大阪人の話し方や考え方)を再現する
+
+## バックエンド
+
+### 🏗️ 3層アーキテクチャ（Controller / Service / Repository）
+
+- **責務の分離とDI**:
+  各層の責務を明確に分離し、インターフェースで接続することで依存性を注入（DI）しています。Controller層はHTTPリクエストの受付・レスポンス返却、Service層はビジネスロジック、Repository層はDBアクセスを担当しています。
+
+### 🤖 Gemini API 連携
+
+- **プロンプト調整**:
+  京都人と大阪人のキャラ付け、前半→中盤→終盤で難易度が段階的に下がるヒント構成など、クイズとして成立するよう細かく指示を設計しました。
+- **JSON構造化出力**:
+  レスポンスのMIMEタイプとJSONスキーマを指定することで、Gemini の出力を確実にパース可能な JSON 形式に制約しています。
+- **生成パラメータの調整**:
+  毎回異なるお題・会話が生成されやすいように生成パラメータを設定し、ランダム性を高めつつ日本語として破綻しないラインを狙いました。
+
+### ✅ 答え合わせの仕組み
+
+- **表記ゆれを網羅した正解判定**:
+  事前に想定される正解を、漢字・ひらがな・カタカナ・英語・略称など考えうる表記ゆれを含めて複数パターン用意し、いずれかに一致すれば正解と判定します。ただしユーザに提示する正解表示は代表的な1つのみとし、シンプルな体験を保っています。
+
+### 🔒 簡易的な不正対策
+
+- **答え取得までの時間制限**:
+  ログイン機能を実装しない構成の中で、ゲーム開始から一定時間（90秒）が経過するまでは答えを取得できないようにしました。APIを直接叩いて即座に答えを見るような行為を防ぐ、簡易的なセキュリティ対策として実装しています。
+
+### ⚠️ エラーハンドリング
+
+- **型によるエラー判定**:
+  エラーを独自の型として定義し、型によってエラーの種別を判定しています。文字列比較に頼らないため、エラーメッセージの変更に対応しやすくしました。Controller層ではエラー種別に応じて適切なHTTPステータスコード（400 / 403 / 404 / 500）を返し分けています。
 
 ---
 
@@ -84,44 +116,57 @@
   UIやUXのデザインの面で、工夫したこと、挑戦したことなどがあればおしえてください。
   板垣君or丹羽君
 -->
+
 ### 🏎️ ロード画面
-- **関西あるあるのランダム表示**: 
+
+- **関西あるあるのランダム表示**:
   APIからのデータ取得待ち時間を、関西にまつわる「あるあるネタ」を表示することで、ユーザーを飽きさせない工夫をしています。
 
 ### 🎮 ゲーム中
-- **チャット形式の直感的なUI**: 
+
+- **チャット形式の直感的なUI**:
   親しみやすいメッセージバブルを採用し、京都人と大阪人が交互にヒントを出す演出をアイコンの使い分けで表現しています。
-- **ヒントの自動配信とタイマー**: 
+- **ヒントの自動配信とタイマー**:
   一定時間ごとに新しいヒントが流れてくる臨場感を演出。タイマーにより次のヒントまでの時間を可視化しています。
-- **スマート自動スクロール**: 
+- **スマート自動スクロール**:
   新しいメッセージ追加時、画面下部にいる時のみ自動スクロール。過去のやり取りを見返している最中に勝手にスクロールされないよう配慮しました。
-- **自然なギブアップ誘導**: 
+- **自然なギブアップ誘導**:
   全てのヒントが出切った後、チャットの流れの中に「答えを見る？」というボタンを表示。ゲームの流れを止めずに次のアクションへ誘導します。
 
 ### ✨ 正解後の挙動
-- **物語の完全公開（アコーディオン）**: 
+
+- **物語の完全公開（アコーディオン）**:
   正解後、「物語の続きを見る」をクリックすることで、クイズ中に出てこなかった残りの会話を全て読むことができ、ストーリーを最後まで楽しめます。
-- **「茶しばき（お気に入り）」機能**: 
+- **「茶しばき（お気に入り）」機能**:
   面白かったヒントには、関西ならではの「茶しばき（お茶しに行こう）」という言葉でお気に入り登録が可能。心地よいハートのアニメーションで達成感を高めています。
-- **𝕏（Twitter）でのシェア**: 
+- **𝕏（Twitter）でのシェア**:
   クイズの結果や面白い会話を、𝕏（旧Twitter）ですぐにシェアできる機能を搭載しています。
-- **状況に応じたアイコンの変化**: 
+- **状況に応じたアイコンの変化**:
   正解なら「大阪」、不正解なら「京都」のアイコンを表示するなど、判定結果が視覚的に即座に伝わるよう工夫しました。
 
 ### 📑 高評価のストーリー
-- **チャット形式のカードプレビュー**: 
+
+- **チャット形式のカードプレビュー**:
   一覧画面（掲示板）では、各物語の冒頭部分をチャット形式のままプレビュー表示。クリックする前から内容の雰囲気が直感的に伝わるデザインにしました。
-- **「タップで回答確認」の段階的公開**: 
+- **「タップで回答確認」の段階的公開**:
   詳細画面では、あえて答えを最初から表示せず、ユーザーが自らタップして確認する仕様を採用。過去の良問を自分でも解いてみるという楽しみを残しています。
-- **没入感のあるフルスクリーン閲覧**: 
+- **没入感のあるフルスクリーン閲覧**:
+  余計な UI を排除し、会話の流れに集中できるレイアウトを採用。チャットアプリを使っているかのような感覚でストーリーを読み進められます。
+
+### 🎨 その他
+
+えて答えを最初から表示せず、ユーザーが自らタップして確認する仕様を採用。過去の良問を自分でも解いてみるという楽しみを残しています。
+
+- **没入感のあるフルスクリーン閲覧**:
   余計な UI を排除し、会話の流れに集中できるレイアウトを採用。チャットアプリを使っているかのような感覚でストーリーを読み進められます。
 
 ### 🎨 その他
-- **モバイルファーストのレスポンシブデザイン**: 
+
+- **モバイルファーストのレスポンシブデザイン**:
   スマートフォンでの操作をメインに想定しつつ、PCでも快適にプレイできる柔軟なレイアウトを実現しています。
-- **視覚的な導線設計**: 
+- **視覚的な導線設計**:
   「ゲームスタート」などの主要ボタンは目立つオレンジ色、サブボタンは白など、機能の重要度に応じたカラー設計を行っています。
-- **Material Designによる統一感**: 
+- **Material Designによる統一感**:
   一貫性のあるデザインシステム（MUI）を採用し、全体として清潔感とプレミアム感のある外観を実現しました。
 
 ---
@@ -133,10 +178,10 @@
   今後の展望があればおしえてください。
 -->
 
-  対戦機能を付けた方がユーザ同士でも楽しめる？
-  
+対戦機能を付けた方がユーザ同士でも楽しめる？
+
+---
 
---------------------------------
 <!-- この下は元から記入されていたもの
 上の分は今年の評価基準らしいので、基本的には上の部分を修正した方がいいと思う
  -->
@@ -145,20 +190,20 @@
 
 <!-- テーマ「関西をいい感じに」に対して、考案するプロダクトがどういった(Why)背景から思いついたのか、どのよう(What)な課題があり、どのよう(How)に解決するのかを入力してください -->
 
-
 ## プロダクト説明
 
 <!-- 開発したプロダクトの説明を入力してください -->
 
-
 ## 操作説明・デモ動画
+
 [デモ動画はこちら](https://www.youtube.com/watch?v=fbzGp0XJGq8)
-<!-- 開発したプロダクトの操作説明について入力してください。また、操作説明デモ動画があれば、埋め込みやリンクを記載してください -->
 
+<!-- 開発したプロダクトの操作説明について入力してください。また、操作説明デモ動画があれば、埋め込みやリンクを記載してください -->
 
 ## 注力したポイント
 
 <!-- 開発したプロダクトの中で、特に注力して作成した箇所・ポイントについて入力してください -->
+
 ### アイデア面
 
 ### デザイン面
@@ -172,8 +217,6 @@
 ### AWS構成図
 <img width="686" height="435" alt="image" src="https://github.com/user-attachments/assets/f7286ff6-ac04-488c-9a17-c0975677ab8e" />
 
-
-
 <!--
 markdownの記法はこちらを参照してください！
 https://docs.github.com/ja/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax