# メンバー管理 ヘルプ ## 概要 **メンバー管理** ページでは、施設に関わったすべてのゲスト（予約・フォーム提出・メンバーシップ加入のいずれかを行ったゲスト）を一元的に管理できます。名前・メールアドレスでの検索、フィルタリング、個人詳細の確認、社内メモ（備考）の記録、ブラックリスト管理が行えます。 --- ## 詳細機能 ## 機能1: メンバー一覧の表示・検索・フィルタリング サイドメニューの **メンバー** をクリックすると一覧が表示されます。 ### 検索 検索ボックスにメールアドレスまたは名前（部分一致）を入力すると、300ms のデバウンスを経て自動的に絞り込まれます。 ### フィルタ | フィルタ | 対象 | |----------|------| | すべて | 施設に関わったすべてのゲスト | | サブスク加入中 | 有効なメンバーシップを持つゲスト | | サブスク承認待ち | スタッフによる承認待ちのメンバーシップ申請があるゲスト — 申請先払いフロー（まだ未決済）での申請者と、手動審査が必要な有料プランの申請者が対象 | | 予約承認待ち | 承認待ちの予約があるゲスト | | フォーム提出のみ | フォームだけ提出したゲスト（予約・サブスクなし） | | 予約のみ | 予約履歴があるゲスト（サブスクなし） | | 直近30日 | 直近30日以内に何らかのインタラクションがあったゲスト | ### 一覧カードの表示内容 各ゲストのカードには以下が表示されます。 | 項目 | 説明 | |------|------| | アバター | メールアドレスを基にした固定グラデーション＋イニシャル | | 名前 | 正式名（スタッフ設定）> 通称（ゲスト自己入力）> メール の優先順 | | バッジ | サブスク中（緑）/ サブスク承認待ち（紫・時計）/ 予約承認待ち（オレンジ・時計） | | 予約数 | 当施設での累計予約件数 | | フォーム数 | 提出済みフォーム件数 | | 電話番号・国籍 | 登録されている場合に表示 | | 最終利用日 | 直近のインタラクション日付（画面右端） | ### ページネーション デフォルトは1ページ50件表示です。総件数が50件を超えると「前へ」「次へ」ボタンとページ番号が表示されます。 ## 機能2: メンバー詳細の確認 一覧のカードをクリックすると、そのメンバーの詳細ページ（`/members/:identityId`）が開きます。 ### ヘッダーカード | 項目 | 説明 | |------|------| | アバター | 一覧と同じグラデーション・イニシャルで同一人物を識別 | | 正式名 / 通称 | 正式名がある場合はメイン表示、通称は副表示 | | メールアドレス | ゲストのメールアドレス | | 電話・国籍・言語 | 登録済みの属性 | | ブラックリスト状態 | 禁止中の場合は赤いバッジで表示 | | IDハッシュ | `#` 始まりの8桁識別子（右上） | ### KPI ストリップ（ヘッダー下部） | 指標 | 説明 | |------|------| | 生涯ご利用金額 | 予約＋チェックイン＋サブスクの合計（売掛含む） | | 初回ご利用日 | 当施設での最初のインタラクション日 | | メンバー年数 | 初回利用からの経過年・月数 | ### ポータルタイル（カウント＋リンク） 詳細ページ中段に4つのタイルが表示され、各カテゴリの件数と他ページへのリンクが確認できます。 | タイル | リンク先 | |--------|----------| | チェックイン | チェックイン履歴ページ（メールフィルタ適用済み） | | 予約 | チェックイン履歴ページ（予約フィルタ適用済み） | | フォーム | フォームページ（このメンバーで絞り込み済み） | | サブスク | チェックイン履歴（サブスクフィルタ）／サブスク管理ページ — サブスク管理ページでは、申請先払いフローで提出された申請の承認・却下が行えます | > **なぜリンクで遷移するのか？** 各詳細一覧（チェックイン履歴・フォーム・メンバーシップ）はそれぞれのページが情報源です。詳細ページで再度一覧を表示するのではなく、既存の詳細ページに絞り込み済みで遷移することで二重管理を防いでいます。 ## 機能3: 正式名（社内用）の編集 ゲストが自己入力した通称とは別に、スタッフが「正式名」を設定できます。正式名はゲストには表示されません。 ### 設定手順 1. メンバー詳細ページを開く 2. 名前の横にある鉛筆アイコンをクリック 3. 正式名を入力（例: 田中 太郎） 4. **保存** をクリック（または Enter キー） - 空欄で保存すると正式名が削除され、通称がメイン表示に戻ります。 - Escape キーでキャンセルできます。 ## 機能4: 社内向け備考（スタッフメモ） メンバー詳細ページの下部に「社内向け備考」セクションがあります。スタッフが残したメモをチャットバブル形式のタイムラインで確認・追加できます。 ### 備考の追加 1. テキストエリアにメモを入力（最大4,000文字） 2. **追加** ボタンをクリック メモは追加した本人のイニシャルと投稿日時が表示されます。新しいメモほど上部に表示されます。 ### 備考の削除 自分が追加したメモのみ削除できます。メモにカーソルを当てると × ボタンが表示され、クリック後に確認メッセージが出ます。 > **注意**: 備考はゲストには一切表示されません。また、削除は取り消しできません。 ## 機能5: ブラックリスト管理 ブラックリストに追加すると、そのゲストはメンバーシップ申請・予約・チェックインのすべてを遮断されます。 ### ブラックリストへの追加 1. メンバー詳細ページで「ブラックリストに追加」ボタンをクリック 2. 理由を入力（必須） 3. 適用範囲を選択: | 範囲 | 効果 | |------|------| | この施設のみ | 当施設でのみ遮断 | | 組織全体 | 同じ組織配下のすべての施設で遮断 | 4. **ブラックリストに追加** ボタンをクリック ### ブラックリストの解除 ヘッダーカードの赤いバッジ内にある **解除** リンクをクリックすると、即座に解除されます。 ### ブラックリスト一覧タブ メンバーページの「ブラックリスト」タブでは、施設・組織ごとに登録されているブラックリストの一覧を確認できます。 --- ## ゲスト自身のプロフィール編集 会員アプリ（`member.unlockos.io`）のマイページでは、ゲスト自身が以下のプロフィール項目を編集できます。 | 項目 | 説明 | |------|------| | 名前（通称） | ゲストが自己入力する名前 | | 電話番号 | 連絡先電話番号 | | 住所 | 住所 | | 国籍 | 国籍 | 「編集」ボタンをクリックするとモーダルが開き、変更したフィールドのみ送信されます。 --- ## よくある質問 ### Q: メンバーはいつ一覧に追加されますか？ 予約・フォーム提出・メンバーシップ申請のいずれかが行われると、対象ゲストのプロフィールが施設のメンバー一覧に表示されます。 ### Q: 正式名はゲストに見えますか？ いいえ。正式名（`display_name`）はスタッフ専用の内部フィールドです。ゲスト向けアプリには一切表示されません。 ### Q: 備考はスタッフ全員が見られますか？ はい。備考は施設に所属するすべてのスタッフから閲覧できます。削除は記載したスタッフ本人のみ可能です。 ### Q: ブラックリストの理由はゲストに通知されますか？ いいえ。理由はスタッフ管理画面にのみ表示されます。ゲストには通知されません。 ### Q: 組織全体ブラックリストと施設のみの違いは？ - **この施設のみ**: 他施設では通常通り利用できます - **組織全体**: 同じ組織に紐づくすべての施設で遮断されます --- ## 関連ページ - [チェックイン履歴](checkin-history.md) - [フォーム管理](forms.md) - [メンバーシップ管理](membership-plans.md) - [ブラックリスト管理](blacklist.md)