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. お客様への渡し方
1
紙で印刷して手渡し
名前入りクーポンを印刷し、チェックイン時にお渡し。いちばん簡単・確実。
2
予約確認メールに添付
QR画像かURLをメールや確認書に入れて事前に送る。
3
URLをLINE/SMSで案内
お客様はスマホでURLを開けばクーポン画面が出ます。
💡 額面やプラン名が同じでも、QR（コード）は1枚ずつ別物です。コピーや使い回しはできません。
4. 集計の見かた 管理
baiten-coupon.pages.dev/dashboard/ にログインすると、次の数字が確認できます。
発行数 出したクーポンの枚数
利用数 / 利用率 実際に使われた枚数とその割合
超過発生率 額面を超えて買われた割合
超過合計 超過分の合計金額
充当合計 クーポンとして実際に使われた金額
平均購入額 1回あたりの平均お会計
月ごとにまとまって表示され、直近の利用明細も見られます。
4-1. CSVで書き出す（経理・記録用）
ダッシュボードの下のボタンで、数字を Excelで開けるCSV として保存できます（会計事務所に渡す・自分でExcel集計する等）。
📥 月次サマリーをCSV保存 月ごとの発行・利用・超過などの集計表
📥 利用明細をCSV保存 1件ずつの消込記録（日時・お客様・金額）
日本語が文字化けしないように調整済み。Excel／Numbersでそのまま開けます。
5. 大切な決まり
✅ 1人1枚・使い切り。消し込んだクーポンは「利用済み」になり、二度は使えません（同じQRの二重利用は自動で止まります）。
⏰ 有効期限があります。期限を過ぎたクーポンは消し込めません（自動で「期限切れ」になります）。
🔒 スタッフのログイン情報（メール・パスワード）は店外に漏らさないでください。退職などで変わったら、管理者が再設定できます。発行ツールの設定ファイル（秘密キー）も外部に渡さないこと。
6. こんなときは（よくある質問）
Q. カメラが起動しない／真っ暗
A. 初回はカメラの使用許可が必要です。ブラウザの「許可」を押してください。許可しそびれた場合は、ページを再読み込みするともう一度聞かれます。
Q. QRが読み取れない
A. 画面を明るくし、QR全体が枠に入るよう少し離してかざしてください。それでも難しければ「QRが読めない場合（コード手入力）」からコードを入力します。
Q.「利用済みで消込できません」と出た
A. そのクーポンは既に使われています（二重利用防止）。お客様にご確認ください。
Q.「期限切れ」と出た
A. 有効期限を過ぎています。消し込みはできません。
Q. 金額を間違えて消し込んでしまった
A. アプリ上では取り消しできません。管理者に連絡してください（記録の修正が必要です）。
Q. ログインできない
A. メール・パスワードをご確認ください。分からない場合は管理者がパスワードを再設定できます。
Q. お客様がQRを持っていない
A. 予約番号などから発行担当が再発行・確認できます。フロント／管理者へお取り次ぎください。