> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learningwith.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# はじめての利用ガイド

> アカウント作成から最初のクイズまでの手順

## アカウント作成

<Steps>
  <Step title="サインアップページへアクセス">
    アプリのトップページから「サインアップ」をクリック
  </Step>

  <Step title="メールアドレスを入力">
    メールアドレスとパスワードを入力して登録
  </Step>

  <Step title="メール認証">
    登録したメールアドレスに届く確認メールのリンクをクリック
  </Step>

  <Step title="プロフィール設定">
    表示名とアイコンを設定（後から変更可能）
  </Step>
</Steps>

## ルームに参加する

友達から招待コードを受け取っている場合:

<Steps>
  <Step title="ダッシュボードから「ルームに参加」をクリック" />

  <Step title="招待コードを入力">
    友達から共有された6文字のコードを入力
  </Step>

  <Step title="参加完了">
    ルーム詳細画面が表示されます
  </Step>
</Steps>

## ルームを作成する

自分でルームを作成して友達を招待する場合:

<Steps>
  <Step title="ダッシュボードから「ルームを作成」をクリック" />

  <Step title="ルーム名を入力">
    例: 「英語テスト対策」「数学勉強会」
  </Step>

  <Step title="招待コードを共有">
    作成後に表示される招待コードを友達に共有
  </Step>
</Steps>

## クイックスタートでクイズを始める

ダッシュボードの **Quick Start** カードから、ワンクリックですぐにクイズを始められます。

<Steps>
  <Step title="ダッシュボードの Quick Start カードを確認">
    参加しているルームがある場合、ダッシュボード上部に Quick Start カードが表示されます。
  </Step>

  <Step title="ルームを選択して「開始」をクリック">
    複数のルームに参加している場合は、ドロップダウンから対象のルームを選択します。
  </Step>

  <Step title="クイズが自動生成されます">
    過去に間違えた問題を優先して出題します。既存の問題がない場合は AI が新しく作成します。
  </Step>
</Steps>

<Info>
  Quick Start は復習に最適です。苦手な問題を繰り返し解くことで、効率的に学力を伸ばせます。
</Info>

## 最初のクイズを解く

ルーム詳細画面からクイズの内容をカスタマイズして始めることもできます。

<Steps>
  <Step title="ルーム詳細画面でクイズを開始">
    「クイズを始める」ボタンをクリック
  </Step>

  <Step title="科目と範囲を設定">
    * **科目**: 英語、数学、理科など
    * **トピック**: 具体的な範囲（例: 関係代名詞、微分）
    * **問題数**: 3〜10問
  </Step>

  <Step title="問題に回答">
    AIが生成した問題に順番に回答
  </Step>

  <Step title="結果を確認">
    正答率、解説、メンバーとの比較を確認
  </Step>
</Steps>

<Info>
  クイズはAIがリアルタイムで生成するため、毎回異なる問題が出題されます。
</Info>

## 対戦モードで勝負する

ルームメンバーとリアルタイムで対戦できます。

<Steps>
  <Step title="ルーム詳細画面でオンラインメンバーを確認">
    現在オンラインのメンバーが表示されます。
  </Step>

  <Step title="対戦相手を選んで挑戦">
    オンラインメンバーの横にある挑戦ボタンをクリックし、科目・トピック・問題数・難易度を設定して対戦リクエストを送ります。
  </Step>

  <Step title="相手が応答するのを待つ">
    相手に通知が届きます。制限時間内に「受ける!」を選んでもらうと対戦が開始されます。
  </Step>

  <Step title="同じ問題を解いて結果を比較">
    対戦モードでは、両者が同じ問題セットに取り組みます。結果画面で正答数や回答スピードを比較できます。
  </Step>
</Steps>

<Warning>
  対戦リクエストには制限時間があります。相手が時間内に応答しなかった場合、リクエストは自動的に期限切れになります。
</Warning>

## Guardian（見守り）ロールで参加する

保護者や先生など、学習者の進捗を見守りたい方向けのロールです。

### Guardian ロールの設定

ルームのオーナー（作成者）が、メンバーのロールを「見守り役」に変更できます。

<Steps>
  <Step title="ルーム詳細画面の「Role Management」セクションを確認">
    ルームオーナーのみ、メンバーのロール管理セクションが表示されます。
  </Step>

  <Step title="対象メンバーのロールを「見守り役」に変更">
    ドロップダウンから「見守り役」を選択します。
  </Step>
</Steps>

### Guardian ビューでできること

Guardian ロールのメンバーには、ルーム詳細画面に専用の **Guardian View** が表示されます。

<CardGroup cols={2}>
  <Card title="学習状況の概要" icon="chart-pie">
    正答率、回答数、連続学習日数、最長記録を一目で確認
  </Card>

  <Card title="科目別成績" icon="book">
    科目ごとの正答率をグラフで把握
  </Card>

  <Card title="苦手分野の把握" icon="target">
    正答率が低いトピックをチェック
  </Card>

  <Card title="AI 分析レポート" icon="robot">
    AI が作成した日々の学習分析レポートを閲覧
  </Card>
</CardGroup>

<Info>
  Guardian ロールはクイズの内容には参加せず、学習者の進捗データの閲覧に特化しています。複数の学習者を切り替えて確認できます。
</Info>

## 次のステップ

* [クイズ機能の詳細](/guide/quiz-features) - 問題形式や解説の見方
* [ストリーク・ランキング](/guide/streak-ranking) - 継続学習のモチベーション機能
