[BE-README] 書き方統一

Author: yone-al

README.md

@@ -79,31 +79,34 @@
 
 ## バックエンド
 
-### 3層アーキテクチャ（Controller / Service / Repository）
+### 🏗️ 3層アーキテクチャ（Controller / Service / Repository）
 
-責務を明確に分離し、各層をインターフェースで接続することで依存性を注入（DI）している。
+- **責務の分離とDI**:
+  各層の責務を明確に分離し、インターフェースで接続することで依存性を注入（DI）しています。Controller層はHTTPリクエストの受付・レスポンス返却、Service層はビジネスロジック、Repository層はDBアクセスを担当しています。
 
-- **Controller層**：HTTPリクエストの受付・バリデーション・レスポンス返却
-- **Service層**：ビジネスロジック（Gemini呼び出し、答え合わせ、ブックマーク管理など）
-- **Repository層**：GORM を用いたDBアクセス
+### 🤖 Gemini API 連携
 
-### Gemini API 連携
+- **プロンプト調整**:
+  京都人と大阪人のキャラ付け、前半→中盤→終盤で難易度が段階的に下がるヒント構成など、クイズとして成立するよう細かく指示を設計しました。
+- **JSON構造化出力**:
+  レスポンスのMIMEタイプとJSONスキーマを指定することで、Gemini の出力を確実にパース可能な JSON 形式に制約しています。
+- **生成パラメータの調整**:
+  毎回異なるお題・会話が生成されやすいように生成パラメータを設定し、ランダム性を高めつつ日本語として破綻しないラインを狙いました。
 
-- **プロンプト調整**：京都人と大阪人のキャラ付け、前半→中盤→終盤で難易度が段階的に下がるヒント構成など、クイズとして成立するよう細かく指示を設計した。
-- **JSON構造化出力**：レスポンスのMIMEタイプとJSONスキーマを指定することで、Gemini の出力を確実にパース可能な JSON 形式に制約している。
-- **生成パラメータの調整**：毎回異なるお題・会話が生成されやすいように生成パラメータを設定し、ランダム性を高めつつ日本語として破綻しないラインを狙った。
+### ✅ 答え合わせの仕組み
 
-### 答え合わせの仕組み
+- **表記ゆれを網羅した正解判定**:
+  事前に想定される正解を、漢字・ひらがな・カタカナ・英語・略称など考えうる表記ゆれを含めて複数パターン用意し、いずれかに一致すれば正解と判定します。ただしユーザに提示する正解表示は代表的な1つのみとし、シンプルな体験を保っています。
 
-事前に想定される正解を、漢字・ひらがな・カタカナ・英語・略称など考えうる表記ゆれを含めて複数パターン用意し、いずれかに一致すれば正解と判定する。ただしユーザに提示する正解表示は代表的な1つのみとしている。比較には大文字小文字を無視する。
+### 🔒 簡易的な不正対策
 
-### 簡易的な不正対策
+- **答え取得までの時間制限**:
+  ログイン機能を実装しない構成の中で、ゲーム開始から一定時間（90秒）が経過するまでは答えを取得できないようにしました。APIを直接叩いて即座に答えを見るような行為を防ぐ、簡易的なセキュリティ対策として実装しています。
 
-ログイン機能を実装しない構成の中で、ゲーム開始から一定時間（90秒）が経過するまでは答えを取得できないようにした。APIを直接叩いて即座に答えを見るような行為を防ぐ、簡易的なセキュリティ対策として実装している。
+### ⚠️ エラーハンドリング
 
-### エラーハンドリング
-
-エラーを独自の型として定義し、型によってエラーの種別を判定している。文字列比較に頼らないため、エラーメッセージの変更に対応しやすくした。Controller層ではエラー種別に応じて適切なHTTPステータスコード（400 / 403 / 404 / 500）を返し分けている。
+- **型によるエラー判定**:
+  エラーを独自の型として定義し、型によってエラーの種別を判定しています。文字列比較に頼らないため、エラーメッセージの変更に対応しやすくしました。Controller層ではエラー種別に応じて適切なHTTPステータスコード（400 / 403 / 404 / 500）を返し分けています。
 
 ---