🏠 トップに戻る
1. このアプリでできること
宿泊プランに付いている売店クーポンを、紙の金券のかわりにQRコードで扱う仕組みです。1人1枚の専用クーポンを発行し、売店での利用時にスタッフがスマホで読み取って消し込みます。利用状況は自動で集計されます。
3つの画面（役割ごとに使い分け）
1
お客様の画面 自動
届いたQRのURLを開くと、額面・期限・QRが表示されます。お客様が見るだけの画面です。
2
スタッフ消込アプリ /staff/
ログインして、お客様のQRを読み取り、購入金額を入れて消し込みます。
3
集計ダッシュボード /dashboard/
発行数・利用率・超過額などを確認します（管理者向け）。
2. 消込のしかた スタッフ
売店でお客様がクーポン（スマホ画面 or 紙のQR）を出したら、次の手順で消し込みます。スマホかタブレットで行います。
1
アプリを開く
スマホで baiten-coupon.pages.dev/staff/ を開きます。よく使うなら「ホーム画面に追加」しておくとアプリのように開けます。
2
ログイン
配布されたメールアドレスとパスワードでログインします。一度ログインすれば、しばらく入れたままになります。
3
QRをスキャン
「QRをスキャン」画面で、お客様のQR（スマホ画面 or 紙）をカメラにかざします。初回はカメラの使用許可を「許可」してください。
4
内容を確認
読み取ると、クーポンの額面・期限・状態が表示されます。状態が「未使用」であることを確認します。
5
購入金額を入力
お客様のお会計の合計金額を入力します。すると「充当額・超過額・残額」が自動で出ます。
6
消込を確定
「消込を確定する」を押すと完了。超過額があればその分だけお客様からお預かりします。
💡 残額は繰り越せません。額面より少ない買い物でも、差額は戻りません（使い切り）。お客様にもその旨をご案内ください。
⚠️ カメラで読めないときは、画面の「QRが読めない場合（コード手入力）」から、QRの下の文字コードを手で入力できます。
🔄 カメラが起動しない／止まったときは、ブラウザでカメラを「許可」したうえで「🔄 再度スキャンする」を押すと、ページを読み込み直さずにカメラを再起動できます。
金額の計算（例で確認）
額面 3,000円 のクーポンで 4,200円 のお買い物をした場合：
お客様からは超過分の 1,200円 だけお預かりします。
3. クーポンの発行・名簿(CSV)・渡し方 発行担当
クーポンは1人1枚、それぞれ別のQRとして発行します。発行のとき、お客様の名前・プラン・額面・期限を入れます。
3-1. いつ発行する？（名前を入れるタイミング）
お客様の情報は「発行の操作をするその時」に入れます。タイミングは運用に合わせて選べます。
名前の出どころは「予約データ（お名前・付帯プラン）」です。
3-2. 名簿（CSV）とは
一括で発行するときに使う「お客様の一覧表」です。ExcelやNumbersの表を、そのまま文字にしたものです（1行＝1人分）。
Excel／Numbers／スプレッドシートで作り「CSV形式で保存」。手書きの表をメモ帳に書いて 名簿.csv でもOK。
💡 CSVを作らなくても大丈夫。発行したいお客様のリスト（名前・額面・期限）を担当者に伝えれば、名前入りクーポンを用意できます。
3-3. 入れた名前はどこに出る？
名前は「画面・印刷カード・台帳」に出ます。QRには入らないので、QRを見られても名前は割れません。
3-4. 発行のやり方（ブラウザで完結・パソコン不要）
baiten-coupon.pages.dev/admin/ を開くだけ。名簿を入れて「発行する」を押せば、QR・名前入りの印刷クーポン・発行台帳までできます。
1
発行画面を開いてログイン
…/admin/ を開き、配布されたメール＋パスワードでログイン。スマホ・PCどちらでもOK。
2
名簿を入れる
名簿（CSV）を貼り付け、または「CSVファイルを選ぶ」。「サンプルを入れる」で書き方の見本も入ります。
3
「発行する」を押す
件数分のクーポンがその場で作られ、一覧が表示されます。
4
印刷／台帳保存
「🖨 印刷用クーポンを開く」で名前入りクーポン（QR付き）を印刷。「📥 発行台帳CSVを保存」で記録も残せます。
💡 これでパソコンのコマンド操作は不要です。ブラウザだけで発行が完結します。
3-5. お客様への渡し方（発行後のボタン） 更新
発行すると「発行できました」の欄が出ます。そこから渡し方を選べます。紙で渡すなら印刷、スマホに送るなら ✉メール・📱SMS・🔗リンク・📷QR画像 が使えます。
「✉メール・📱SMS」は名簿にメール／電話番号の列を入れた行だけ表示されます（メール・電話番号はデータベースに保存しません）。
1
🖨 紙で印刷して手渡し
「印刷用クーポンを開く」で名前入りカード（QR付き）を印刷し、チェックイン時にお渡し。いちばん簡単・確実。
2
✉ メール ／ 📱 SMS で送る
名簿にメール／電話番号を入れておくと、ボタンを押すだけで「宛先＋クーポンのリンク入り」のメール・SMSアプリが開きます。あとは送信を押すだけ。SMSはスマホで確実です。
3
🔗 リンク ／ 📷 QR画像
「リンク」はURLをコピーしてLINE等に貼って送る。「QR画像」はQRを画像で保存してメール添付などに使えます。
💡 額面やプラン名が同じでも、QR（コード）は1枚ずつ別物です。コピーや使い回しはできません。
📵 これは「自動送信」ではありません。名簿にメール／電話番号を入れて「✉メール・📱SMS」を押すと、宛先とクーポンのリンクが入った状態でお使いの端末のメール／SMSアプリが開きます。最後に「送信」ボタンを押して完了です（押し忘れると届きません）。メール・電話番号は送信に使うだけで、データベースには保存しません。
3-6. 発行できる金額・枚数の上限 新
誤操作や不正を防ぐため、発行には上限を設けています。ふだんの売店クーポン（数千円）なら問題なく発行できます。
上限を超えると「額面が上限を超えています」と表示され、発行されません（誤操作・不正の防止）。
⚠️ 1枚 10,000円 を超えるクーポンは発行できません。高額の特典が必要なときは管理者（システム担当）にご相談ください。上限の数値は管理者が変更できます。
4. 集計の見かた 管理
baiten-coupon.pages.dev/dashboard/ にログインすると、次の数字が確認できます。
発行数 出したクーポンの枚数
利用数 / 利用率 実際に使われた枚数とその割合
超過発生率 額面を超えて買われた割合
超過合計 超過分の合計金額
充当合計 クーポンとして実際に使われた金額
平均購入額 1回あたりの平均お会計
月ごとにまとまって表示され、直近の利用明細も見られます。
4-1. CSVで書き出す（経理・記録用）
ダッシュボードの下のボタンで、数字を Excelで開けるCSV として保存できます（会計事務所に渡す・自分でExcel集計する等）。
📥 月次サマリーをCSV保存 月ごとの発行・利用・超過などの集計表
📥 利用明細をCSV保存 1件ずつの消込記録（日時・お客様・金額）
日本語が文字化けしないように調整済み。Excel／Numbersでそのまま開けます。
5. スタッフのアカウント・ログイン 管理 新
消込アプリ・発行アプリは ログインした人だけ が使えます。鍵になるのは「どの携帯か」ではなく「ログインしているか」です。だから新しい携帯でも、ログインさえすればすぐ使えます。
5-1. 守るのは「端末」ではなく「ログイン」
ログインしていない携帯では使えません。逆に、メールとパスワードを知っていればどの携帯からでも使えます＝パスワード管理がいちばん大事です。
5-2. スタッフを追加する（管理者の操作）
人ごとにアカウントを分けると「誰が発行・消込したか」を記録に残せます。メールアドレスは実在しない架空のIDでOKです（例 baiten-tanaka@mikazuki.local）。
Supabase の「Authentication › Users › Add user」で、この4つを入れるだけ。1人あたり30秒ほどです。
1
管理画面を開く
Supabase の Authentication › Users を開きます。（この画面はシステム担当が用意します）
2
「Add user」を押す
右上の「Add user → Create new user」を選びます。
3
メール・パスワードを入れる
メールは架空IDでOK（例 baiten-tanaka@mikazuki.local）。パスワードはメモして本人に渡します。
4
「Auto Confirm User」にチェック → 作成
これで確認メール無しで使えます。「Create user」を押せば1人ぶん完成。人数分くり返します。
💡 メールは架空IDでOK（受信できる本物でなくて大丈夫）。本人にパスワードを自分でリセットさせたい場合だけ、本物のメールにします。
5-3. スタッフの携帯での初期設定（1回だけ）
一度ログインすれば、その携帯は入れたまま。毎回のログインは不要です。
5-4. 「誰がやったか」が記録に残ります
「いつ・誰が・何をしたか」を後から確認できるので、トラブルやミスの追跡に役立ちます。
🔒 退職などでスタッフが変わったら、そのアカウントだけ管理者が止められます（共有アカウントと違い、全員のパスワード変更は不要です）。
6. 大切な決まり
✅ 1人1枚・使い切り。消し込んだクーポンは「利用済み」になり、二度は使えません（同じQRの二重利用は自動で止まります）。
⏰ 有効期限があります。期限を過ぎたクーポンは消し込めません（自動で「期限切れ」になります）。
🔒 スタッフのログイン情報（メール・パスワード）は店外に漏らさないでください。退職などで変わったら、管理者が再設定できます。発行ツールの設定ファイル（秘密キー）も外部に渡さないこと。
7. こんなときは（よくある質問）
Q. カメラが起動しない／真っ暗
A. 初回はカメラの使用許可が必要です。ブラウザの「許可」を押してください。許可しそびれた場合は、ページを再読み込みするともう一度聞かれます。
Q. QRが読み取れない
A. 画面を明るくし、QR全体が枠に入るよう少し離してかざしてください。それでも難しければ「QRが読めない場合（コード手入力）」からコードを入力します。
Q.「利用済みで消込できません」と出た
A. そのクーポンは既に使われています（二重利用防止）。お客様にご確認ください。
Q.「期限切れ」と出た
A. 有効期限を過ぎています。消し込みはできません。
Q. 金額を間違えて消し込んでしまった
A. アプリ上では取り消しできません。管理者に連絡してください（記録の修正が必要です）。
Q. ログインできない
A. メール・パスワードをご確認ください。分からない場合は管理者がパスワードを再設定できます。
Q. お客様がQRを持っていない
A. 予約番号などから発行担当が再発行・確認できます。フロント／管理者へお取り次ぎください。
Q. スタッフを増やしたい／新しい人の携帯で使いたい
A. 管理者がアカウントを1つ追加すれば、その人の携帯でログインして使えます（5章をご覧ください）。端末の登録は不要です。
Q. 10,000円を超えるクーポンを発行したい
A. 安全のため1枚 10,000円 までに制限しています。高額が必要な場合は管理者（システム担当）にご相談ください。上限の数値は変更できます。
Q. 別の携帯からログインされていないか心配
A. メール・パスワードを知っている人だけがログインできます。漏れた疑いがあれば、管理者がそのアカウントのパスワードを変更してください。