SPFamily 操作マニュアル

1. はじめに

1.1 アプリの概要

SPFamilyは、サピックス（SAPIX）中学受験塾に通うご家庭のための学習補助アプリです。
※本アプリはサピックスとは一切関係のない非公式アプリです。

お子様の学習進捗を柔軟に管理でき、毎日の「やること」を親子で一目で確認できます。
お子様がそばにいなくても、学習状況を随時把握できます。学習が完了すると、保護者へ確認依頼状態に移す。
サピックスの学習単元を一部あらかじめ登録済み。追加・編集も簡単に行えます。

学習時間の集計機能により、科目や単元ごとの過不足を確認できます。
復習を重点的にサポートします。問題を撮影して登録でき、やり直し日を設定することができます。

1.2 画面の基本構成

ログイン後、画面下部に 4つのタブ が表示されます。

タブ	名称	内容
学習	学習	今日の予定・学習タスクの一覧と学習開始
予定	予定	予定・タスクの一覧と追加・編集
集計	集計	学習時間などの集計・グラフ
設定	設定	同期・アカウント・権限・区分管理

各タブをタップすると、その機能の画面に切り替わります。戻る場合は画面上部の「←」ボタンを使います。

2. ログイン・新規登録

2.1 ログイン

アプリを起動すると ログイン画面 が表示されます。
メールアドレス と パスワード を入力します。
「ログイン」 をタップします。
初回ログイン時は「データを同期しています…」と表示され、自動で同期が行われます。
同期が終わると 学習タブの画面（ホーム） に切り替わります。

パスワードを忘れた場合

ログイン画面の 「パスワードをお忘れの方」 をタップし、表示される手順に従ってパスワードを再設定してください。

2.2 新規登録

ログイン画面で 「新規登録」 をタップします。
必要に応じて プライバシーポリシーへの同意 を行います。
メールアドレス と パスワード などを入力し、登録を完了します。
メール認証が必要な場合は、届いたメールの案内に従って認証してください。

3. 学習タブ（ホーム）

学習タブでは、今日の予定や学習タスク を確認し、学習を開始 できます。

3.1 主な操作

日付の選択: カレンダーや日付選択で、表示する日を変更できます。
お子様の選択: 複数アカウントがある場合、表示するお子様を切り替えられます。
科目フィルタ: 全科目・算数・理科・国語・社会などで表示を絞り込めます。
予定カード: その日の予定（タスク）がカードで一覧表示されます。
学習開始: 予定やタスクから 「学習開始」 をタップすると、学習画面（ステップ詳細）に進み、学習時間の記録や「できてない問題」の画像追加ができます。

3.2 学習画面（ステップ詳細）での操作

学習時間: 学習開始・終了や時間の記録ができます。
できてない問題の画像: カメラ撮影やアルバムから画像を追加し、学習に紐づけて保管できます。
画像は後から 画像プレビュー で編集（明るくする・切り取り・回転・印刷・保存・削除）できます。

4. 予定タブ

予定タブでは、予定・タスクの一覧 を確認し、予定表 へ移動したり、タスクの詳細 を表示したりできます。

4.1 主な操作

一覧表示: 予定（タスク）が一覧で表示されます。フィルタで科目・分類・優先度などを絞り込めます。
予定表: 予定表ボタンから カレンダー形式の予定表 画面に遷移できます。
タスク詳細: タスクをタップすると タスク詳細画面 で内容を確認・編集できます。
タスク表示: タスクをタップして 「表示」 などから、タスクの詳細表示（TodoDetail / タスク表示）に進めます。ここでは添付された画像・動画・録音の閲覧もできます。

5. 集計タブ

集計タブでは、学習時間などの集計 や グラフ を確認できます。

お子様ごと・科目ごと・期間ごとの集計が表示されます。
画面の案内に従って期間や対象を選択してご利用ください。

6. 設定タブ

設定タブでは、同期・アカウント・権限・区分管理 などを行います。

6.1 同期

「同期」 ボタンで、サーバーとデータを手動で同期できます。
アプリはバックグラウンドでも定期的に同期を試みます。
同期に失敗した場合はエラーメッセージが表示されます。通信環境を確認してから再度「同期」をタップしてください。

6.2 アカウント・ユーザー

アカウント一覧: 同じ「世帯」内のユーザー（お子様など）の一覧が表示されます。
ユーザー追加・編集: 新規登録や編集画面から、ユーザー情報（名前・学年・クラスなど）を設定できます。
ログアウト: 設定画面からログアウトできます。

6.3 権限・区分管理

権限設定: ロール（役割）に応じた権限の確認・変更ができます（権限がある場合）。
区分管理: 分類・科目・優先度などのマスタ（区分）を管理できます（権限がある場合）。
フロー設定: 処理フローに関する設定がある場合、ここから遷移できます。

6.4 その他

QRコード表示: 連携用のQRコードを表示する機能がある場合、ここから開けます。
学習時間照会: 学習時間の一覧・編集画面へ遷移できます。

7. 画像の追加・編集・保存（画像プレビュー）

学習画面などで 「できてない問題」 として追加した画像は、画像プレビュー画面 で編集・印刷・保存・削除できます。

7.1 画像プレビュー画面の開き方

学習画面（ステップ詳細）で、追加済みの画像をタップするなどして 画像プレビュー を開きます。

7.2 編集ボタン（アイコンのみ）

画面下部にアイコンボタンが並んでいます。

アイコン	機能	説明
白くする（太陽）	明るくする	画像を明るく補正します。通信が必要です。
切り取り（クロップ）	切り取り	タップ後、画面上でドラッグして範囲を指定すると、その範囲で切り取られます。
左回転	左に90°回転	画像を左に90度回転させます。
右回転	右に90°回転	画像を右に90度回転させます。
印刷	印刷	画像を印刷用に出力し、共有や印刷を行います。
削除（ゴミ箱）	削除	画像を削除します。確認ダイアログが表示されます。
保存（フロッピー）	保存（確定）	編集内容を確定し、新しい画像として保存します。元の画像は論理削除され、新規リソースとして紐付けが引き継がれます。

7.3 編集の流れ

明るくする: 「白くする」をタップすると、サーバーで補正された画像に差し替わります。通信エラー時は「ネットワーク接続を確認してください」と表示されます。
切り取り: 「切り取り」をタップ → 画面上でドラッグして四角形の範囲を指定 → 指を離すとその範囲で切り取りが実行され、プレビューが切り取った画像に更新されます。
回転: 「左回転」または「右回転」をタップすると、画像が回転し、保存先が更新されます。
戻る: 画面左上の戻るボタンを押すと、「編集を破棄しますか？」 と確認されます。破棄を選ぶと編集は破棄され、元の画像の参照に戻ります。
保存（確定）: 編集を確定する場合は 「保存」 をタップします。新しい画像ファイルとして保存され、学習・予定との紐付けが引き継がれます。元の画像ファイルは削除され、元のリソースは論理削除されます。

7.4 注意事項（画像）

明るくする はサーバー処理のため、通信ができる環境でご利用ください。
Android では、画像のアップロードや明るさ補正に別方式（JSON送信）を使用しているため、初回表示で「準備中」と出ることがあります。同期が完了すると表示されます。

8. データ同期について

8.1 自動同期

ログイン中は、バックグラウンドで定期的にサーバーと同期が行われます。
画像や予定・学習データは、同期が成功すると 他の端末でも見られる ようになります。

8.2 手動同期

設定タブ の 「同期」 ボタンで、いつでも手動で同期を実行できます。
オフラインで編集した内容は、通信が復旧してから同期するとサーバーに反映されます。

8.3 画像と同期

画像を追加・編集して 保存（確定） すると、その内容はローカルに保存され、次の同期でサーバーにアップロードされます。
アップロードに失敗した画像は、同期データには含めず、次回の同期で再アップロードが試行されます。
他端末で「準備中」と表示される場合は、同期がまだ完了していないか、別サーバーインスタンスでファイルがまだない場合があります。時間をおくか、再度同期してください。

9. トラブルシューティング

9.1 ログインできない

メールアドレス・パスワードに誤りがないか確認してください。
通信（Wi‑Fi・モバイルデータ）が有効か確認してください。
パスワードを忘れた場合は「パスワードをお忘れの方」から再設定してください。

9.2 データが反映されない・古いまま

設定タブで 「同期」 をタップし、手動で同期を実行してみてください。
通信環境が悪い場合は、接続が良くなってから再度同期してください。

9.3 画像が表示されない・「準備中」のまま

同期が完了するまで少し待ってから、画面を再度開くか、同期を実行してください。
画像の「明るくする」でエラーになる場合は、ネットワーク接続を確認してください。

9.4 デバッグ時のAPIサーバー指定

開発・デバッグ時は、アプリは デバッグ用のAPIサーバーURL（例: http://192.168.0.200:8000）を使用するように設定できます。詳細は client/src/config/index.ts および client/.env.example を参照してください。

10. 改訂履歴

日付	内容
2026-02-14	初版作成（画面構成・ログイン・各タブ・画像編集・同期・トラブルシューティング）

本マニュアルは、SPFamily アプリの一般的な操作を説明するものです。実際の画面や文言はバージョンにより異なる場合があります。

アプリ概要