# 居住者向け置き配サービス ヘルプ ## 概要 居住者向け置き配サービス（resident.unlockos.io）は、マンション・集合住宅にお住まいの方が不在時でも安全に荷物を受け取るための仕組みです。 **サービスの流れ:** 1. QRコードをスキャンして部屋を登録する 2. 荷物の配達伝票番号をアプリに事前登録する 3. 配達員が伝票番号でエントランスを解錠して荷物を届ける 4. 配達完了の履歴を確認する > このアプリは居住者向けです。管理者向けの操作については「[置き配管理](okihai-manager.md)」ヘルプをご覧ください。 --- ## 居住者登録の方法（/register） はじめてご利用になる場合は、管理者から受け取ったQRコードまたはURLから登録を行います。登録URLは `resident.unlockos.io/{施設スラッグ}/register?room=...` の形式です。 ### 登録の手順 1. 部屋のポストやドアに貼付されているQRコードをスマートフォンのカメラで読み取ります - または、管理者からメール等で受け取った登録URLを直接開きます 2. 登録ページが開くと、登録対象の部屋名が画面上部に大きく表示されます。正しい部屋であることを確認してください 3. **お名前**（例: 山田 太郎）と**メールアドレス**を入力し、「認証コードを送信」をタップします 4. 入力したメールアドレスに6桁の認証コードが届きます 5. 画面に表示された6つの入力欄にコードを1桁ずつ入力します（コピー貼り付けも可能） 6. 「認証する」をタップすると部屋への登録が完了し、ダッシュボード（ホーム画面）に自動で移動します ### 登録時の注意事項 - 1部屋に登録できる居住者は1名です。既に別の方が登録済みの場合はエラーが表示されます - 登録リンクには施設スラッグと部屋IDが含まれています。管理者から受け取ったリンク以外では新規登録はできません - 認証コードのメールが届かない場合は迷惑メールフォルダをご確認ください - 認証コードを受け取れなかった場合は「再送する」をタップして再送できます --- ## UnlockPass ログインや新規登録の際、以下のUnlockPassの表示が現れることがあります： | 表示場所 | 内容 | |----------|------| | ログイン・登録画面 | 入力欄の上に「UnlockPass」ロゴ | | 認証完了直後 | 「UnlockPassで認証しました」のトースト通知（3秒間表示） | | マイページのメール欄 | 「UnlockPassで認証済み」のツールチップ | **UnlockPass** は、UnlockOS を利用するすべての施設で共通して使えるメール認証の仕組みです。一度メール認証を完了すると、次回以降はどの UnlockOS 施設でも自動的に認識され、情報を入力し直す必要がありません。 > UnlockPass は自動的に有効になります。特別な登録操作は不要です。 --- ## 再ログインの方法（返宅後・ブラウザ変更時） 一度登録が完了した居住者は、QRコードを使わずに直接 **resident.unlockos.io** にアクセスしてログインできます。 ### ログインの手順 1. ブラウザで resident.unlockos.io を開きます 2. メールアドレスを入力し、「認証コードを送信」をタップします 3. 届いた6桁のコードを入力して「認証する」をタップします 4. ログイン完了後、ホーム画面に自動で移動します ### 登録済みの方がQRコードを再スキャンした場合 すでに部屋に登録済みの状態でQRコードを再スキャンすると、再登録フォームは表示されず、**自動的にホーム画面に移動**します。名前の再入力やOTP認証は不要です。 > この動作はセッションが有効な場合に適用されます。セッションが切れている場合（ログアウト後など）は通常のログイン手順が必要です。 --- ## セッションの維持とログインが切れた場合の対処 ### セッションの仕組み アプリのセッション（ログイン状態）は、強制リロードやPWAの再起動をまたいで自動的に復元されます。アプリを閉じて再び開いても、通常はログイン状態が維持されます。 **重要:** セッションが切れても、**部屋の登録情報（登録した氏名・部屋・伝票番号など）は消えません。** セッション（ログイン認証）と登録データは別々に管理されています。セッションが切れた場合は、再ログインするだけで元の状態に戻ります。 ### セッションが切れる主な原因 - Supabaseの認証トークンの有効期限切れ（長期間アクセスがなかった場合） - プライベートブラウジングモードの使用（セッションが保存されないため） - ブラウザのキャッシュ・Cookieを手動で削除した場合 - 明示的にログアウトした場合 ### ログインが切れた場合の再ログイン手順 セッションが切れてログイン画面が表示されると、以下の動作が起きます。 - **「おかえりなさい」メッセージが表示される** — 以前にログインしたことのある方には、「おかえりなさい。再度ログインしてください。」というメッセージが表示されます - **メールアドレスが自動入力される** — 前回ログイン時のメールアドレスが入力欄に事前入力されているため、確認または修正してすぐに認証コードを送信できます 再ログインの手順: 1. ログイン画面が表示されたら、メールアドレスが自動入力されていることを確認します（必要に応じて修正） 2. 「認証コードを送信」をタップします 3. 届いた6桁のコードを入力して「認証する」をタップします 4. ホーム画面に自動で移動します。登録済みの伝票番号や履歴はそのまま残っています --- ## ヘッダー ログイン後、画面上部のヘッダーには以下が表示されます。 - **施設名**（小さい文字、上段）— 登録している施設の名称 - **居住者サービス**（太字、下段）— アプリのタイトル - **ヘルプボタン**（? アイコン）— 地球儀アイコンの左隣にあります。タップするとこの操作ガイドがいつでも開きます。ホーム・置き配・履歴・マイページの各ページや登録画面でも、見出しの横に同じ ? アイコンが表示されます - **言語切替ボタン**（地球儀アイコン）— タップすると表示言語を切り替えられます - **ログアウトボタン** — タップするとログアウト確認ダイアログが表示されます。「ログアウト」で確定、「キャンセル」でアプリに戻ります --- ## ボトムナビゲーション ログイン後の画面下部には4つのタブが表示されます。 | タブ | ページ | 内容 | |------|--------|------| | ホーム | `/` | ダッシュボード（部屋情報・クイック操作） | | 置き配 | `/slips` | 伝票番号の登録・管理 | | 履歴 | `/history` | 配達履歴の確認 | | マイページ | `/mypage` | アカウント情報・退去手続き | --- ## ホーム画面（/） ログイン後のホーム画面では、以下の情報と操作が利用できます。 ### 表示される情報 | 項目 | 内容 | |------|------| | 施設名 | 居住している施設の名称 | | 部屋番号 | 登録している部屋の番号 | | 登録中の伝票数 | 現在アクティブな伝票番号の件数 | | 最近の配達 | 直近5件の配達履歴 | ### クイック操作 - **伝票番号を登録** — 伝票管理ページに移動して新しい伝票番号を登録します - **配達履歴** — 配達履歴ページに移動して過去の配達記録を確認します > ホーム画面のクイック操作ボタンは、お使いの施設のURLに合わせた正しいページに移動します。 --- ## 伝票番号の登録・管理（/slips） 配達伝票番号を事前に登録することで、配達員がエントランスを解錠できるようになります。 ### 伝票番号を登録する 1. ボトムナビの「置き配」をタップして伝票管理ページを開きます 2. 「伝票番号」欄に配達伝票番号を入力します - 入力例: `1234-5678-9012` - 英数字とハイフンが使用できます - **伝票番号に含まれる数字が十分な桁数である必要があります**（桁数が不足している場合は「この伝票は登録できません。」と表示されます） 3. 「運送会社」を選択します - ヤマト運輸 / 佐川急便 / 日本郵便 / Amazon / その他 4. 到着予定日を設定します - カレンダーから到着予定の日付を選択します - さらに「1日間」「2日間」「3日間」のボタンで有効期間を追加します（例: 3月28日を選択して「2日間」なら3月30日まで有効） 5. 「登録する」ボタンをタップします ### 伝票番号のバリデーション 伝票番号には十分な桁数の数字が含まれている必要があります。これは、伝票番号の数字部分がエントランスPINの生成に使用されるためです。 - 桁数が不足している場合は「この伝票は登録できません。」と表示されます - 「登録する」ボタンは有効な伝票番号が入力されるまで無効（グレーアウト）のままです ### 登録済み伝票の確認と削除 - 登録した伝票番号は一覧で表示されます（伝票番号・運送会社・有効期限） - 不要になった伝票は右側の「削除」ボタンをタップして削除できます - 削除確認ダイアログが表示されるので「OK」をタップして完了です --- ## 配達の流れ（伝票登録から配達完了まで） 1. **居住者が伝票番号を登録する** — 注文後に伝票番号と到着予定日をアプリに登録します 2. **入館用PINが自動で発行される** — 登録した伝票番号の**末尾6桁**が、配達期間中だけ有効なエントランス解錠PINとして自動的にKEYVOXへ登録されます 3. **配達員が施設に到着する** — 荷物に貼付された伝票番号の末尾6桁をエントランスのキーパッドに入力して解錠します 4. **荷物が届く** — 配達員が荷物を指定の場所に置き配します 5. **配達履歴に記録される** — エントランスが解錠されると、居住者のアプリの配達履歴に配達完了が記録されます > 入館用PINは伝票登録時に指定した有効期限まで使えます。期限を過ぎたPINは自動的に無効になります。 --- ## 配達履歴の確認（/history） 過去に行われた配達の記録を確認できます。 ボトムナビの「履歴」をタップすると履歴ページが開きます。 ### 表示される情報 | 項目 | 内容 | |------|------| | 日時 | イベントが発生した日時（配達確認済みの場合はその時刻、それ以外は認証時刻）。**施設が設定しているタイムゾーン**で表示されます（例: Asia/Tokyo） | | 伝票番号 | 使用された配達伝票番号 | | 運送会社 | ヤマト運輸・佐川急便・日本郵便・Amazon・その他 | | ステータス | 以下の5種類のいずれか | ### 配達ステータスの種類 各履歴には、色分けされたアイコンとステータスバッジが表示されます。 | ステータス | アイコン | 色 | 意味 | |-----------|---------|-----|------| | 配達完了 | 荷物 | 緑 | 配達員が伝票番号で認証しエントランスを解錠した | | 配達確認済み | チェックマーク | 緑 | KEYVOXロックセンサーにより配達が自動確認された（荷物が置かれドアが閉まったことを検知） | | 配達推定 | 荷物 | 黄 | 同日・同施設の別の伝票のPINで解錠が行われたため、この荷物も同時に配達された可能性がある | | キャンセル済み | ゴミ箱 | グレー | 配達前に伝票番号がキャンセルされた | | 期限切れ | 時計 | 赤 | 伝票番号が使用されないまま有効期限を過ぎた | > **補足:** 「配達確認済み」ステータスは、建物のKEYVOXスマートロックが配達用ドアの開閉を検知したときに自動的に設定されます。居住者が操作する必要はなく、システムが自動でステータスを更新します。 > **配達推定について:** 配達員が1枚の伝票番号のPINを使ってエントランスを解錠した際、同日・同施設にアクティブな他の伝票も同時に配達された可能性があります。このような伝票には「配達推定」ステータスが自動的に付与されます。後日、配達会社のWebhookで正式な配達確認が届いた場合は「配達確認済み」に自動アップグレードされます。 --- ## マイページ（/mypage） ボトムナビの「マイページ」をタップするとアカウント情報ページが開きます。 ### 表示される情報 | 項目 | 内容 | |------|------| | メールアドレス | ログイン中のメールアドレス | | 名前 | 登録時に入力した名前（編集可能） | | 施設名 | 居住している施設の名称 | | 部屋名 | 登録している部屋の名称 | | 登録日時 | 部屋に登録した日時 | ### 名前を変更する 1. 名前の横に表示されている鉛筆アイコン（✏️）をタップします 2. 名前の入力欄が編集可能になります 3. 新しい名前を入力して「保存」をタップします 4. 「✕」をタップするとキャンセルできます ### 退去手続き 部屋の登録を解除する際は、マイページの「退去する」ボタンをタップします。 **退去の手順:** 1. 「退去する」ボタン（画面下部のカプセル型ボタン）をタップします 2. 確認モーダルが表示されます。内容をよく読んでください - 登録済みの伝票番号がすべて無効になります - 再度この部屋に入居する場合は、管理者の承認が必要です 3. 退去を確定する場合は「退去する」（赤いボタン）をタップします 4. キャンセルする場合は「キャンセル」をタップします 5. 退去が完了するとログアウトされ、登録ページに移動します > **注意:** 退去処理後に同じ部屋へ再登録するには、管理者がその部屋の登録リセットを行う必要があります。退去前に管理者にご連絡ください。 --- ## 家族メンバー 1部屋に複数の居住者を登録できます。最初に部屋を登録した方（世帯主）が、最大5名の家族メンバーを招待できます。各家族メンバーは独自のログインを持ち、部屋の配達伝票やロッカー割り当てを共有しながら、自分の伝票を管理できます。 ### 家族メンバーを招待する 1. ボトムナビの「マイページ」を開きます 2. 「家族メンバー」セクションの「家族を招待」ボタンをタップします 3. 家族メンバーのメールアドレスを入力し、「招待を送信」をタップします 4. 家族メンバーに招待リンク付きのメールが届きます 5. 招待リンクの有効期限は7日間です ### 招待を受け入れる 1. メールに届いた招待リンクを開きます 2. ログインしていない場合は、6桁の認証コードによるメール認証を求められます（メールアドレスは招待先のアドレスが自動入力されます） 3. ログイン後、招待が自動的に受理されます 4. ホーム画面に移動し、すぐに置き配サービスを利用できます ### 家族メンバーを削除する 家族メンバーを削除できるのは世帯主のみです。 1. ボトムナビの「マイページ」を開きます 2. 「家族メンバー」セクションで削除したいメンバーを見つけます 3. 名前の横にある「削除」ボタンをタップします 4. 確認ダイアログで操作を確定します 削除されたメンバーは直ちにアクセスを失います。そのメンバーが登録した配達伝票は部屋用として有効なまま残ります。 ### 世帯主の退去と家族メンバーの退去の違い - **世帯主が退去する場合:** すべての家族メンバーが自動的に部屋から削除されます。登録済みのすべての伝票番号が無効になり、部屋は空室になります。 - **家族メンバーが退去する場合:** そのメンバーのアクセスのみが削除されます。世帯主や他の家族メンバーには影響ありません。 --- ## アプリをホーム画面に追加する（PWAインストール） 本サービスはPWA（Progressive Web App）に対応しており、スマートフォンのホーム画面にアプリとして追加することができます。アプリとしてインストールすると、次回以降はホーム画面のアイコンからすぐに起動できます。 ### Androidの場合 ログイン後にホーム画面への追加を促すバナーが画面下部に表示されます。 1. 「インストール」をタップします 2. ブラウザの確認ダイアログで「インストール」または「追加」をタップします 3. ホーム画面にアプリアイコンが追加されます ### iOSの場合（Safari使用） iOSでは、バナーの「インストール」をタップするとインストール手順が表示されます。 1. Safari下部の共有ボタン（四角から矢印が出たアイコン）をタップします 2. 「ホーム画面に追加」を選択します 3. 右上の「追加」をタップして完了です > iOSでは必ずSafariブラウザをご使用ください。Chrome等の他のブラウザではホーム画面への追加ができない場合があります。 --- ## よくある質問 ### Q: 「施設が見つかりません」と表示されます A: アクセスしたURLに対応する施設が見つからない場合に表示されます。以下をご確認ください。 - QRコードが最新のものかどうか確認する（管理者がスラッグを変更した場合、古いQRコードは無効になります） - URLを直接入力した場合は、スラッグ部分のスペルが正しいか確認する - 管理者に連絡し、正しいQRコードまたはURLを再送してもらう ### Q: 認証コードのメールが届きません A: 以下をご確認ください。 - 迷惑メールフォルダに振り分けられていないか確認する - メールアドレスが正しく入力されているか確認する - しばらく待ってから「再送する」をタップする ### Q: 「この部屋は既に登録されています」と表示されます A: 別の居住者が既に同じ部屋に登録されています。管理者にお問い合わせいただき、前の居住者の退去処理を行ってもらってから再度登録してください。 ### Q: 伝票番号を入力しても「この伝票は登録できません。」と表示されます A: 入力した伝票番号に含まれる数字の桁数が不足しています。置き配サービスでは、PINコードの生成のために伝票番号に十分な桁数の数字が含まれている必要があります。ハイフン等の記号を含む伝票番号の場合、数字部分のみがカウントされます（例: `1234-5678-9012` は数字12桁のため登録可能）。桁数が少ない伝票番号の場合は、運送会社に正式な伝票番号をご確認ください。 ### Q: 配達が完了したのに履歴に表示されません A: 履歴に記録されるのは、配達員が伝票番号で認証（エントランス解錠）を行った時点です。配達員が伝票番号を使用しなかった場合（別のルートで入館した場合など）は記録されないことがあります。管理者にご相談ください。 ### Q: 履歴が「配達完了」のままで「配達確認済み」にならない — 問題ですか？ A: 問題ありません。「配達完了」は配達員がエントランスの解錠に成功したことを意味します。「配達確認済み」は、建物のKEYVOXスマートロックセンサーが配達の完了（配達用ドアの開閉）を自動検知した場合に追加で付与されるステータスです。建物にこのセンサー機能が設定されていない場合は、「配達完了」のままとなります。 ### Q: 履歴に「配達推定」と表示されています。これは何ですか？ A: 「配達推定」は、同日・同施設で別の居住者の伝票番号のPINが使われてエントランスが解錠された際に、この荷物も同時に届いた可能性があることを示します。配達員が複数の荷物を一度に届ける際、1枚の伝票番号のみで入館することがあるため、このステータスが付与されます。 荷物が実際に届いているかご確認ください。後日、配達会社のシステムから正式な配達完了通知が届いた場合は、自動的に「配達確認済み」にアップグレードされます。 ### Q: 履歴に「期限切れ」のエントリーが表示されます A: 「期限切れ」は、登録した伝票番号が配達員に使用されないまま有効期限を過ぎた場合に表示されます。まだ荷物が届いていない場合は、新しい有効期限で伝票番号を再登録してください。 ### Q: ログインが切れた場合はどうすればいいですか？ A: セッションが切れてログイン画面が表示された場合でも、登録情報（部屋・伝票番号・配達履歴）は失われていません。以前ログインしたことのある端末では「おかえりなさい」というメッセージが表示され、メールアドレスが自動入力されています。そのまま「認証コードを送信」をタップし、届いたコードで再ログインしてください。ログイン完了後、ホーム画面に自動で戻ります。 ### Q: アプリを再起動したらログインが切れていました A: 通常、アプリを再起動してもセッションは自動で復元されます。ただし、以下の場合はセッションが保存されないため、毎回ログインが必要になります。 - プライベートブラウジング（シークレットモード）でアプリを開いている - ブラウザのCookieやキャッシュを手動で削除した 通常のブラウザモードでPWAとしてインストールして使用することをお勧めします。セッションが切れた場合も、登録データは消えていません。「おかえりなさい」の表示が出たらメールアドレスを確認して再ログインしてください。 ### Q: 再ログイン後、登録した伝票番号や履歴は消えていませんか？ A: 消えていません。セッション（ログイン状態）と登録データは別々に管理されています。伝票番号、配達履歴、部屋情報などのデータはサーバーに保存されており、セッションが切れても影響を受けません。再ログインすれば、すべてのデータがそのまま表示されます。 ### Q: QRコードを再スキャンしたら登録画面ではなくホーム画面に移動しました A: 正常な動作です。すでに部屋に登録済みの場合、QRコードを再スキャンしても再登録は必要ありません。セッションが有効であれば、自動的にホーム画面に移動します。別の部屋や施設のQRコードをスキャンした場合は、通常の登録フローが表示されます。 ### Q: 引っ越し後も前の部屋のアカウントが残っています A: ご退去の際はマイページの「退去する」ボタンから手続きを行うか、管理者にお申し出ください。管理者が退去処理を行うと、登録済みの伝票番号がすべて無効化され、部屋の登録が解除されます。 ### Q: 有効期限が切れた伝票番号はどうなりますか？ A: 有効期限が過ぎた伝票番号は自動的に無効になり、配達員が使用することができなくなります。必要に応じて、新しい有効期限で再登録してください。 ### Q: 複数の荷物がある場合はどうすればよいですか？ A: 荷物ごとに伝票番号が異なる場合は、それぞれ個別に登録してください。同じ運送会社から複数の荷物が届く場合でも、伝票番号が異なれば個別に登録が必要です。 ### Q: 退去後に同じ部屋に戻ってきた場合、再登録できますか？ A: 退去処理後に同じ部屋へ再登録するには、管理者がその部屋の登録リセットを行う必要があります。管理者にご連絡の上、新しいQRコードまたは登録URLを発行してもらってください。 ### Q: 家族メンバーは何人まで招待できますか？ A: 1部屋あたり最大5名の家族メンバーを招待できます（世帯主を含めて合計6名）。上限に達した場合は、既存のメンバーを削除してから新しいメンバーを招待してください。 ### Q: 招待リンクの有効期限が切れてしまいました A: 招待リンクの有効期限は7日間です。世帯主（招待を送った方）にマイページから再度招待を送ってもらうようお願いしてください。 ### Q: 家族メンバーが他の家族メンバーを招待できますか？ A: いいえ。家族メンバーの招待・削除ができるのは世帯主（最初に部屋を登録した方）のみです。 ### Q: 家族メンバーですが、世帯主が退去するとどうなりますか？ A: 世帯主が退去すると、すべての家族メンバーが自動的に部屋から削除されます。新しい世帯主が部屋を再登録し、あなたを再度招待した場合に改めて登録できます。 ### Q: 家族メンバーに自分の配達伝票が見えますか？ A: はい。同じ部屋の家族メンバーは、お互いの配達伝票・配達履歴・ロッカー割り当てをすべて確認できます。これは世帯全体で荷物の受け取りを調整できるようにするための仕様です。 --- ## 関連ページ - [置き配管理](okihai-manager.md) - 管理者向けの設定・操作方法（部屋管理・QRコード発行・配達履歴確認）